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=。 |
當 發起對話 返回 status = interrupted 時,Agent 正等待你補充信息。通過本接口回傳答案,暫停的運行會從中斷處繼續執行,直到成功、再次中斷或失敗。
同一輪對話可能發生多次中斷:若繼續後再次返回 interrupted,按新的 interrupt 重複調用本接口即可。
與發起對話一致,通過請求頭 Accept 選擇阻塞式 / SSE 流式響應。
請求
路徑參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
agent_id | string | 必填 | Agent UID. |
chat_uid | string | 必填 | 被中斷會話的 UID。 |
message_id | string | 必填 | 要繼續的被中斷消息 ID。 |
請求體
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
answers_by_tool_call | object | 必填 | 按工具調用 ID 組織的回答,提供 Agent 所需信息以恢復被中斷的運行。 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
chat_uid | string | 必填 | 會話 UID。 |
message_id | string | 必填 | 消息 ID。 |
status | string | 必填 | 運行狀態,如 `succeeded`、`interrupted`。 |
answer | string | 可選 | Agent 的回答文本。 |
references | array | 可選 | 回答引用的參考來源。 |
elapsed_time | number | 可選 | 運行耗時(秒)。 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"chat_uid": "ct_9f2c1a5b",
"message_id": "43",
"status": "succeeded",
"answer": "Over the past month, Tesla (TSLA.US)...",
"references": [],
"elapsed_time": 2.74
}
}錯誤碼
參見錯誤碼文檔。