A2A Protocol - Send taskアクション
Send taskアクションは、A2A Protocolで接続済みのA2A Protocolエージェントにメッセージを送信します。 このアクションは新しいタスクIDを返すか、エージェントが終端状態に達してアーティファクトを返すまで待機します。
レシピでエージェントを呼び出す方法は次のとおりです。
- 同期: メッセージを送信し、完了した結果を1つのステップで待機します。
- 非同期: メッセージを送信し、タスクIDをすぐに返して、後でGet task statusアクションで結果を確認します。
- 再開: 新しいメッセージとともにタスクIDを渡すことで、以前に
INPUT_REQUIRED状態を返したタスクを再開します。 タスクの再開の詳細については、タスクの再開を参照してください。
同期モードは短いタスクにのみ使用してください
エージェントが設定済みのタイムアウト内に完了することが予想される場合にのみ、結果を待機しますか?をYesに設定してください。 実行時間の長いタスクでは、非同期モードを使用し、Get task statusアクションで結果を確認します。
A2A Protocolタスクライフサイクルの詳細については、A2A protocol specificationを参照してください。
仕組み
A2A Protocolは、接続済みエージェントのAgent Cardを/.well-known/agent.jsonから取得し、このアクションを使用すると、エージェントが宣言したスキルをMessageフィールドのヒントテキストに一覧表示します。 A2A Protocol仕様では、特定のスキルにメッセージをルーティングできません。 エージェントは、メッセージコンテンツから適切なスキルを選択します。 レシピの実行時に、アクションはJSON-RPC message/sendリクエストをエージェントに送信します。
入力
| 入力フィールド | 説明 |
|---|---|
| 結果を待機しますか? | 必須。 エージェントがタスクを受け付けるとすぐにタスクオブジェクトを返すには、No – return task ID immediatelyを選択します。 エージェントが終了するまで待機して完了したタスクを返すには、Yes – block until completeを選択します。 アクションは、エージェントのAgent Cardでcapabilities.pushNotifications: trueが宣言されているかどうかを確認します。 アクションはタスクの完了を1分ごとにポーリングします。 タスクが終端状態に達すると、アクションは結果を返します。 |
| メッセージ | 必須。 エージェントに送信するテキストプロンプトを入力します。 ヒントには、接続済みエージェントが宣言したスキルが一覧表示されます。 WorkatoがAgent Cardにアクセスできない場合は、汎用ヒントが表示されます。 |
| タスクID（再開のみ） | 任意です。 INPUT_REQUIREDを返した以前のタスクを続行するには、既存のタスクのIDを入力します。 エージェントは、メッセージを既存のタスクの続きとして扱います。 新しいタスクを開始するには、このフィールドを空のままにします。 |
| タイムアウト（秒） | 任意です。 アクションがタスクの終端状態への到達を待機する最大秒数。 デフォルトは300です。 最小値は60秒です。 結果を待機しますか?がYesに設定されている場合にのみ表示されます。 リクエストがタイムアウトを超えると、アクションはエラーで失敗します。 |
| プッシュ通知Webhook URL | Webhook URLのプッシュ通知を有効にするかどうかを選択します。 結果を待機しますか?がYesで、接続済みエージェントのAgent CardにpushNotifications: trueが含まれている場合にのみ表示されます。 |
出力
アクションは、エージェントから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です。 |
| メッセージ履歴 | タスクで交換されたメッセージの配列。 エージェントがメッセージ履歴を返すと入力されます。 |
Last updated: