接入文档（API）

认证

使用企业管理员在管理端签发的机器凭证（OIDC client credentials）。所有请求走 HTTPS，凭证不要放在前端。

客服接口

POST /api/v1/service/turns
Authorization: Bearer <token>

{
  "session_id": "cs_8f2a…",
  "channel": "web",
  "customer_ref": "crm:10293",
  "text": "最厚的鞋底是哪款"
}

→ 200
{
  "reply": "最厚的是云朵款，鞋底 4.2cm……38 码有货，现在下单今天发。",
  "state": "AI_CONTINUE",
  "evidence": [{ "source": "产品表.xlsx", "version": "v3" }],
  "handoff": null
}

转人工

当 state 为 HANDOFF_REQUIRED 时，响应里会带 handoff 包：客户原话、已确认的事实、依据、已做的动作。把它交给你的坐席系统即可。人工未确认接单前，会话不会被标成已解决。

限制

• 每个企业默认 60 次／分钟，可申请提高。
• 接口只读企业已生效的知识，不会返回原始文件。
• 每次调用都有审计记录，可在管理端导出。