Configuración de propiedades del agente

En Maestro, los agentes se tratan como participantes en un proceso empresarial. Dentro de un flujo de trabajo BPMN, los agentes se representan mediante tareas de servicio, que pueden invocar tanto agentes alojados en UiPath como agentes externos. Cada tarea de agente puede configurarse con parámetros de entrada y salida específicos, que permiten a Maestro pasar datos sensibles al contexto al agente y recibir resultados estructurados a cambio.

Consulta Tareas en el modelado BPMN para obtener una descripción general de las tareas de servicio en Maestro.

Modos de ejecución de agente

El comportamiento del agente se define en el panel de propiedades de una tarea de servicio. Puedes configurar la tarea para llamar a un agente de UiPath o a un agente externo, dependiendo de las necesidades de tu negocio.

Iniciar y esperar al agente

Usa esta opción para invocar un agente implementado en tu tenant de UiPath. Esto incluye lo siguiente:

• Agentes de código bajo creados con herramientas como Agent Builder.
• Agentes codificados desarrollados en Python u otros lenguajes e implementados en Orchestrator.

En runtime, Maestro envía parámetros de entrada al agente en formato JSON. Cuando el agente completa la ejecución, devuelve una respuesta con los valores de salida que espera el proceso.

Iniciar y esperar al agente externo

Utiliza esta opción para conectarte a sistemas de terceros o externos. Debes especificar:

• Conector: el destino de integración (por ejemplo, CrewAI, Salesforce u otro servicio)
• Conexión: una instancia configurada del conector que representa a un agente específico o un conjunto de credenciales específicas del contexto.
  Nota: puedes utilizar el mismo agente con diferentes permisos o comportamientos definiendo varias conexiones.

Entradas y salidas

Las entradas y salidas para agentes se configuran de la misma manera que otros tipos de tareas de Maestro.

• Entradas: variables o expresiones pasadas al agente en runtime.
• Salidas: variables rellenadas a partir de la respuesta JSON del agente.

Maestro envía parámetros de entrada como carga útil JSON en el formato:

{
  "key1": "value1",
  "key2": "value2"
}

El agente debe devolver una respuesta JSON utilizando los mismos nombres de parámetros que espera Maestro. Estos valores se asignan para procesar variables mediante la sección Salida > Respuesta en el panel Propiedades de la tarea.

Ejemplos de entrada y salida

Tabla 1. Entradas de ejemplo (de Maestro a agente)

Parámetro	Descripción
role	Rol o contexto de la tarea (por ejemplo, validación frente a resumen)
prompt	Instrucciones proporcionadas al agente, a menudo incluyendo datos específicos del proceso
tools	Lista de herramientas que el agente puede utilizar para completar la tarea
user_id	Identificador único compartido entre el proceso y el contexto del agente

Solicitud de ejemplo: "Completa la validación de préstamo para {loan_application_number}. Responde en formato JSON utilizando el parámetro 'loan_application_status'."

Tabla 2. Salidas de ejemplo (del agente a Maestro)

Parámetro	Descripción
conversation_id	Referencia a la sesión de diálogo o interacción
loan_application_status	Resultado de estado devuelto por el agente
tokens_used	Metadatos sobre el uso de recursos

Importante:

Para utilizar la salida del agente en tu flujo de trabajo, debes asignar cada parámetro de salida a una variable de proceso en la configuración Salida > Respuesta de la tarea.