- Comience ya
- Crear
- Añadir un agente de IA a un flujo de trabajo
- Llamar a una API externa
- Procesar correos electrónicos entrantes
- Crear un flujo de trabajo de notificación de Slack
- Añadir aprobación humana a un flujo de trabajo
- Crear un flujo de trabajo de agente de chat
- Gestionar errores
- Fundamentos de la depuración
- Intervención humana: escalada o paso humano
- Evaluar tus flujos de trabajo
- Implementar y ejecutar
- Ejemplos
- Referencia
Tu primer flujo de trabajo
Crea un flujo de trabajo de entrada de pedidos con dos llamadas a la API, un agente de IA que decide y dos ramas, luego pruébalo e impleméntalo, con un agente de codificación o en el lienzo.
En este tutorial, crearás el flujo de trabajo de entrada de pedidos que ¿Qué es Maestro Automate? describe. Para cada nuevo pedido, el flujo de trabajo comprueba el stock y el crédito del cliente, permite que un agente de IA decida si acepta el pedido y luego crea el pedido o notifica a un representante de ventas.
El tutorial dura unos 15 minutos. Las comprobaciones de stock y crédito llaman a dummyjson.com, una API de muestra gratuita, por lo que no necesitas una cuenta o una clave API para otra aplicación. Los dos últimos pasos son scripts que sustituyen a la gestión de relaciones con el cliente (CRM) y Slack, por lo que el flujo de trabajo se ejecuta sin conexiones a esas aplicaciones. La captura de pantalla anterior muestra Notificar al representante de ventas como un conector de Slack, que es lo que sería en un flujo de trabajo real.
Puedes crear el flujo de trabajo de dos maneras. Elige uno, y el resto de la página sigue tu elección:
- Con un agente de codificación: describe el flujo de trabajo y el agente lo crea para ti.
- Manualmente en el lienzo: añade y configura cada nodo tú mismo.
Antes de comenzar
- Una cuenta de UiPath. Registro describe cómo crear uno.
- Un agente de codificación con UiPath CLI y habilidades. La configuración de su agente de codificación lo prepara en tres pasos.
- VS Code con la extensión UiPath Maestro, para ver el flujo de trabajo en el lienzo. La compilación en VS Code describe cómo instalarla.
- Una cuenta de UiPath. Registro describe cómo crear uno.
- VS Code, Studio Web o Studio Desktop. Studio Web se ejecuta en tu navegador y no necesita instalación. Dónde crear los compara.
1. Crea el flujo de trabajo
-
Cree una carpeta vacía para el proyecto y ábrala en VS Code.
-
Inicia tu agente de codificación en esa carpeta. Por ejemplo, para Claude Code, ejecuta
claudeen el terminal de VS Code. -
Pega esta solicitud:
Create a Maestro Automate project named OrderIntake with a workflow that does exactly this. Don't add, remove, or rename nodes. 1. Rename the Manual trigger to "New order", set its ID to newOrder, and add two input arguments: productId (number) and customerId (string). 2. Add an HTTP Request node "Check stock" (ID checkStock), GET, with the URL as an expression: "https://dummyjson.com/products/" + $vars.newOrder.output.productId 3. Add an HTTP Request node "Check credit" (ID checkCredit), GET https://dummyjson.com/users/1 4. Add an Autonomous Agent node "Review order" (ID reviewOrder) with the default model. System prompt: "You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason." Give the agent the response body of Check stock as the product, and the response body of Check credit as the customer. Output variables: accepted (boolean) and reason (string). 5. Add a Decision node "Accepted?" (ID accepted) with the condition $vars.reviewOrder.output.accepted 6. On True, add a Script node "Create order in CRM" (ID createOrderInCrm): return { orderCreated: true, productId: $vars.newOrder.output.productId }; 7. On False, add a Script node "Notify sales rep" (ID notifySalesRep): return { notified: true, reason: $vars.reviewOrder.output.reason }; The order is: New order → Check stock → Check credit → Review order → Accepted? → True: Create order in CRM, False: Notify sales rep. dummyjson.com is a public sample API, so these URLs work as they are. Then validate the workflow and fix any problems.Create a Maestro Automate project named OrderIntake with a workflow that does exactly this. Don't add, remove, or rename nodes. 1. Rename the Manual trigger to "New order", set its ID to newOrder, and add two input arguments: productId (number) and customerId (string). 2. Add an HTTP Request node "Check stock" (ID checkStock), GET, with the URL as an expression: "https://dummyjson.com/products/" + $vars.newOrder.output.productId 3. Add an HTTP Request node "Check credit" (ID checkCredit), GET https://dummyjson.com/users/1 4. Add an Autonomous Agent node "Review order" (ID reviewOrder) with the default model. System prompt: "You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason." Give the agent the response body of Check stock as the product, and the response body of Check credit as the customer. Output variables: accepted (boolean) and reason (string). 5. Add a Decision node "Accepted?" (ID accepted) with the condition $vars.reviewOrder.output.accepted 6. On True, add a Script node "Create order in CRM" (ID createOrderInCrm): return { orderCreated: true, productId: $vars.newOrder.output.productId }; 7. On False, add a Script node "Notify sales rep" (ID notifySalesRep): return { notified: true, reason: $vars.reviewOrder.output.reason }; The order is: New order → Check stock → Check credit → Review order → Accepted? → True: Create order in CRM, False: Notify sales rep. dummyjson.com is a public sample API, so these URLs work as they are. Then validate the workflow and fix any problems.El agente crea el proyecto, añade los nodos y valida el flujo de trabajo. Es posible que te haga preguntas en el camino. Respóndelas desde la solicitud.
-
Cuando el agente finalice, abre el archivo
.flowdesde el Explorador. Se abre en el lienzo Flujo. -
Comprueba el resultado:
- El lienzo coincide con el flujo de trabajo en la parte superior de esta página.
- Ningún nodo muestra un icono de advertencia y el panel Problemas está vacío.
- La barra de herramientas inferior muestra Maestro Automate. Si muestra Maestro Orchestrate, selecciónalo y elige Maestro Automate.
Si algo no coincide, dígale al agente qué es diferente, por ejemplo: "Falta el crédito de comprobación. Añádelo entre Comprobar stock y Revisar pedido."
Resultado: tu lienzo coincide con el flujo de trabajo en la parte superior de esta página.
Crear el proyecto
Crea un proyecto de Maestro Automate dondequiera que crees:
| Dónde se crea | Cómo crear el proyecto |
|---|---|
| Código VS | Abre la vista de UiPath Maestro con el icono de UiPath en la barra de actividad. Selecciona Crear nuevo y luego selecciona Maestro Automate en la lista Nuevo proyecto . |
| Studio Web | Selecciona la flecha junto a Crear nuevo y luego selecciona Flujo en Maestro Automate. |
| EscritorioStudio | Abre una solución. En el Explorador, selecciona Añadir un proyecto y, a continuación, selecciona Maestro Automate en Añadir a la solución. |
El proyecto se abre en el lienzo Flujo, con un desencadenador Manual ya en él. La barra de herramientas inferior muestra Maestro Automate como modo de compilación.
Cada herramienta también ofrece un proyecto para Maestro Orchestrate: Maestro Orchestrate en VS Code, Flow en Maestro Orchestrate en Studio Web y Maestro Flow en Studio Desktop. Asegúrate de seleccionar el de Maestro Automate.
Comenzar con un desencadenador
Al crear un flujo de trabajo, la primera pregunta a responder es cómo comienza. Un desencadenador es el paso que inicia cada ejecución. Este flujo de trabajo se inicia bajo demanda, que es la forma más fácil de probarlo, por lo que utiliza el desencadenador Manual que ya está en el lienzo.
- Haz doble clic en el nombre del desencadenador Manual y escribe Nuevo pedido. Cambia el nombre de cada nodo de la misma manera.
- En la pestaña Avanzado , establece su ID en
newOrder. Las expresiones en pasos posteriores utilizan este ID. - En la pestaña Parámetros , selecciona Añadir argumento de entrada dos veces para añadir los detalles de la orden:
productId, de tipo número.customerId, de tipo cadena.
Resultado: el flujo de trabajo acepta un ID de producto y un ID de cliente cada vez que se inicia.
Comprobar el stock
La primera pregunta sobre un pedido es si el producto está en stock. Un nodo de solicitud HTTP pregunta a otro sistema llamando a su API, la interfaz que utilizan las aplicaciones para intercambiar datos.
-
Selecciona el + en el identificador saliente de Nuevo pedido, busca Solicitud HTTP y selecciónala.
-
Cambia el nombre del nodo Comprobar stock y en la pestaña Avanzado establece su ID a
checkStock. -
En la pestaña Parámetros , deja Autenticación establecida en Autenticación manual y Método establecido en
GET. -
Cambia el campo URL al modo de expresión, para que muestre
=al inicio, e introduce:"https://dummyjson.com/products/" + $vars.newOrder.output.productId"https://dummyjson.com/products/" + $vars.newOrder.output.productIdLa dirección web está entre
$vars.newOrder.output.productIdy añade el ID de producto del desencadenador al final del mismo. Puedes añadir la parte$varscon { } Insertar en lugar de escribirla.Si el editor sugiere
productIdmientras escribes, acepta la sugerencia conEnteren lugar de escribir el nombre, o se introducirá dos veces.
$vars contiene la salida de los nodos anteriores. Una expresión se lee como $vars.<node ID>.output. Un campo en modo de expresión es JavaScript, por lo que el texto como una dirección web va entre comillas. Las variables y el flujo de datos describen cómo se mueven los datos entre nodos.
Prueba lo que tienes hasta ahora
- Selecciona Ejecutar depuración (▶) en la barra de herramientas inferior del lienzo, introduce
1para productId yc-100para CustomerId y, a continuación, inicia la ejecución. En Studio Web, inícialo con Guardar y depurar. - En el panel debajo del lienzo, en la pestaña Variables , expande Comprobar stock. Sus salidas muestran
codeestablecido en200y los datos del producto enbody, incluidos susstock.
Si la comprobación de stock falla, selecciónala en el seguimiento de ejecución para ver el error. La causa más común es una expresión URL sin comillas alrededor de la dirección web.
Resultado: el flujo de trabajo ya lee datos reales de una API. Puedes volver a ejecutarlo de la misma manera después de cada nodo que añadas.
Comprobar el crédito del cliente
- Selecciona el + en el manipulador saliente de Comprobar stock, añade otra solicitud HTTP, cámbiale el nombre Comprobar crédito y establece su ID a
checkCredit. - Deja Método establecido en
GETy en URL, introducehttps://dummyjson.com/users/1.
En este tutorial, el registro de usuario de muestra sustituye al registro de crédito del cliente.
Dejar que un agente decida
Un agente es un modelo de IA al que das instrucciones y herramientas. En lugar de seguir reglas fijas, lee los datos y decide.
-
Selecciona el + en el manipulador saliente de Comprobar crédito, abre la categoría Agente y selecciona Agente autónomo.
-
Cambia el nombre del nodo Orden de revisión y establece su ID a
reviewOrder. -
Deja Modelo establecido en el modelo predeterminado.
-
En Solicitud del sistema, introduce las instrucciones del agente:
You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason.You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason. -
En Solicitud de usuario, introduce
Product:, añade$vars.checkStock.output.bodycon { } Insertar y, a continuación, introduceCustomer:y añade$vars.checkCredit.output.bodyde la misma manera. Cada valor insertado aparece como un chip en la solicitud. -
En Salidas, selecciona Añadir variable de salida dos veces:
accepted, de tipo boolean.reason, de tipo cadena.
Resultado: el agente devuelve accepted y reason, que los siguientes nodos pueden leer.
Rama en la decisión
-
Selecciona el + en el manipulador saliente de Orden de revisión, abre la categoría Control y selecciona Decisión. Cambiar el nombre ¿Aceptado? y establece su ID en
accepted. -
En la condición, introduce
$vars.reviewOrder.output.accepted. El nodo de decisión obtiene un identificador Verdadero y Falso . -
En el manipulador Verdadero , añade un nodo Script llamado Crear pedido en CRM, con el
createOrderInCrm, e introduce este código:return { orderCreated: true, productId: $vars.newOrder.output.productId };return { orderCreated: true, productId: $vars.newOrder.output.productId }; -
En el manipulador Falso , añade un nodo Script llamado Notificar al representante de ventas, con el
notifySalesRep, e introduce este código:return { notified: true, reason: $vars.reviewOrder.output.reason };return { notified: true, reason: $vars.reviewOrder.output.reason };
En un flujo de trabajo real, Crear pedido en CRM y Notificar al representante de ventas serían conectores, conexiones listas para usar con aplicaciones como tu CRM y Slack. Conector enumera todos los conectores.
Resultado: tu lienzo coincide con el flujo de trabajo en la parte superior de esta página, y ningún nodo muestra un icono de advertencia.
2. Pruébelo
Las pruebas ejecutan el flujo de trabajo en el lienzo con datos de muestra.
- Pregúntale al agente: "Depura el flujo de trabajo con IDDeProducto 1 y IDDeCliente c-100."
- El agente ejecuta el flujo de trabajo e informa del resultado. Cada nodo debe completarse y la ejecución debe tomar la ruta Verdadero para Crear pedido en CRM, porque el producto de muestra está en stock.
- Comprueba la decisión del agente en el informe:
acceptedistrue, con un breve motivo, como "El producto está en stock y el registro del cliente está presente".
Para ver la ejecución tú mismo, selecciona Ejecutar depuración (▶) en la barra de herramientas inferior del lienzo y sigue los pasos de la pestaña Manualmente en el lienzo .
-
Selecciona Ejecutar depuración (▶) en la barra de herramientas inferior del lienzo. Un cuadro de diálogo solicita los valores de las entradas del desencadenador.
-
Introduce
1para IDDeProducto yc-100para IDDeCliente y, a continuación, inicia la ejecución. En Studio Web, el cuadro de diálogo es Configuración de depuración e inicias la ejecución con Guardar y depurar.En Studio Web, los valores se guardan para la siguiente ejecución.
-
Espera a que finalice la ejecución. Cada nodo muestra una marca de verificación verde y la ejecución toma la ruta Verdadero a Crear pedido en CRM, porque el producto de muestra está en stock.
-
En el Seguimiento de ejecución, expande Revisar orden y selecciona Salida del agente. La pestaña Resultado muestra la decisión del agente,
accepted: truey su motivo.
Selecciona Revisar el propio pedido para ver los datos que recibió el agente: el registro completo del producto de Comprobar stock y el registro de usuario de Comprobar crédito.
Si un nodo falla, selecciónalo en el seguimiento de ejecución para ver el error. Los conceptos básicos de depuración cubren las herramientas de depuración en detalle.
Resultado: tu flujo de trabajo se ejecuta desde el desencadenador hasta la rama, y la decisión del agente es visible en el seguimiento.
3. Implementar y ejecutar
Hasta ahora, el flujo de trabajo solo se ha ejecutado como prueba. Su implementación lo convierte en un flujo de trabajo activo que se ejecuta sin el lienzo. Cada ejecución cuenta para las ejecuciones mensuales de su plan.
-
Pregunta al agente:
Deploy this workflow, then start one run with productId 1 and customerId c-100, and tell me where I can see the run.Deploy this workflow, then start one run with productId 1 and customerId c-100, and tell me where I can see the run.El agente empaqueta el proyecto, lo implementa e inicia una ejecución con esas entradas.
-
Cuando la ejecución haya tenido tiempo de finalizar, pregunta: "¿Ha finalizado la ejecución? Dígame su estado final y qué rama tomó"
El agente informa de que la ejecución se ha realizado correctamente y tomó la ruta Verdadero para Crear orden en CRM.
- Implementar el flujo de trabajo:
- Studio Web: selecciona Implementar y espera a que la implementación se realice correctamente.
- VS Code o Studio Desktop: sigue a Implementar un flujo de trabajo.
- Abrir Iniciar trabajo:
- Studio Web: en la pantalla de éxito, selecciona Iniciar trabajo.
- VS Code o Studio Desktop: en Orchestrator, selecciona Soluciones, selecciona la carpeta en la que implementaste y luego selecciona tu solución. En su panel, selecciona Iniciar trabajo.
- En Entrada, introduce
1para productId yc-100para CustomerId y, a continuación, selecciona Iniciar. - Para seguir la ejecución, selecciona el lanzador de productos, el icono de cuadrícula en la parte superior izquierda de la página y luego selecciona Maestro.
- Selecciona Instancias de flujo y luego el nombre de tu flujo de trabajo.
- Selecciona la ejecución para ver cada paso que tomó en el lienzo.
Resultado: su flujo de trabajo se implementa y su primera ejecución tomó la ruta Verdadero para Crear orden en CRM.
Lo que has aprendido
- Desencadenadores: cada flujo de trabajo comienza con uno, y los argumentos de entrada contienen los datos con los que se inicia cada ejecución.
- Solicitudes HTTP: un nodo llama a la API de otro sistema y pone la respuesta a disposición de los nodos posteriores.
- Expresiones:
$vars.<node ID>.outputlee la salida de un nodo anterior. - Agentes: un agente lee los datos, decide y devuelve las variables de salida que defines.
- Decisiones: una condición envía cada ejecución por una de dos rutas.
- Pruebas: una ejecución de depuración muestra lo que cada nodo recibió y devolvió.
- Agentes de codificación: un agente puede crear el mismo flujo de trabajo a partir de una descripción, y tú lo compruebas en el lienzo.
- Implementación: un flujo de trabajo implementado se ejecuta sin el lienzo, y cada ejecución se enumera con su estado.
Próximos pasos
- Evaluaciones: comprueba las decisiones del agente en comparación con un conjunto de pedidos de muestra. El botón Añadir a evaluaciones en una entrada de seguimiento es una forma rápida de comenzar.
- Implementar un flujo de trabajo: hace que el flujo de trabajo se ejecute sin ti.
- Conector: reemplaza los dos scripts con aplicaciones reales.
- Referencia de nodo: cada nodo y cómo configurarlo.
- Comunidad: haz preguntas y comparte flujos de trabajo con otros creadores.