AI Agent
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
向指定 Agent 提问。可以开启一个全新会话,也可以传入已有会话的 chat_uid 在同一会话中追加提问。
Agent 会结合行情、账户等能力生成回答。当 Agent 需要你补充信息或确认时,本次运行会中断(status 为 interrupted),此时需通过 继续对话 回传答案后才能继续。
通过请求头 Accept 选择响应模式:text/event-stream 为 SSE 流式,逐步推送运行过程与回答;其他值为阻塞式,一次性返回聚合后的最终结果。
如何获取 Agent 的 UID
除通过 Workspace 下的 Agent 接口查询外,也可以直接从 Longbridge 网页端获取:打开 Agent 的对话页,URL 形如 https://longbridge.com/zh-CN/ai/agents/chatbot/chat,其中 chatbot 即为该 Agent 的 UID。
请求
路径参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
agent_id | string | 必填 | 目标 Agent 的 UID,需为已发布 Agent |
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 必填 | 用户问题,不能为空 |
chat_uid | string | 可选 | 已有会话标识。传入则在该会话中继续提问,不传则新建会话 |
parent_message_id | string | 可选 | 父消息 ID,取上一轮响应中的 `message_id`。在已有会话中追加提问时传入,将本轮消息挂在指定消息之后,保证消息流顺序。仅在传入 `chat_uid` 时有效,且父消息必须属于该会话;新会话不可传 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
chat_uid | string | 必填 | 会话标识,追加提问或排查问题时使用 |
message_id | string | 必填 | 本轮消息 ID(字符串形式) |
status | string | 必填 | 运行终态:`succeeded` / `interrupted` / `failed` / `stopped` |
answer | string | 可选 | 最终回答文本,`status` 为 `succeeded` 时有效 |
references | object[] | 可选 | 回答引用的资料来源,无引用时为 `null` |
elapsed_time | number | 可选 | 运行耗时(秒) |
interrupt | object | 可选 | 仅当 `status` 为 `interrupted` 时出现 |
└ node_id | string | 必填 | 触发中断的节点 ID |
└ tool_call_id | string | 必填 | 本次询问对应的工具调用 ID,继续对话时作为答案的 key |
└ questions | object[] | 必填 | 需要你回答的问题列表 |
└ ∟ question | string | 必填 | 问题文本 |
└ ∟ options | object[] | 可选 | 可选项,为空表示自由作答 |
└ ∟∟ description | string | 可选 | 选项文本 |
└ ∟ multi_select | boolean | 可选 | 是否允许多选 |
└ message_id | int64 | 可选 | 被暂停的消息 ID |
└ chat_id | int64 | 可选 | 所属会话 ID |
error | object | 可选 | 仅当运行出错时出现 |
└ code | int32 | 可选 | 错误码 |
└ message | string | 可选 | 错误信息 |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"chat_uid": "ct_9f2c1a5b",
"message_id": "42",
"status": "succeeded",
"answer": "Tesla (TSLA.US) recently...",
"references": [
{
"index": 1,
"title": "...",
"url": "..."
}
],
"elapsed_time": 3.21
}
}错误码
参见错误码文档。