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.

Beschreibung

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.

Voraussetzungen

• 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.

Hinzufügen der Aktivität zu einem Maestro-Prozess

1. Fügen Sie ein Dienstaufgabenelement zur Arbeitsfläche hinzu und öffnen Sie den Eigenschaftenbereich der Aufgabe.
2. Wählen Sie im Abschnitt Implementierung in der Dropdownliste Aktion die Option Starten und auf einen externen Agent warten.
3. Select the Agent 2 Agent connector.
4. Wählen Sie eine vorhandene Verbindung aus oder erstellen Sie eine neue.
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.

Konfiguration

Feld	Richtung	Beschreibung
Verbindung (Connection)	Eingabe	Die in Integration Service hergestellte Verbindung. Greifen Sie auf das Dropdownmenü zu, um Verbindungen auszuwählen, hinzuzufügen oder zu verwalten.
Agent Skills	Eingabe	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.
Nachrichteninhalt	Eingabe	Erforderlich. Der Text der Nachricht, die an den Agent gesendet wurde.
Rolle	Eingabe	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.
Blockieren	Eingabe	Optional. Whether to ask the agent for a synchronous reply instead of a long-running task.
Accepted output modes	Eingabe	Optional. The response formats you accept, for example text.
History length	Eingabe	Optional. The number of previous messages to include in the context.
Metadata	Input and output	Optional. Key-value pairs for additional context or tracking information.
Current status state	Ausgabe	The final state of the agent task, for a long-running task.
Status error	Ausgabe	Error information, if the agent task failed.
Artefakte	Ausgabe	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.
Verlauf	Ausgabe	The messages exchanged in the task, with their role and text.

Verwenden der Antwort des Agenten im Prozess

Damit die Antwort des Agents den Prozess beeinflusst, z. B. um eine Entscheidung an einem Gateway zu treffen, weisen Sie sie einer Prozessvariablen zu.

1. Wählen Sie im Designmodus die Serviceaufgabe auf der Arbeitsfläche aus.
2. Wählen Sie Eigenschaften aus.
3. Wählen Sie unter Ausgabe die Option Neue hinzufügen aus.
4. Fügen Sie eine Variable vom Typ String hinzu, z. B. 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.

Tipp:

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