Crear un agente en Studio Web

Esta sección te guía por la creación de un agente en Studio Web. Una vez que estés familiarizado con los conceptos básicos, consulta Mejores prácticas.

Explorar el espacio de trabajo del agente

Utiliza el lienzo principal del diseñador de Studio Web para diseñar tu agente, y los paneles izquierdo y derecho para explorar la estructura y los recursos del agente.

El panel de la izquierda te muestra la estructura del agente e incluye:

• El Explorador de proyectos: organiza y crea tu agente. Define solicitudes, herramientas, contexto, escaladas y más.
• El Gestor de datos: define los argumentos de entrada y salida.
• El panel Errores: consulta incidencias en tiempo de diseño, configuraciones rotas o ejecuciones de prueba fallidas.
• El panel Configuración de implementación: establece la configuración específica del entorno para publicar y ejecutar el agente.

El panel de la derecha incluye:

• El panel Propiedades, dividido entre:

  • La pestaña Propiedades: configura los ajustes en el nivel de agente y en el nivel de componente.
  • La pestaña Desarrollador: ejecuta entradas de prueba, depura e inspecciona seguimientos en tiempo de diseño.
• Puntuación del agente (vista previa): observa la preparación de tu agente en función de los resultados de la evaluación y la cobertura de la prueba.
• El panel Salida de ejecución: revisa resultados de las ejecuciones de prueba más recientes.
• Autopilot (vista previa): obtén sugerencias impulsadas por IA para refinar las solicitudes, herramientas y la configuración del agente.

El panel inferior hace que las evaluaciones sean una parte central de la experiencia de diseño al mantener el historial, los resultados y los seguimientos en vivo, todo en un solo lugar. Las pestañas disponibles dependen del tipo de agente que estés creando:

• Para los agentes autónomos, el panel inferior incluye:

  • Seguimiento de ejecución: muestra detalles de seguimiento de la ejecución actual. Al ejecutar tu agente, esta pestaña se abre automáticamente para que puedas seguir los seguimientos en vivo en tiempo real.

  • Historial: muestra todas las ejecuciones de tu agente con todos los seguimientos de ejecución y detalles. Desde aquí puedes añadir ejecuciones directamente a los conjuntos de evaluación.

  • Evaluaciones: enumera todos tus conjuntos de evaluación, mostrando las puntuaciones recientes. Expande un conjunto para ver sus evaluaciones, ver detalles o ejecutar pruebas individualmente o como un conjunto completo.

• Para los agentes conversacionales, el panel inferior incluye:

  • Chat: reemplaza a la pestaña Seguimiento de ejecución. Proporciona una ventana de chat interactiva para probar las conversaciones con tu agente a la vez que muestra el seguimiento de ejecución para cada intercambio.

  • Historial: muestra todas las ejecuciones conversacionales con todos los seguimientos de ejecución y detalles. Desde aquí puedes añadir ejecuciones directamente a los conjuntos de evaluación.

  • Evaluaciones: enumera todos tus conjuntos de evaluación, mostrando las puntuaciones recientes. Expande un conjunto para ver sus evaluaciones, ver detalles o ejecutar pruebas individualmente o como un conjunto completo.

Figura 1. El espacio de trabajo de agentes

Crear el agente

1. Ve a studio.uipath.com.
2. Selecciona el botón Crear nuevo y luego selecciona Agente.
3. Se abre la nueva solución mostrando el lienzo del diseñador del Agente.

   [Vista previa] Se muestra el cuadro de mensaje Autopilot del agente, donde puedes describir en lenguaje natural el agente que deseas crear. Sé lo más específico posible, para que Autopilot pueda generar un agente de forma eficiente.

Configurar el agente

1. Desde el panel Explorador de proyectos de la izquierda, accede a Definición, Conjuntos de evaluación y Evaluadores del agente.
   Figura 2. El agente dentro de una solución
   

   

   
   
   1. El panel Definición es donde se diseñan y definen los elementos básicos de un agente. La definición contiene las siguientes secciones: General, Herramientas, Contextos y Escaladas.
      • Utiliza la sección General para definir las indicaciones para tu agente.
      • Utiliza la sección Herramientas para conectar herramientas de runtime, como conectores de Integration Service o automatizaciones publicadas.
      • Utiliza la sección Contextos para vincular fuentes de conocimiento utilizando índices de contextualización para proporcionar a tu agente acceso a los datos relevantes.
      • Utiliza la sección Escaladas para configurar interacciones humanas y habilitar la memoria de agente para que persistan las interacciones y ayuden a calibrar futuras escaladas de agente.
   2. El panel Conjuntos de evaluación es donde creas evaluaciones y almacenas resultados. Las evaluaciones miden de forma objetiva el resultado de tu agente y evalúan si es o no coherente con tus objetivos. Para obtener más información, consulta Evaluaciones.
   3. El panel Evaluadores es donde se crean y gestionan los evaluadores utilizados en las evaluaciones.
2. Primero, selecciona tu agente en Explorador de proyectos. Haz clic con el botón derecho para seleccionar Cambiar nombre y asignar un nombre único a tu agente. El nombre del agente ayuda a identificar al agente en todos los proyectos.
3. A continuación, accede al panel Propiedades desde el menú lateral de la derecha para seleccionar el modelo lingüístico de gran tamaño que deseas utilizar con tu agente.
   1. Selecciona un modelo de la lista desplegable disponible. Los modelos se aprovisionan a través de UiPath AI Trust Layer. Selecciona Usar modelo personalizado para traer tu propio modelo o tu propia suscripción. Para obtener más información, consulta Configurar LLM.
   2. Configura los campos Temperatura y Máx. de tokens por respuesta:
   • La temperatura determina el factor de creatividad de la generación de LLM. Puedes establecer un valor entre 0 (Preciso) y 1 (Creativo).
   • Máx de tokens por respuesta se refiere al número máximo de tokens que se generarán con la respuesta del agente.
   Figura 3. Configuración de los ajustes del modelo
   

   

   
   
4. En el panel Definición del agente, proporciona a tu agente una solicitud del sistema y una solicitud del usuario. Añade una solicitud bien estructurada para dar a tu agente instrucciones sobre lo que debe hacer y las restricciones que debe seguir. Para obtener más información, consulta Solicitudes.
5. Utiliza el panel Gestor de datos para definir los argumentos de entrada y salida del agente utilizados en las solicitudes.
   Figura 4. Argumentos de entrada en el panel Gestor de datos
   

   

   
   
6. En la sección Herramientas , selecciona Añadir herramienta para añadir cualquier herramienta que tu agente pueda utilizar durante la ejecución. Pueden ser un conjunto de actividades de Integration Service, agentes existentes y automatizaciones publicadas a las que tengas acceso. Cada herramienta debe tener una descripción detallada que ayude a informar al agente de cómo y cuándo utilizar esta herramienta. Para obtener más información, consulta Herramientas.
7. (Opcional) En la sección Contextos, selecciona Añadir contexto para dar acceso al agente a los índices de contextualización. Elige un índice existente disponible en tu tenant o selecciona Crear nuevo para crear un índice nuevo directamente en Orchestrator. Para obtener más información, consulta Contextos.
8. (Opcional) En la sección Escaladas, selecciona Añadir escalada para añadir un humano en el bucle a través de una aplicación de escalada y habilitar la memoria del agente. Añadir una escalada permite a tu agente involucrar a un humano para revisar, aprobar o actualizar la salida mientras se ejecuta. Para obtener más información, consulta Escaladas y memoria de agente.

Probar el agente

Ahora es el momento de probar tu agente y ver cómo puedes mejorarlo.

1. Ve a la barra de herramientas situada encima del diseñador de Studio Web.
2. Seleccione el junto al entorno de depuración.
3. Selecciona Depurar configuración.
4. En la ventana Configuración de depuración , confirma los recursos utilizados en la solución y la entrada de muestra.
5. Selecciona Guardar y ejecutar.

A continuación, puedes utilizar la salida de prueba para refinar el diseño del agente.

Evaluar el agente

A continuación, ve a los paneles Conjuntos de evaluación y Evaluadores para revisar y medir a tu agente.

1. En el panel Conjuntos de evaluación:
   • Cambia el nombre del conjunto de evaluación predeterminado y añade casos de prueba con los resultados esperados.
2. En el panel Evaluadores, añade evaluadores para validar la salida del agente.

Cada evaluación vincula una entrada conocida con una aserción sobre la salida.

Para obtener más información, consulta Evaluaciones.

Cálculo de la puntuación del agente [Vista previa]

Selecciona Abrir puntuación de salud en el panel derecho para calcular la puntuación del agente. Consulta Puntuación del agente para obtener más información sobre cómo se calcula.

Uso de Autopilot para mejorar tu agente [Vista previa]

Selecciona Abrir Autopilot en el panel de la derecha para recibir sugerencias sobre la mejora de solicitudes, herramientas y otros componentes. Tales mejoras ayudan a obtener una puntuación de agente más alta y hacen que tu agente esté listo para la implementación.

Publicar e implementar el agente

Una vez que hayas probado, evaluado y refinado tu agente, es el momento de publicarlo.Este paso es necesario para que el agente esté disponible en la actividad Ejecutar trabajo.

1. Selecciona Publicar para publicar el agente en Orchestrator como proceso. Selecciona dónde publicar:
   1. Fuente del espacio de trabajo personal de Orchestrator: el proceso se publica en tu espacio de trabajo personal y solo está disponible para ti. Esta es la selección predeterminada.
   2. Fuente de procesos de tenant de Orchestrator: el proceso se publica en la fuente global del tenant y está disponible para todos los usuarios en carpetas elegibles.
2. Selecciona una versión. Se genera automáticamente una versión a partir de la 1.0.0 cuando se publica por primera vez y, a continuación, se incrementa automáticamente cada vez que se vuelve a publicar.
3. Opcionalmente, puedes seleccionar Enviar como plantilla para que el agente esté disponible como plantilla en tu organización, o Compartir, para compartirlo con los usuarios de tu organización.

Ejecutar el agente

El uso de agentes como actividades significa que puedes incorporarlos a los flujos de trabajo para manejar partes de procesos deterministas más grandes, hacer que varios agentes actúen en serie e iniciar la ejecución de agentes en función de desencadenadores.

Para incorporar tu agente a un flujo de trabajo, sigue estos pasos:

1. Publica tu agente en Orchestrator.
2. En Studio, utiliza la actividad Ejecutar trabajo para integrar tu agente en un flujo de trabajo.

3. Cada vez que realices cambios en tu agente, vuelve a publicar el agente actualizado en Orchestrator y actualiza el proceso correspondiente en Orchestrator.

   La actividad Ejecutar trabajo siempre ejecuta la versión del agente configurado actualmente en Orchestrator. Esto garantiza que tu flujo de trabajo utilice de forma consistente la versión más actualizada de tu agente.

Consulta la Guía de actividades del sistema para obtener más información sobre cómo configurar y utilizar la actividad Ejecutar trabajo en tus flujos de trabajo de Studio.

Nota: a partir de la versión 25.4.2 de UiPath.System.Activities, la ejecución de agentes y otros trabajos de Orchestrator se ha consolidado y mejorado en la actividad Ejecutar trabajo. Los flujos de trabajo existentes que utilizan la actividad Ejecutar agente continúan funcionando sin cambios, garantizando una transición fluida. Al añadir una nueva funcionalidad de ejecución de agentes a tus flujos de trabajo, el sistema sugiere e implementa automáticamente la actividad Ejecutar trabajo, incluso si buscas Ejecutar agente.

Uso de plantillas de agente

Puedes iniciar tu recorrido agéntico con un conjunto de plantillas de agentes, disponibles en la página de Agentes en Automation Cloud^TM y en UiPath® Marketplace.

Una plantilla de agente viene preconfigurada para tareas específicas. Requiere una configuración mínima para que ejecutarse en Studio, y puedes modificarla y adaptarla a tus necesidades específicas. Una plantilla de agente tiene:

• Componentes predefinidos: solicitudes del sistema, herramientas de actividad con descripciones, conjuntos de evaluación inicial.
  • Los componentes son genéricos, no específicos de la empresa o de la organización.
  • Los componentes están disponibles en la definición del agente. Algunos componentes (como las actividades como herramientas) pueden necesitar configuración adicional, como crear las conexiones necesarias en Integration Service.
• Componentes que requieren configuración adicional: índices de Contextualización, automatizaciones y procesos como herramientas, escalas personalizadas y todas las descripciones afiliadas (instrucciones para el agente).
  • Estos componentes son específicos de la organización y del tenant.

Para empezar a utilizar las plantillas de agente de UiPath Marketplace, realiza los siguientes pasos:

1. Desde la página Agentes en Automation Cloud, ve a la pestaña Plantillas y selecciona cualquier plantilla.

   Se te redirige a la plantilla desde Marketplace.

2. Selecciona Descargar.
3. En la ventana Descarga de una plantilla de agente, selecciona Descargar solución.
   Se descargará a tu máquina un archivo .uis que contiene la definición del agente.
4. Las plantillas de agente también incluyen Extras, un paquete independiente que contiene recursos para tu agente (automatizaciones, escaladas personalizadas).Selecciona Descargar extras.
   Se descargará un archivo .zip en tu máquina.
5. En Studio Web, importa el archivo .uis de definición del agente como se describe en Importar un proyecto descargado de Studio Web.
6. A continuación, ve a Soluciones.Para obtener más información, consulta Acceder a la interfaz de usuario de Soluciones.
7. Carga el archivo .zip, como se explica en Transportar un paquete de soluciones, y luego implementa la solución. Para obtener más información, consulta Implementar la solución.
8. Ahora puedes acceder a tu plantilla de agente desde Studio Web y añadir cualquier herramienta implementada a tu tenant.