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"}}

data: {"type":"message","data":"你好"}

data: {"type":"event","event":"on_conversation_end","data":{"id":"conversation-id","status":"idle","error":null}}

data: {"type":"event","event":"on_conversation_start","data":{"id":"conversation-id"}}

data: {"type":"message","data":"你好"}

data: {"type":"event","event":"on_conversation_end","data":{"id":"conversation-id","status":"idle","error":null}}

AI/v1

调用智能体

deprecated

这份历史 OpenAPI 参考文档已不再维护，内容可能不符合当前服务器行为。新接入请使用官方 XpertAI SDK（@xpert-ai/xpert-sdk）：[SDK 接入指南](/zh-hans/ai/agent/development-api)。向已发布的智能体发送消息，通过 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

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"}}

data: {"type":"message","data":"你好"}

data: {"type":"event","event":"on_conversation_end","data":{"id":"conversation-id","status":"idle","error":null}}

data: {"type":"event","event":"on_conversation_start","data":{"id":"conversation-id"}}

data: {"type":"message","data":"你好"}

data: {"type":"event","event":"on_conversation_end","data":{"id":"conversation-id","status":"idle","error":null}}

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

request

object

必填

Option 1
Option 2
Option 3
Option 4

Show child attributes

options

object

公开的调用选项。租户、组织、用户和调用来源由服务端解析；不要在此提交鉴权凭据或内部运行时对象。

Show child attributes

响应

SSE 事件流。若连接关闭前未收到 on_conversation_end，则本次回复不完整。解析 JSON 前忽略心跳注释，以及去除首尾空白后内容为 : keep-alive 的 data 帧。按需处理其他生命周期事件。

The response is of type string.