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-HK/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
  }
}

錯誤碼

參見錯誤碼文檔。