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

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 1. 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.
      • Usa 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 2. Configurar 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 3. Argumentos de entrada en el panel Data Manager
   

   

   
   
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. Seleccionar la flecha junto al entorno de depuración.
3. Seleccionar Configuración de depuració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.