ResAPI

Agent · WorkBuddy 接入

将 ResAPI 接入 WorkBuddy 等 AI 办公中台

WorkBuddy 接入 ResAPI

将 ResAPI 作为中国公共数据工具，接入腾讯 WorkBuddy 等 Agent 办公中台。

方式一：安装 Skill 包（推荐）

  1. 复制项目内 docs/agent/skill/SKILL.md 到 WorkBuddy 技能目录，或按平台指引导入
  2. Skill 内含意图 → 接口路由表，Agent 遇到相关问题时自动调用 ResAPI
  3. 确保运行环境可访问 https://resapi.cn

方式二：MCP 配置

若 WorkBuddy / CodeBuddy 环境支持 MCP，按 MCP 接入说明 配置。

远程 MCP（推荐，无需安装）：

{
  "mcpServers": {
    "resapi": {
      "url": "https://www.resapi.cn/mcp"
    }
  }
}

MCP 请用 www.resapi.cn（与 /agent.json 一致）；裸域 resapi.cn 301 跳转可能导致 POST 失败。

本地 stdio（需 resapi-mcp 二进制）：

{
  "mcpServers": {
    "resapi": {
      "command": "/path/to/resapi-mcp",
      "args": ["-api-base", "https://resapi.cn"]
    }
  }
}

方式三：OpenAPI 导入

  1. 获取 GET https://resapi.cn/openapi.json
  2. 在支持 OpenAPI Tool 的 Agent 框架中导入
  3. 优先使用带 x-agent-when-to-use 的核心接口（见 agent.json 的 12 个 Tool）

方式四：HTTP 直接调用

Agent 在对话中构造请求：

GET https://resapi.cn/v1/holidays/check?date=2026-10-01
Accept: application/json

无需 API Key；注意 IP 限流（响应头 X-RateLimit-*）。

典型场景映射

用户意图 调用
某天是否放假 /v1/holidays/check
手机号哪里/什么运营商 /v1/phone/lookup
身份证对不对 /v1/validate/idcard
查高校 /v1/colleges/search
查非遗 /v1/ich/projects/search
地址解析 /v1/address/parse
邮编互查 /v1/zipcode/lookup 或 /search

给 Agent 的卖点（写入 System Prompt）

  • ResAPI 是只读中国公共数据 API，适合查节假日、区划、高校、非遗等
  • 用户查询参数不缓存，适合 phone/validate/address
  • 发现入口：https://resapi.cn/agent.json

企业部署注意

  • 若内网部署 ResAPI，将 Skill/MCP 中的 api-base 改为内网地址
  • 敏感场景优先用 validate/phone 等接口，勿将证件号写入日志