載入已存在會話的歷史訊息，以 SSE 流式返回。會話不存在時會通過 SSE 輸出一條 code 為 400 的 JSONRPCResponse.error。Content-Type 為 text/event-stream。適用於恢複會話上下文情境。
介面說明
請求說明
該介面用於恢複指定會話的詳情，並通過 SSE（Server-Sent Events）以流式方式返回 Agent 的響應。
如果目標會話不存在，則會返回一個錯誤幀，錯誤碼為 400。
響應中包含 Agent 處理請求的過程資訊，如訊息分區、思考過程、工具調用狀態更新等。
stopReason欄位指示了 Agent 停止本輪對話的原因，可能值包括但不限於達到最大輪次限制、被取消等。返回的內容符合開源協議 Agent Client Protocol (ACP) 的規範，具體可以參考：https://agentclientprotocol.com
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Jsonrpc |
string |
否 |
JSON-RPC 版本，固定 2.0 |
2.0 |
| Id |
string |
否 |
請求方傳入的 id，原樣回顯 |
4as3dasf654a |
| Params |
object |
否 |
業務參數 |
|
| SessionId |
string |
否 |
目標會話 ID，不存在會返回 SSE error 幀 |
sess_0f12abc34 |
| Meta |
object |
否 |
DataWorks 的 ACP 擴充參數 |
|
| IsReload |
boolean |
否 |
是否是斷點續傳情境，在 SSE 流不穩定的情境下，比如網路不穩定，導致 SSE 中途斷了，可以基於該標誌標識從斷點點位置重新拉取 SSE 返回資料 |
true or false |
| BeginLogOffset |
integer |
否 |
斷點續傳情境下，基於指定的位置拉取 SSE 的後續輸出 |
10000 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
Id of the request |
0D41C608-0C60-5EB0-B986-1460909CF642 |
| Timestamp |
integer |
時間戳記。 |
1769479322828 |
| Jsonrpc |
string |
JSON-RPC 版本，固定 2.0 |
2.0 |
| Id |
string |
請求方傳入的 id，原樣回顯 |
676303114031776 |
| Result |
any |
SSE 的幀結果集，返回的內容符合開源協議 Agent Client Protocol (ACP) 的規範，具體可以參考：https://agentclientprotocol.com/protocol/prompt-turn |
{"stopReason":"end_turn"} |
| Error |
any |
SSE 的幀資訊錯誤提示，返回的內容符合開源協議 Agent Client Protocol (ACP) 的規範，具體可以參考：https://agentclientprotocol.com/protocol/prompt-turn |
{"code": 400, "errorCode": "0x50000000001", "message": "not exist session", "data": null} |
| Method |
string |
SSE 的 method，返回的內容符合開源協議 Agent Client Protocol (ACP) 的規範，具體可以參考：https://agentclientprotocol.com/protocol/prompt-turn |
session/update |
| Params |
any |
SSE 的 params，返回的內容符合開源協議 Agent Client Protocol (ACP) 的規範，具體可以參考：https://agentclientprotocol.com/protocol/prompt-turn |
{"sessionId":"af4f5ef8-e8f5-481c-ad1f-94886c6c0aed","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"hello world"}}} |
樣本
正常返回樣本
JSON格式
{
"RequestId": "0D41C608-0C60-5EB0-B986-1460909CF642",
"Timestamp": 1769479322828,
"Jsonrpc": "2.0",
"Id": "676303114031776",
"Result": "{\"stopReason\":\"end_turn\"}",
"Error": "{\"code\": 400, \"errorCode\": \"0x50000000001\", \"message\": \"not exist session\", \"data\": null}",
"Method": "session/update",
"Params": "{\"sessionId\":\"af4f5ef8-e8f5-481c-ad1f-94886c6c0aed\",\"update\":{\"sessionUpdate\":\"agent_message_chunk\",\"content\":{\"type\":\"text\",\"text\":\"hello world\"}}}"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。