KefuAgents 文档Agent Gateway
Agent Gateway 总览
带上你自己的 Agent（BYOB）：一个 MCP 端点 + 一把 key，接入 KefuAgents 的受监督客服循环。
你带 Agent，我们守门
KefuAgents Agent Gateway 是 BYOB（Bring Your Own Bot）接入面：平台提供上下文 （线程、订单、知识、禁承诺清单），你的 agent 用自己的模型推理，平台安全门复检每一份 草稿。读取与提交草稿不消耗平台 AI 积分。
监督循环：
get_pending_cards— 看有哪些待办决策卡；get_reply_context— 拿单个线程的完整回复上下文（含contextVersion与constraints禁承诺清单）；- 用你自己的模型起草 →
submit_draft— 平台安全门复检，通过后成为待人工审核的 草稿（绝不自动发送），被拒返回violations明细； - 高风险（退款/补发/投诉/拒付/安全）永远由人决定 — agent 的正确动作是
create_review_request或提醒商家。
端点与认证
| 用途 | 地址 |
|---|---|
| MCP 端点（Streamable HTTP） | https://kefuagents.com/api/gateway/mcp |
| REST 基地址 | https://kefuagents.com/api/gateway/v1 |
| OpenAPI 描述下载 | https://kefuagents.com/gateway/openapi.json |
- 认证只有一种：
Authorization: Bearer <Gateway Key>。Key 在 KefuAgents 设置面板 创建，只显示一次；一把 key 只绑定一个 workspace（品牌）。 - MCP 工具名与 OpenAPI
operationId一一对应，共 17 个工具。 - 协议版本 2026-07-28。旧版本客户端照常可用：服务端同时应答
server/discover与旧的initialize握手，此前配置好的 agent 无需改动。 - 每次请求独立鉴权（无会话状态）；key 吊销即刻生效。
Scope 一览
| Scope | 给什么 | 默认 |
|---|---|---|
gateway:read | 5 个读工具 + webhook 管理 | ✅ 开 |
gateway:submit_draft | 提交草稿 + 4 个非 approve 写工具 | ✅ 开 |
gateway:approve | 批准/拒绝待审回复 | ❌ 关，需商家显式开启 |
平台保证（结构性，不依赖 agent 是否听话）
- 平台复检每一份草稿；违规草稿被拒收并返回 violations。
- 高风险决策永远由人做出——没有任何 scope 组合可以绕过
（
HIGH_RISK_REQUIRES_HUMAN）。 - 一把 key 只能访问一个 workspace。
- 所有调用（包括被拒绝的）都有审计记录，设置面板可查每把 key 的最近调用。