Crear un agente en Studio Web

Esta sección te guía a través de cómo crear un agente en Studio Web. Para crear agentes de producción fiables, te recomendamos encarecidamente que consultes 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.

Crear el agente

1. Ve a studio.uipath.com.
2. Selecciona el botón Crear nuevo y luego selecciona Agente.
3. Selecciona el tipo de agente:
   • Autónomo: crea un agente que actúe de forma independiente para completar una tarea determinada.
   • Conversacional (vista previa): crea un asistente que interactúe con los usuarios mediante diálogo en tiempo real.
4. Si deseas crear tu agente desde cero, selecciona Empezar de nuevo.
5. Si deseas generar tu agente utilizando Autopilot (vista previa), describe el agente que deseas crear en el cuadro de mensaje disponible y luego selecciona Generar agente. Sé lo más específico posible, para que Autopilot pueda generar un agente de forma eficiente.
6. Se abre la nueva solución mostrando el lienzo del diseñador del Agente.

7. Al configurar tu agente, puedes elegir entre dos modos de diseño: la vista de formulario tradicional y la vista de flujo (vista previa). Ambos modos comparten la misma definición de agente subyacente y permanecen totalmente sincronizados, por lo que puedes cambiar entre ellos en cualquier momento sin perder datos.

   Utiliza la vista Formulario para una experiencia de configuración estructurada y paso a paso, o cambia a la vista Flujo para un diseño visual basado en nodos que te permite ver cómo se conectan e interactúan los componentes de tu agente.

Configurar el agente

Al configurar tu agente, puedes elegir entre dos modos de diseño: la vista de formulario tradicional y la vista de flujo (vista previa). Ambos modos comparten la misma definición de agente subyacente y permanecen totalmente sincronizados, por lo que puedes cambiar entre ellos en cualquier momento sin perder datos.

Utiliza la vista Formulario para una experiencia de configuración estructurada y paso a paso, o cambia a la vista Flujo para un diseño visual basado en nodos que te permite ver cómo se conectan e interactúan los componentes de tu agente.

Crear un agente utilizando la vista Formulario (predeterminado)

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 AI Trust Layer de UiPath. Para obtener más información, consulta Configurar LLM.
   2. Configura la temperatura y la temperatura máx. tokens por campos de respuesta . Estos ajustes pueden estar controlados por una política de gobernanza de Automation Ops. Para obtener más información, consulta Configuración de las políticas de Studio Web.
   • 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.

Crear un agente utilizando la vista de flujo (vista previa)

1. Abre tu proyecto de agente en Studio Web.
2. En la esquina superior derecha del lienzo de tiempo de diseño, selecciona la opción Flujo (vista previa) en el botón de alternancia del modo de creación.

   • Se abre el lienzo de flujo, que muestra la estructura del agente como nodos.

   • Puedes volver a la vista Formulario en cualquier momento. Todos los cambios se guardan y traducen automáticamente entre los dos modos.

3. Comienza con el nodo LLM.
   • Selecciónalo para abrir el panel de Propiedades a la derecha, luego elige y configura tu modelo.
     • Selecciona un modelo de la lista desplegable disponible. Los modelos se aprovisionan a través de UiPath AI Trust Layer. Para aprender a utilizar un modelo personalizado, consulta Configurar LLM.
     • Configura la temperatura y la temperatura máx. tokens por campos de respuesta . Estos ajustes pueden estar controlados por una política de gobernanza de Automation Ops. Para obtener más información, consulta Configuración de las políticas de Studio Web.
       • 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.
   • Una vez seleccionado un modelo, el nodo se actualiza con el icono de familia de modelos correspondiente y el resaltado desaparece.
4. Configura el nodo agente.
   • El nodo Agente se crea de forma predeterminada junto con el nodo LLM.
   • Abre la sección Solicitud a la derecha para definir tus solicitudes de sistema y de usuario. Para los agentes conversacionales, esta sección se simplifica y solo se muestra la solicitud del sistema.
   • Abre la sección Esquema a la izquierda para definir los argumentos de entrada y salida en el panel Data Manager .
5. Añade contexto, herramientas y escaladas. Después de completar los nodos LLM y Agente, quedan disponibles tres nuevos tipos de nodos:
   • Contexto: selecciona un índice de Contextualización y ajusta sus parámetros de búsqueda.
   • Herramientas: abre la paleta de comandos, busca una herramienta implementada y añádela a tu lienzo. Puedes configurar aún más cada herramienta una vez añadida.
   • Escaladas: añade un nodo humano en el bucle que se conecte a la experiencia de configuración de escalada existente.
6. Accede a opciones adicionales seleccionando el menú ⋮ (Más acciones) en un nodo de herramienta. Las siguientes acciones están disponibles:
   • Añadir punto de interrupción : inserta un punto de interrupción en el nodo de la herramienta. Cuando se depura el agente, la ejecución se detiene justo antes de que se ejecute esta herramienta, lo que te permite inspeccionar sus entradas, salidas y datos de seguimiento. Los puntos de interrupción son útiles para verificar la lógica de la herramienta y depurar errores durante las pruebas en tiempo de diseño.
   • Añadir barrera de seguridad : abre la ventana de configuración de la barrera de seguridad , donde puedes definir reglas que restringen o supervisan cómo se utiliza la herramienta en tiempo de ejecución.
   • Deshabilitar : deshabilita temporalmente el nodo de herramienta seleccionado de la ejecución del agente. Las herramientas deshabilitadas permanecen en el lienzo, pero se omiten durante el tiempo de ejecución y la depuración, lo que te permite probar o refinar el comportamiento del agente sin eliminar permanentemente la herramienta.
     
     

     

     
     
7. Depura tu agente.
   • Selecciona Depurar para ejecutar tu agente en tiempo de diseño.
   • A medida que se ejecuta el agente, los nodos se iluminan en secuencia para mostrar el flujo de ejecución.
   • Si ejecutas simulaciones, los nodos aparecen en un color diferente para indicar datos simulados o llamadas a herramientas.
   • Para los agentes conversacionales, una ventana de chat persistente te permite probar los intercambios; cada mensaje desencadena una ejecución de depuración que muestra los aspectos más destacados en los nodos conectados.
   • También puedes establecer puntos de interrupción en nodos específicos para pausar la ejecución e inspeccionar entradas, salidas y datos de seguimiento.
8. Guarda y publica tus cambios.
   • Todas las actualizaciones en la vista Flujo se almacenan automáticamente y permanecen sincronizadas con la vista Formulario.
   • Cuando esté listo, publica el agente para que esté disponible para pruebas e implementación.

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. Selecciona la flecha junto al entorno de depuración y luego selecciona Depurar configuración.
3. En la ventana Configuración de depuración , confirma los recursos utilizados en la solución y la entrada de muestra.
4. Selecciona Guardar y ejecutar.
5. Utiliza 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 y Configurar simulaciones en 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.