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タスクの現在の状態。 タイムスタンプ、ステータスメッセージ、およびSUBMITTEDWORKINGINPUT_REQUIREDCOMPLETEDFAILEDCANCELEDなどのステータス状態を含みます。
アーティファクトエージェントによって生成されたアーティファクトの配列。 タスクがCOMPLETEDに達すると入力されます。 各アーティファクトにはpartsの配列が含まれ、各partのkindtextfile、またはdataです。
メッセージ履歴タスクで交換されたメッセージの配列。 Include message history?が選択されている場合にのみ入力されます。

Last updated: