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.

Elegir tu tipo de lienzo

Puedes diseñar tu agente utilizando dos vistas distintas: Formulario y Lienzo.

• Lienzo es un lienzo visual. Cuenta con una visualización de arrastrar y soltar basada en nodos en la que cada componente (modelo, solicitud, contexto, herramienta o escalada) se representa como un nodo en el lienzo. Esta vista es ideal para los usuarios que prefieren un enfoque gráfico y exploratorio para el diseño de agentes, lo que les permite crear, depurar y refinar la lógica a través de la manipulación directa de elementos visuales.
• Formulario es la experiencia estándar basada en formularios de Studio Web. Proporciona una experiencia de creación estructurada y basada en formularios en la que cada componente del agente se configura a través de paneles dedicados y campos de entrada. Esta vista es ideal para los usuarios que prefieren un enfoque tabular o impulsado por la configuración para el diseño de agentes, lo que permite la configuración, la validación y las pruebas paso a paso sin depender de diagramas visuales.

Cambia entre los modos Formulario y Lienzo con una sincronización sin pérdida entre ambas experiencias. Cualquier propiedad editada en el formulario se refleja inmediatamente en el lienzo, y viceversa.

Vista de lienzo

El Lienzo está estructurado en torno a cuatro áreas principales:

• Lienzo central: la superficie de diseño principal donde la lógica del agente se representa como nodos conectados. El lienzo admite zoom, panorámica y navegación en minimapa para agentes complejos.
• Panel izquierdo: proporciona acceso a los paneles Explorador de proyecto, Gestor de datos, Errores y Configuración de implementación, de forma coherente con la interfaz basada en formularios.
• Panel derecho: muestra las pestañas Propiedades y Dev, lo que permite a los usuarios editar atributos de nodo o ejecutar pruebas rápidas de depuración.
• Panel inferior: muestra Seguimiento de ejecución, Historial y Evaluaciones, e integra datos de seguimiento en vivo durante la depuración en tiempo de diseño.

Node types on the Canvas

Cada nodo en el lienzo representa un componente lógico en la definición del agente:

• Nodo de agente: define las solicitudes del sistema y del usuario y expone el esquema (argumentos de entrada/salida) en el Gestor de datos. Configura el modelo, la temperatura y los ajustes del token.
• Nodos de contexto – índices de contextualización de enlace, lo que permite la configuración de estrategia de consulta, umbrales y límites de recuperación.
• Nodos de herramientas: visualiza las automatizaciones, actividades u otros agentes conectados. Cada nodo de herramienta se puede expandir para mostrar esquemas de entrada/salida, barreras de seguridad y opciones de simulación.
• Nodos de escalada: indican mecanismos de intervención humana. Al seleccionarlos, se abre el panel Configuración de escalada con destinatarios de tareas y resultados.

Depurar en Vista de lienzo

El Lienzo proporciona comentarios visuales en tiempo real durante la depuración:

• Transmisión de seguimiento: a medida que el agente se ejecuta en tiempo de diseño, los intervalos de seguimiento aparecen directamente en el lienzo y los nodos se iluminan a medida que se activan en el bucle del agente.
• Agentes de conversación: al depurar un agente de conversación, una ventana de chat persistente permite a los usuarios intercambiar mensajes con el agente. Cada mensaje desencadena una ejecución de depuración.
• Puntos de interrupción: puedes pausar la ejecución de un agente en nodos específicos estableciendo puntos de interrupción. Cuando se alcanza un punto de interrupción, el agente se detiene justo antes de ejecutar ese nodo, lo que te permite inspeccionar sus entradas, sus salidas y hacer el segumiento de los datos.

Añadir notas al lienzo

Las notas del lienzo te permiten crear anotaciones en texto de forma libre en la vista del lienzo para describir las áreas, documentar el propósito de las herramientas o dejar recordatorios a los colaboradores.

Para añadir una nota:

1. En la barra de herramientas del lienzo, selecciona el icono Nota.
2. Selecciona en el lienzo la ubicación dónde quieres colocar la nota. Aparecerá una plantilla de nota con un texto provisional.
3. Selecciona la nota e introduce el contenido. Las notas admiten el formato Markdown.

Para gestionar una nota, selecciónala para revelar los iconos de acción y, luego, utiliza las opciones disponibles:

• Editar (icono del lápiz): abre la nota para editarla.
• Cambiar color (icono de punto coloreado): aplica un color a la nota, lo que es útil para agruparla visualmente o para clasificar las áreas del lienzo.
• Eliminar (icono de la papelera): elimina la nota del lienzo.

También puedes arrastrar una nota para reposicionarla en cualquier parte del lienzo y arrastrar sus bordes para cambiar su tamaño.

Visualización del formulario

La Vista de formulario ofrece un espacio de trabajo estructurado basado en paneles para crear y configurar agentes a través de entradas guiadas. Proporciona un diseño claro y paso a paso adecuado para la configuración y validación precisas de los componentes del agente.

Descripción general del diseño

• Formulario de definición de agente: muestra la definición del agente y sus componentes principales, Solicitudes, Herramientas, Contextos y Escaladas, organizados en una estructura lineal basada en formularios.
• Panel izquierdo: incluye los paneles Explorador de proyectos, Gestor de datos, Errores y Configuración de implementación para navegar y gestionar los recursos del proyecto.
• Panel derecho: contiene las pestañas Propiedades y Dev, utilizadas para editar la configuración de componente, ejecutar pruebas rápidas y ver seguimientos en tiempo de diseño.
• Panel inferior: proporciona acceso a Seguimiento de ejecución, Historial y Evaluaciones, mostrando resultados de depuración y métricas de evaluación en tiempo real.

Configuración del agente

Cada sección del formulario corresponde a un componente principal de agente:

• Solicitudes: define el sistema y las instrucciones de usuario que guían el comportamiento del agente.

• Herramientas: añade y configura automatizaciones, actividades de Integration Service u otros agentes que el agente pueda llamar durante la ejecución.

• Contextos: conecta índices de contextualización para proporcionar datos relevantes para el razonamiento.

• Escalaciones: configura acciones con intervención humana.

  Figura 1. La vista de formulario

Depuración en vista de Formulario

Al probar un agente en la vista de formulario, puedes ejecutar sesiones de depuración directamente desde la barra de herramientas para verificar la lógica y las salidas. Los seguimientos de tiempo de diseño aparecen en el panel Seguimiento de ejecución, mostrando entradas, salidas y cualquier error para cada ejecución. Para los agentes de conversación, una ventana de chat integrada te permite intercambiar mensajes y observar respuestas en tiempo real.

Uso de los paneles de Studio Web

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.

Figura 2. El espacio de trabajo de agentes

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

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: crea un asistente que interactúe con los usuarios a través del 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, 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 lienzo. Ambos modos comparten la misma definición de agente subyacente y permanecen completamente sincronizados, por lo que puedes cambiar entre ellos en cualquier momento sin perder datos. Usa la Vista de Formulario para una experiencia de configuración estructurada y paso a paso, o cambia a la Vista de lienzo 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 lienzo. Ambos modos comparten la misma definición de agente subyacente y permanecen completamente sincronizados, por lo que puedes cambiar entre ellos en cualquier momento sin perder datos.

Usa el Formulario para una experiencia de configuración estructurada y paso a paso, o cambia al Lienzo para obtener 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 3. 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.
      • Usa la sección Escalaciones para configurar alternativas con intervención humana.
   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. Abre el menú contextual, selecciona Cambiar nombre y, luego, asigna a tu agente un NombreÚnico. El nombre del agente ayuda a identificar al agente en los proyectos.

3. A continuación, accede al Panel de 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 los campos Temperatura y Máx. tokens por respuesta. Estos ajustes pueden ser controlados por una política de gobernanza de Automation Ops. Para obtener más detalles, consulta Configuración de 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. Los valores más bajos producen salidas más cortas y concisas y ayudan a controlar el uso, mientras que los valores más altos permiten respuestas más detalladas y completas.
   3. Establecer máx. de iteraciones: el número máximo de bucles de razonamiento que el agente puede ejecutar antes de que deba completar la tarea o detenerse.

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 5. 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 tienes acceso. Cada herramienta debe incluir una descripción detallada que ayude al agente a entender 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 una intervención humana a través de una aplicación de escalada. Añadir una escalada permite a tu agente involucrar a un humano para revisar, aprobar o actualizar la salida a medida que se ejecuta. Para obtener más información, consulta Escaladas.

Crear un agente utilizando la Vista de lienzo

1. Abre tu proyecto de agente en Studio Web.

2. En la esquina superior derecha del lienzo en tiempo de diseño, selecciona la opción Lienzo desde la alternancia del modo de creación.

   • Se abre el lienzo, mostrando la estructura del agente en forma de 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 y, 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 los campos Temperatura y Máx. tokens por respuesta. Estos ajustes pueden ser controlados por una política de gobernanza de Automation Ops. Para obtener más detalles, consulta Configuración de 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.
     • Establecer máx. de iteraciones: el número máximo de bucles de razonamiento que el agente puede ejecutar antes de que deba completar la tarea o detenerse.
   • 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 Solicitudes a la derecha para definir tus solicitudes de sistema y usuario.Para 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 Gestor de datos.

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 los errores de depuración durante las pruebas en tiempo de diseño.

   • Añadir barrera de seguridad: abre la ventana Configuración de barreras de seguridad, donde puedes definir reglas que restringen o supervisan cómo se utiliza la herramienta en Runtime.

   • 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 runtime y la depuración, lo que te permite probar o refinar el comportamiento del agente sin eliminar de forma permanente la herramienta.

     

7. Depura tu agente.

   • Seleccionar Debug para ejecutar tu agente en Periodo 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 de conversación, una ventana de chat persistente te permite probar intercambios; cada mensaje activa una ejecución de depuración que muestra aspectos destacados en todos 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.

   • Todos las actualizaciones en la Vista de lienzo se almacenan automáticamente y permanecen sincronizadas con la Vista de 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 que está junto al entorno de depuración y, luego, selecciona Configuración de depuració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.

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.

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 de 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 hagas 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 siguen funcionando sin cambios, lo que garantiza una transición fluida. Al añadir una nueva funcionalidad de ejecución de agente a tus flujos de trabajo, el sistema sugiere e implementa automáticamente la actividad Ejecutar trabajo , incluso si buscas Ejecutar agente.