Orquestar un agente de IA

Cree un agente autónomo en el lienzo, transfiérale datos y enrute la ejecución del flujo de trabajo en función de la decisión del agente.

Qué crearás: un flujo que invoca un agente de IA que creas en el lienzo, le pasa datos y enruta la ejecución en función de la respuesta del agente (aprobado, rechazado o fallido). Esta es la base de cualquier automatización agéntica: una decisión impulsada por el razonamiento integrada en un proceso automatizado más grande.

El agente que creas aquí es un agente autónomo: su modelo, solicitudes, herramientas y contexto viven en el nodo y viajan con el flujo. Para reutilizar un agente que ya está publicado en tu organización en lugar de crear uno en línea, utiliza el nodo de proceso BPMN en su lugar.

Qué necesitará

• Una cuenta de UiPath Automation Cloud con acceso a Maestro Flow.
• Un modelo LLM disponible para que lo utilice el agente.

Nodos utilizados

• Desencadenador manual: inicia el flujo bajo demanda mientras construyes
• Agente: un agente de IA que creas en el lienzo, devuelve su salida
• Decisión: ejecución de ramas en función de la respuesta del agente
• Terminar: finaliza el flujo en una ruta de error

Pasos

1. Crea un nuevo flujo y añade un desencadenador

1. Abre Maestro → Flow y selecciona Nuevo flujo.
2. Arrastra un nodo Desencadenador manual al lienzo.

Para un flujo de producción, reemplazarías esto por un desencadenador programado o de integración. Un desencadenador manual es suficiente mientras creas.

2. Añade un nodo agente

La etiqueta de la paleta del agente es Agente autónomo.

1. Arrastra un nodo Agente desde la sección de nodos de UiPath del panel de nodos al lienzo.
2. Conéctalo al Desencadenador manual.
3. En el panel de propiedades, crea el agente:
   • Establece el Modelo o déjalo en el modelo de agente predeterminado de tu organización.
   • Escribe la solicitud del sistema, el rol del agente y las instrucciones permanentes. El modelo, la solicitud del sistema y la solicitud del usuario son todos obligatorios.
   • Escribe la solicitud de usuario, la tarea para esta ejecución. Referenciar datos de flujo con expresiones; por ejemplo, el texto del documento a clasificar: $vars.start.output.documentText.

3. Devolver un resultado estructurado

De forma predeterminada, el agente devuelve un campo, content, que mantiene su texto de respuesta. Para ramificarse limpiamente, haz que el agente devuelva un campo estructurado en su lugar.

1. Abre la pestaña Variables en el panel de propiedades del agente.
2. Añade una variable de salida llamada decision con tipo string.
3. En la solicitud del sistema, indica al agente que establezca decision en approved o rejected.

4. Gestionar la respuesta del agente

1. Arrastra un nodo Decisión al lienzo y conéctalo al nodo Agente.
2. Establece la condición para evaluar la salida del agente, por ejemplo: $vars.agent1.output.decision === "approved".
3. Conecta la rama Verdadero al siguiente paso de tu automatización (por ejemplo, una notificación o escritura de datos).
4. Conecta la rama Falso a un nodo Terminar .
5. Establece el estado Terminar en Failed y añade un mensaje como Agent returned: $vars.agent1.output.decision.

5. Depurar el flujo

Selecciona Depurar en la barra de herramientas. En el seguimiento de ejecución:

• Selecciona el nodo Agente para inspeccionar qué entradas se enviaron y qué devolvió el agente.
• Confirme que el nodo de decisión tomó la rama correcta dada la salida del agente.
• Si la respuesta del agente no es la esperada, revisa la solicitud del sistema, la solicitud del usuario y la salida declarada antes de cambiar la lógica de flujo no relacionada.

Para ejercer ambas ramas sin esperar respuestas reales del agente, habilita Salida simulada en el nodo Agente y establece una respuesta fija.

Resultado

Tu flujo se ejecuta de principio a fin: el desencadenador manual inicia la ejecución, el nodo de agente razona sobre la entrada y devuelve un campo decision , el nodo de decisión se ramifica en el valor y el nodo Terminar finaliza el flujo en la ruta rechazada . Puedes inspeccionar las entradas y salidas del agente en el seguimiento de ejecución y ajustar las solicitudes directamente en el nodo.

Ampliar este flujo

• Asigna herramientas al agente: conecta los recursos de herramientas (herramientas integradas, herramientas de conector, herramientas de flujo de trabajo de RPA o API, servidores de extracción de documentos o de protocolo de contexto de modelo (MCP)) al identificador de herramientas del agente para que pueda actuar, no solo razonar.
• Arraiga el agente en tus datos: conecta un recurso de contexto al manipulador de contexto del agente para que responda desde una fuente de conocimiento indexada en lugar de solo el modelo.
• Pon a un humano en el bucle: conecta el identificador de Escaladas del agente a un recurso de Escalada para los casos que el agente no debe decidir solo.
• Añadir un bucle: envuelve la invocación del agente en un nodo Bucle para procesar una lista de elementos con el mismo agente.
• Cadena a otro sistema: después de la rama Verdadero del nodo de decisión, añade una solicitud HTTP o un nodo de integración para escribir el resultado en un sistema externo.