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.

Descripción

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.

Requisitos previos

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

Añadir la actividad a un proceso de Maestro

1. Añade un elemento de tarea de servicio al lienzo y abre el panel Propiedades de la tarea.
2. En la sección Implementación , en la lista desplegable Acción , selecciona Iniciar y esperar al agente externo.
3. Select the Agent 2 Agent connector.
4. Seleccione una conexión existente o cree una nueva.
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.

Configuración

Campo	Dirección	Descripción
Conexión	Entrada	La conexión establecida en Integration Service. Accede al menú desplegable para elegir, añadir o gestionar conexiones.
Agent Skills	Entrada	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.
Contenido del mensaje	Entrada	Obligatorio. El texto del mensaje enviado al agente.
Rol	Entrada	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.
Bloqueo	Entrada	Optional. Whether to ask the agent for a synchronous reply instead of a long-running task.
Accepted output modes	Entrada	Optional. The response formats you accept, for example text.
History length	Entrada	Optional. The number of previous messages to include in the context.
Metadatos	Input and output	Optional. Key-value pairs for additional context or tracking information.
Current status state	Salida	The final state of the agent task, for a long-running task.
Status error	Salida	Error information, if the agent task failed.
Artefactos	Salida	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.
Historial	Salida	The messages exchanged in the task, with their role and text.

Utilizar la respuesta del agente en el proceso

Para permitir que la respuesta del agente influya en el proceso, por ejemplo, para tomar una decisión en una puerta de enlace, asígnala a una variable de proceso.

1. En el modo Diseño, selecciona la tarea de servicio en el lienzo.
2. Selecciona Propiedades.
3. En Salida, selecciona Añadir nuevo.
4. Añade una variable de tipo String, por ejemplo 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.

Consejo:

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