Consumir flujos de trabajo de API

Consumir flujos de trabajo de API desde Orchestrator

Para ejecutar tus flujos de trabajo de API publicados desde Orchestrator:

1. En tu Automation Cloud Orchestrator, ve a la carpeta donde existe el proceso de flujo de trabajo de la API.
2. Navigate to Automations > Processes.
3. Para el proceso de flujo de trabajo de la API deseado, selecciona Iniciar un trabajo al final de la fila correspondiente.
4. En la página que se abre, proporciona:
   • Opciones de destino de ejecución
   • Opciones de Argumentos de tiempo de ejecución . La sección Entrada representa tu esquema de entrada de solicitud de API y te permite especificar propiedades para utilizar como entradas para la ejecución.
5. Para ejecutar tu proceso, selecciona Iniciar.

Una vez que tu flujo de trabajo se haya ejecutado correctamente, puedes ver la respuesta generada en los detalles de ejecución del flujo de trabajo: Automatizaciones > Trabajos.

Invocar flujos de trabajo de API en un agente

Amplíe la capacidad de sus agentes de UiPath integrando flujos de trabajo de API como herramientas. Los agentes consultan automáticamente estos flujos de trabajo para recopilar el contexto relevante, lo que permite un control preciso sobre los datos disponibles para tus agentes y modelos de IA.

El siguiente escenario demuestra cómo un flujo de trabajo de API puede transformar los datos recuperados de Workday, limitando la información expuesta a los agentes solo a nombres y direcciones de correo electrónico. En el entorno de pruebas de Workday, Betty Liu está configurada como gestora con informes directos y compañeros asignados. Las consultas de ejemplo para el agente incluyen:

• "¿Quién depende de Betty Liu?"
• "Proporcione todos los pares para Betty Liu".
• "¿Alguno de los compañeros de Betty Liu tiene informes?"
  Importante:

  El agente no almacena tus credenciales de Workday y depende únicamente de las respuestas devueltas por el flujo de trabajo de la API.

Antes de comenzar, asegúrate de que se cumplen los siguientes requisitos previos:

• Has publicado tu flujo de trabajo de la API de Workday en Orchestrator. Confirma que el flujo de trabajo se ejecuta correctamente cuando se ejecuta desde Orchestrator.
• Las unidades de plataforma se asignan a tu tenant.
• Para seguir el ejemplo de integración de Workday proporcionado, asegúrate de que tu flujo de trabajo incluye:
  • Un esquema de entrada con campos para nombre y apellido.
  • Un esquema de salida que contiene matrices para Peers y Direct Reports.

1. Crea tu agente manualmente. Como alternativa, utiliza el generador de Autopilot con la siguiente solicitud: "Consulta de Workday para detalles de administrador, informes y compañeros". Tu agente se crea con Autopilot, que sugiere las solicitudes y la configuración del agente. En este ejemplo, las solicitudes sugeridas se aceptaron inicialmente, pero la solicitud de usuario se simplificó posteriormente para contener solo la variable {{ query }} .

2. En el panel Gestor de datos de tu agente, define una propiedad de Entrada llamada query, de tipo String. Esto garantiza que tu solicitud de usuario contenga una referencia válida.

3. Selecciona Depurar en la nube. Se te pedirá que proporciones la consulta para tu solicitud de usuario. Sin embargo, el panel Seguimiento de ejecución muestra que el agente actualmente no tiene acceso a Workday, por lo que aún no puede proporcionar una respuesta.

4. En la sección Herramientas de tu agente, selecciona Añadir herramienta > Flujo de trabajo de API.

5. Selecciona el flujo de trabajo de la API existente (el que consulta Workday) y proporciona una descripción para él. Como práctica recomendada, proporciona suficientes detalles para que el agente configure automáticamente el flujo de trabajo en función de tu solicitud. Una descripción clara suele incluir detalles sobre tus parámetros de entrada. Por ejemplo: "Toma el nombre y el apellido de un trabajador como entrada y proporciona sus informes directos y compañeros en la respuesta. La entrada de nombre es el gestor que buscaremos en Workday".

6. Vuelve a ejecutar tu agente seleccionando Depurar en la nube. Proporciona la siguiente consulta: "¿Quién depende de Betty Liu?". El panel Seguimiento de ejecución ahora identifica que el agente llama al flujo de trabajo de la API, incluyendo:

   • La solicitud enviada al flujo de trabajo de la API
   • La respuesta recibida del flujo de trabajo de la API
   • Cómo utiliza el agente la respuesta para completar su consulta

¡Enhorabuena!

Ahora puedes crear variaciones de tu solicitud de usuario agente. Dependiendo de la consulta, el agente puede desencadenar varias llamadas a tu flujo de trabajo de la API antes de proporcionar una respuesta completa.

Utilizar flujos de trabajo de API como tareas en Maestro

Los flujos de trabajo de API como tareas en Maestro encapsulan el encadenamiento detallado de API y las transformaciones de datos. Esto mantiene el proceso principal de Maestro claro, conciso y fácil de seguir. Al aislar interacciones específicas de la API dentro de los flujos de trabajo de la API, mantienes la legibilidad y promueves la reutilización en múltiples procesos.

El siguiente escenario demuestra cómo Maestro llama a las API de Workday y luego envía una notificación al equipo de Slack cada vez que se despide a un empleado.

Antes de comenzar, asegúrate de que se cumplen los siguientes requisitos previos:

• Has publicado tu flujo de trabajo de la API de Workday en Orchestrator. Confirma que el flujo de trabajo se ejecuta correctamente cuando se ejecuta desde Orchestrator. Asegúrate de que tu flujo de trabajo de API incluya:
  • Un esquema de entrada con campos para Nombre y Apellido.
  • Un esquema de salida que contiene matrices para Peers y Direct Reports.

Paso 1: crear un proceso agéntico

1. Crea un proceso agéntico.
2. Añade un elemento de evento de inicio . Nómbralo "Empleado contratado".
   1. Para la propiedad Acción del evento Iniciar, selecciona Esperar evento del conector.
   2. Para la propiedad Conector , selecciona Workday REST - Worker created. Este es el evento que desencadena el proceso.
3. Añade un elemento Tarea y conéctalo al evento de Inicio . Nómbralo "Buscar relaciones de empleados".
4. Añade otro elemento Tarea , nómbralo "Enviar notificaciones" y conéctalo al elemento Buscar relaciones de empleado.
5. Añade un evento de finalización. Nómbralo "Notificación enviada".

Esta es la configuración del proceso. Cada vez que se contrata a un nuevo empleado, el proceso desencadena el flujo de trabajo de la API, que recupera información de los empleados, como su estructura de informes y las relaciones asociadas.

Paso 2: configurar la tarea Buscar relación de empleado

El flujo de trabajo de la API requerido por el proceso agéntico reside en la tarea Buscar relaciones de empleado. Aquí se explica cómo configurarlo:

1. Selecciona la tarea Buscar relaciones de empleado .

2. Para la propiedad Acción , selecciona Iniciar y esperar el flujo de trabajo de la API.

3. Para la propiedad Flujo de trabajo de la API , selecciona el flujo de trabajo de la API de Workday publicado. El panel de propiedades muestra entradas y salidas para el flujo de trabajo seleccionado. Para este ejemplo:

   • Las entradas incluyen Apellido y Nombre.
   • Las salidas incluyen detalles para Gestor, Pares e Informes.

4. Configura las entradas de la siguiente manera:

   • Nombre como una variable del objeto Respuesta al evento de inicio . Abre el Editor de expresiones, selecciona Insertar variable y ve a Empleado contratado > respuesta > Trabajador > Nombre completo del trabajador. A continuación, añade Split(' ')[0] a la expresión. Debería tener el siguiente aspecto:

     vars.response_1.worker.descriptor.Split(' ')[0]
     

   Donde worker es el objeto de respuesta de la respuesta del evento de inicio , y.Split(' ')[0] divide el nombre completo por el carácter de espacio y obtiene la primera parte del nombre completo.

   • Apellido como una variable del objeto Respuesta al evento de inicio . Abre el Editor de expresiones, selecciona Insertar variable y ve a Empleado contratado > respuesta > Trabajador > Nombre completo del trabajador. A continuación, añade Split(' ')[1] a la expresión. Debería tener el siguiente aspecto:

   vars.response_1.worker.descriptor.Split(' ')[1]
   

   Donde worker es el objeto de respuesta de la respuesta del evento de inicio , y.Split(' ')[1] divide el nombre completo por el carácter de espacio y obtiene la segunda parte del nombre completo.

Paso 3: personalizar la tarea Enviar notificación

En este paso, configuras la tarea Enviar notificación para utilizar los datos devueltos desde el flujo de trabajo de la API ejecutado en el paso 2.

1. Selecciona la tarea Enviar notificación .
2. Para la propiedad Acción , selecciona Ejecutar evento de conector.
3. Para la propiedad Conector , selecciona Slack y configúralo para usar tu conexión.
4. Para la propiedad Actividad , selecciona Enviar mensaje al canal.
5. Para el Nombre/ID del canal, escribe el ID del canal de Slack al que se debe enviar la notificación.
6. Para la propiedad Mensaje , selecciona las variables de salida del Paso 2: Gestor, Pares e Informes.
7. Para la propiedad Enviar como , selecciona bot.

Paso 4: Probar tu proceso agéntico

Para probar con éxito este proceso agéntico, asegúrate de tener acceso a tu entorno de pruebas de Workday.

Selecciona Prueba para validar tu flujo de trabajo. Maestro te pide que proporciones dos conexiones esenciales:

• Conexión de Slack : necesaria para la tarea Enviar notificación .
• Conexión de Workday : necesaria para el evento de inicio.
  Importante:

  Maestro no solicita conexiones para el flujo de trabajo de la API, ya que estas conexiones se gestionan por separado dentro del propio flujo de trabajo de la API.