UiPath Documentation
maestro-automate
latest
false
Guía de usuario de Maestro Automate

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​

1. Crea el flujo de trabajo​

  1. Cree una carpeta vacía para el proyecto y ábrala en VS Code.

  2. Inicia tu agente de codificación en esa carpeta. Por ejemplo, para Claude Code, ejecuta claude en el terminal de VS Code.

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

  4. Cuando el agente finalice, abre el archivo .flow desde el Explorador. Se abre en el lienzo Flujo.

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

2. Pruébelo​

Las pruebas ejecutan el flujo de trabajo en el lienzo con datos de muestra.

  1. Pregúntale al agente: "Depura el flujo de trabajo con IDDeProducto 1 y IDDeCliente c-100."
  2. 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.
  3. Comprueba la decisión del agente en el informe: accepted is true, 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 .

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.

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

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

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>.output lee 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.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado