Invoke an Agent

Send a message to a remote Agent2Agent (A2A) agent from a Maestro agentic process and use the agent's response in later process steps.

説明

This activity sends a message to a remote A2A agent and returns the agent's response, so the agent can take part in a process orchestrated by Maestro.

The agent answers in one of two ways:

• Immediate reply: the agent returns a message, and the task completes with that message.
• Long-running task: the agent returns a task. Integration Service polls the agent for the task status, and the task completes when the agent task reaches a final state. For details, refer to Agent 2 Agent events.

前提条件

• An Agent 2 Agent connection to the agent you want to call. For details, refer to Agent 2 Agent authentication.
• The agent meets the remote agent requirements.

Maestro プロセスにアクティビティを追加する

1. キャンバスにサービス タスク要素を追加し、タスクの [ プロパティ ] パネルを開きます。
2. [ 実装 ] セクションの [ アクション ] ドロップダウン リストから、[ 外部エージェントを起動し、待機] を選択します。
3. Select the Agent 2 Agent connector.
4. 既存のコネクションを選択するか、新しいコネクションを作成します。
5. From Activity, select Invoke an Agent.
6. From Agent Skills, select the skill to use.
7. In Message content, enter the message to send to the agent.

At runtime, Maestro sends the message to the agent and waits for the response before moving to the next step.

構成

フィールド	方向	説明
コネクション	入力	Integration Service で確立されたコネクション。ドロップダウン メニューからコネクションを選択、追加、または管理します。
Agent Skills	入力	Required. A skill from the Agent Card of the agent. Selecting a skill shows its description, examples, and parameters, to help you write the message.
メッセージの内容	入力	必須。エージェントに送信されるメッセージのテキストです。
ロール	入力	Optional. The role of the message sender, for example user.
Context identifier	Input and output	Optional. The ID of an existing conversation context. Enter the Context identifier output of an earlier Invoke an Agent task to continue that conversation.
Blocking (ブロック)	入力	Optional. Whether to ask the agent for a synchronous reply instead of a long-running task.
Accepted output modes	入力	Optional. The response formats you accept, for example text.
History length	入力	Optional. The number of previous messages to include in the context.
メタデータ	Input and output	Optional. Key-value pairs for additional context or tracking information.
Current status state	出力	The final state of the agent task, for a long-running task.
Status error	出力	Error information, if the agent task failed.
成果物	出力	The results produced by the agent task. Each artifact has an identifier, a name, and parts. The Artifact part text field holds the text of each part.
履歴	出力	The messages exchanged in the task, with their role and text.

プロセスでエージェントの応答を使用する

エージェントの応答がプロセスに影響を与えるには (たとえばゲートウェイで意思決定を行うには)、エージェントの応答をプロセス変数に割り当てます。

1. デザイン モードで、キャンバス上でサービス タスクを選択します。
2. [プロパティ] を選択します。
3. [ 出力] で [ 新規追加] を選択します。
4. String 型の変数を追加します (例: agent_response)。
5. For Value, select the field that holds the agent's answer from the task's response. For a long-running task, this is usually the Artifact part text field.

ヒント:

When a later step needs structured data, ask the agent to respond only with a JSON object, then parse the response in Maestro.