Uso de agentes en Maestro

Cómo funcionan los agentes en Maestro

Los agentes están representados en los flujos de trabajo de Maestro BPMN como tareas de servicio. Cuando tu proceso llama a una Tarea de servicio, Maestro invoca el agente correspondiente con los parámetros de entrada necesarios para la instancia de proceso específica.

Los agentes devuelven datos de salida a Maestro, que se utilizan para determinar los siguientes pasos en el flujo de trabajo. Puedes configurar agentes para informar de las herramientas utilizadas, las decisiones tomadas y rastrear datos para apoyar la depuración y la transparencia.

Los agentes pueden ser:

• Creados directamente en UiPath Platform (código bajo o codificado)
• Conectados a través de API externas o Integration Service
• Desencadenados mediante eventos o señales basadas en la lógica de flujo de trabajo

Observa un ejemplo del mundo real: UiPath Maestro: el cerebro detrás de la automatización de préstamos sin problemas y transparente.

Conexión de agentes a través de Integration Service

UiPath Integration Service proporciona conectores listos para usar y personalizados para integrar sistemas externos en tus automatizaciones:

• Conectores prediseñados para servicios como Salesforce, Microsoft 365 y Google Workspace
• Creador de conectores personalizados para exponer cualquier API de REST a UiPath Platform
• Gestión unificada de credenciales y conexiones

Usa Integration Service para permitir que Maestro envíe/reciba datos de agentes o sistemas no alojados de forma nativa en UiPath. Más información sobre Integration Service.

Uso de agentes externos

Maestro es neutral con respecto al proveedor. Puedes orquestar el trabajo a través de tus agentes de IA externos preferidos, sin reconstruir tus procesos, utilizando conectores de Integration Service de UiPath.

Puedes orquestar:

• Servicios de IA propios
• Motores de decisión externos
• Microservicios o bots alojados en otras plataformas

Maestro invoca a estos agentes llamando a puntos finales REST y espera una carga útil de respuesta con datos estructurados.

Conexión de agentes externos a través de Integration Service

En tiempo de diseño, añade una tarea de servicio, elige Iniciar y esperar al agente externo y configura la actividad del agente desde el conector seleccionado. En runtime, Maestro envía la solicitud y el contexto al agente y espera la respuesta. Asignas esa respuesta a variables para impulsar puertas de enlace, asignaciones y acciones posteriores.

Los siguientes enlaces muestran cómo conectar un agente externo, ejecutarlo desde un proceso de Maestro y capturar su salida para enrutamiento y decisiones:

• Agentes de Snowflake Cortex
• Agentes de Databricks
• Agentes de Azure AI Foundry
• Iniciar agente de CrewAI (vista previa)
• Ejecutar agente de Google Vertex

Inicios rápidos: integraciones de flujo de trabajo de API

Da preferencia a conectores de Integration Service cuando existen. Usa flujos de trabajo de API cuando necesites conectividad en el nivel de API (API tempranas, esquemas en evolución o respuestas en streaming). Define solicitudes y salidas de forma declarativa, analiza JSON sin código personalizado y pasa los resultados a tu proceso de Maestro.

Cuándo utilizar qué:

• Conector: sistema compatible, esquema estable, autenticación gestionada, mejor opción a largo plazo.
• Flujo de trabajo de API: API nueva o no compatible, formas de respuesta cambiantes o salida solo de transmisión.

Guías paso a paso

• Snowflake Cortex: flujo de trabajo de API: maneja la salida de transmisión del agente de Cortex, la ensambla en una respuesta utilizable y devuelve JSON estructurado para la automatización posterior.
• Databricks Genie – flujo de trabajo de API: inicia una conversación, sondea el estado del mensaje hasta COMPLETO, extrae el SQL generado (attachment_id), lo ejecuta y devuelve la respuesta.

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

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:"Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."

Salidas de ejemplo (de 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

ADVERTENCIA:

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.