curl --request POST \
--url https://api.example.com/api/ai/v1/chat \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"request": {
"action": "send",
"message": {
"input": {
"input": "你好，请简单介绍一下自己。"
}
}
},
"options": {
"xpertId": "YOUR_PUBLISHED_XPERT_ID"
}
}
'"data: {\"type\":\"event\",\"event\":\"on_conversation_start\",\"data\":{\"id\":\"conversation-id\"}}\n\ndata: {\"type\":\"message\",\"data\":\"你好\"}\n\ndata: {\"type\":\"event\",\"event\":\"on_conversation_end\",\"data\":{\"id\":\"conversation-id\",\"status\":\"idle\",\"error\":null}}\n\n""data: {\"type\":\"event\",\"event\":\"on_conversation_start\",\"data\":{\"id\":\"conversation-id\"}}\n\ndata: {\"type\":\"message\",\"data\":\"你好\"}\n\ndata: {\"type\":\"event\",\"event\":\"on_conversation_end\",\"data\":{\"id\":\"conversation-id\",\"status\":\"idle\",\"error\":null}}\n\n"AI/v1
调用智能体
向已发布的智能体发送消息，通过 SSE 接收流式回复。使用 Authorization: Bearer <API_KEY> 或 x-api-key 鉴权。保存 on_conversation_start.data.id，并在后续请求中通过 conversationId 延续对话。每个 SSE data 字段包含 JSON，字段为 type、可选的 event 和 data。文本增量的 type 为 message，生命周期事件的 type 为 event。请检查 on_conversation_end.data.status、error 以及 SSE 错误事件：HTTP 请求成功不代表智能体执行成功。内部运行时选项不属于公开请求参数。
POST
/
api
/
ai
/
v1
/
chat
curl --request POST \
--url https://api.example.com/api/ai/v1/chat \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"request": {
"action": "send",
"message": {
"input": {
"input": "你好，请简单介绍一下自己。"
}
}
},
"options": {
"xpertId": "YOUR_PUBLISHED_XPERT_ID"
}
}
'"data: {\"type\":\"event\",\"event\":\"on_conversation_start\",\"data\":{\"id\":\"conversation-id\"}}\n\ndata: {\"type\":\"message\",\"data\":\"你好\"}\n\ndata: {\"type\":\"event\",\"event\":\"on_conversation_end\",\"data\":{\"id\":\"conversation-id\",\"status\":\"idle\",\"error\":null}}\n\n""data: {\"type\":\"event\",\"event\":\"on_conversation_start\",\"data\":{\"id\":\"conversation-id\"}}\n\ndata: {\"type\":\"message\",\"data\":\"你好\"}\n\ndata: {\"type\":\"event\",\"event\":\"on_conversation_end\",\"data\":{\"id\":\"conversation-id\",\"status\":\"idle\",\"error\":null}}\n\n"授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
响应
SSE 事件流。若连接关闭前未收到 on_conversation_end，则本次回复不完整。解析 JSON 前忽略心跳注释，以及去除首尾空白后内容为 : keep-alive 的 data 帧。按需处理其他生命周期事件。
The response is of type string.