A2A Protocol - タスクステータスの取得アクション
Get task statusアクションは、A2A Protocolで接続済みエージェントに送信されたタスクの現在の状態と利用可能なアーティファクトを取得します。 このアクションを使用して、非同期で送信されたタスクを確認したり、任意のタスクの結果を検査したりします。
このアクションは、特定時点の読み取りを1回実行します。 タスクが終了状態に達するまでポーリングしたり待機したりしません。 1つのレシピステップでタスクの完了を待機するには、Wait for result?をYesに設定したSend taskアクションを使用します。
A2A Protocolタスクライフサイクルの詳細については、A2A Protocol仕様を参照してください。
仕組み
レシピが実行され、アクションは指定されたタスクIDとともに単一のJSON-RPCtasks/getリクエストを接続済みエージェントに送信し、現在のタスクオブジェクトを返します。
Include message history?が選択されている場合、アクションはタスクの履歴から最大50件のメッセージをリクエストします。 Include message history?を選択しない場合、アクションは履歴をリクエストしません。
入力
| 入力フィールド | 説明 |
|---|---|
| タスクID | 必須。 取得するタスクのIDを入力します。 これは、以前のSend taskアクションによって返されたid値です。 |
| メッセージ履歴を含める? | 任意です。 選択すると、タスクで交換された最大50件のメッセージが含まれます。 選択を解除すると、レスポンスからメッセージ履歴が省略されます。 デフォルトでは未選択です。 |
出力
アクションは、エージェントからJSON-RPCresultオブジェクトを返します。 構造は、A2A Protocol仕様で定義されているA2A ProtocolのTaskオブジェクトと一致します。
| 出力フィールド | 説明 |
|---|---|
| タスクID | タスクの一意の識別子。 |
| 種類 | ステータスを取得するオブジェクトのタイプ。 通常はtaskです。 |
| コンテキストID | エージェントによって割り当てられた会話コンテキスト識別子。 |
| Status | タスクの現在の状態。 タイムスタンプ、ステータスメッセージ、およびSUBMITTED、WORKING、INPUT_REQUIRED、COMPLETED、FAILED、CANCELEDなどのステータス状態を含みます。 |
| アーティファクト | エージェントによって生成されたアーティファクトの配列。 タスクがCOMPLETEDに達すると入力されます。 各アーティファクトにはpartsの配列が含まれ、各partのkindはtext、file、またはdataです。 |
| メッセージ履歴 | タスクで交換されたメッセージの配列。 Include message history?が選択されている場合にのみ入力されます。 |
Last updated: