Chat API

用代码驱动对话——同步或流式，每次回复都附带检索出处。

一轮对话是怎么处理的

每一条消息——不管来自挂件、API 还是即时通讯渠道——都走同一条流水线。先过认证以及成员资格/配额两道闸，然后由检索为答案提供依据，接着跑工具循环，最后本轮对话以字段加密的方式落库，同时在后台完成记忆写入和跨渠道分发。

同步对话

curl https://chat.agent4.io/chat \
  -H "X-API-Key: tk_live_…" \
  -H "X-End-User: lead-1024" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I need a bridge loan for 3 months",
    "session_id": null,
    "agent": null
  }'

请求字段

字段	类型	说明
`message`	string	用户发来的消息。
`session_id`	string \| null	不传表示开启新会话；传入返回的 id 则继续该会话。
`agent`	string \| null	智能体名称；不传则使用租户默认智能体。
`k`	number \| null	覆盖本次检索的知识块数量。
`images`	string[] \| null	本轮的 Data-URL（base64）图片，用于多模态。
`audio`	string \| null	Data-URL 音频；由服务端转写后作为消息内容使用。

响应

{
  "session_id": "6f1e…",
  "reply": "For a 3-month bridge loan our current terms are…",
  "sources": [
    { "document_id": "a3b4…", "distance": 0.18 }
  ],
  "transcript": null
}

sources 列出了本次答案所依据的知识库文档，可用来渲染引用。当你传了 audio 时，transcript 才有值。

流式

POST /chat/stream 接受相同的请求体，返回 server-sent events，让你可以边收边渲染：

curl -N https://chat.agent4.io/chat/stream \
  -H "X-API-Key: tk_live_…" \
  -H "X-End-User: lead-1024" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Compare your 3 and 6 month terms" }'

语言

回复语言跟随对话本身。发送 Accept-Language 请求头可以指定系统消息和跟进邮件的语言；平台的七种语言是 en、zh、zh-TW、es、ru。

完整的接口清单——会话、文档、空间、用量——由实时 OpenAPI schema 渲染在控制台的 API 文档页面中。

认证

空间与知识库