既存のセッションのメッセージ履歴をロードし、SSE ストリームとして返します。セッションが存在しない場合、サーバーは SSE ストリームを通じてコード 400 の JSONRPCResponse.error を送信します。Content-Type は text/event-stream です。この操作を使用して、セッションコンテキストを復元します。
操作説明
リクエスト
この操作は、セッションの詳細を取得し、Server-Sent Events (SSE) を使用してエージェントの応答をストリーミングします。
対象のセッションが存在しない場合、この操作はエラーコード 400 を含むエラーフレームを返します。
応答には、メッセージチャンク、思考プロセス、ツール呼び出しステータスの更新など、エージェントのリクエスト処理に関する情報が含まれます。
stopReasonフィールドは、エージェントが現在のターンを停止する理由を示します。考えられる値には、最大ターン数に達した場合やキャンセルされた場合などが含まれます。返されるコンテンツは Agent Client Protocol (ACP) に準拠しています。詳細については、「https://agentclientprotocol.com」をご参照ください。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Jsonrpc |
string |
任意 |
JSON-RPC のバージョンです。値は |
2.0 |
| Id |
string |
任意 |
クライアントが生成したリクエスト ID で、応答に含まれて返されます。 |
4as3dasf654a |
| Params |
object |
任意 |
ビジネスパラメーターです。 |
|
| SessionId |
string |
任意 |
対象セッションの ID です。セッションが存在しない場合、SSE エラーフレームが返されます。 |
sess_0f12abc34 |
| Meta |
object |
任意 |
ACP 向けの DataWorks 固有の拡張パラメーターです。 |
|
| IsReload |
boolean |
任意 |
再開可能な転送を使用するかどうかを指定します。ネットワーク接続の不安定などの問題により SSE ストリームが中断された場合、このパラメーターを |
true or false |
| BeginLogOffset |
integer |
任意 |
再開可能な転送のシナリオでは、SSE 出力のフェッチを再開するオフセットを指定します。 |
10000 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
このリクエストに対して生成された一意のリクエスト ID です。 |
0D41C608-0C60-5EB0-B986-1460909CF642 |
| Timestamp |
integer |
タイムスタンプです。 |
1769479322828 |
| Jsonrpc |
string |
JSON-RPC のバージョンです。値は |
2.0 |
| Id |
string |
リクエストから返された、クライアントが生成したリクエスト ID です。 |
676303114031776 |
| Result |
any |
SSE フレームの結果オブジェクトです。このフィールドは、操作が成功した場合に存在します。 |
{"stopReason":"end_turn"} |
| Error |
any |
SSE フレームのエラーオブジェクトです。このフィールドは、エラーが発生した場合に存在します。 |
{"code": 400, "errorCode": "0x50000000001", "message": "not exist session", "data": null} |
| Method |
string |
SSE フレームのメソッドです。 |
session/update |
| Params |
any |
SSE フレームのパラメーターです。 |
{"sessionId":"af4f5ef8-e8f5-481c-ad1f-94886c6c0aed","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"hello world"}}} |
例
成功レスポンス
JSONJSON
{
"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\"}}}"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。