AI Agent

发起对话

POSThttps://openapi.longbridge.com/v1/ai/agents/{agent_id}/conversations

鉴权

签名方式:每个请求用 App Key / Secret 签名。请求头如下:

名称类型必填说明
Authorizationstring · header必填OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。
X-Api-Keystring · header必填你的 App Key。
X-Timestampstring · header必填请求时间戳,单位秒(Unix 时间)。
X-Api-Signaturestring · 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_idstring必填目标 Agent 的 UID,需为已发布 Agent

请求体

名称类型必填说明
querystring必填用户问题,不能为空
chat_uidstring可选已有会话标识。传入则在该会话中继续提问,不传则新建会话
parent_message_idstring可选父消息 ID,取上一轮响应中的 `message_id`。在已有会话中追加提问时传入,将本轮消息挂在指定消息之后,保证消息流顺序。仅在传入 `chat_uid` 时有效,且父消息必须属于该会话;新会话不可传

响应

响应字段

名称类型必填说明
chat_uidstring必填会话标识,追加提问或排查问题时使用
message_idstring必填本轮消息 ID(字符串形式)
statusstring必填运行终态:`succeeded` / `interrupted` / `failed` / `stopped`
answerstring可选最终回答文本,`status` 为 `succeeded` 时有效
referencesobject[]可选回答引用的资料来源,无引用时为 `null`
elapsed_timenumber可选运行耗时(秒)
interruptobject可选仅当 `status` 为 `interrupted` 时出现
└ node_idstring必填触发中断的节点 ID
└ tool_call_idstring必填本次询问对应的工具调用 ID,继续对话时作为答案的 key
└ questionsobject[]必填需要你回答的问题列表
└ ∟ questionstring必填问题文本
└ ∟ optionsobject[]可选可选项,为空表示自由作答
└ ∟∟ descriptionstring可选选项文本
└ ∟ multi_selectboolean可选是否允许多选
└ message_idint64可选被暂停的消息 ID
└ chat_idint64可选所属会话 ID
errorobject可选仅当运行出错时出现
└ codeint32可选错误码
└ messagestring可选错误信息

响应 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
  }
}

错误码

参见错误码文档。