Crear un agente en Agent Builder

En esta sección se describe cómo diseñar un agente en Agent Builder.

Importante: La experiencia de Agent Builder está programada para quedar obsoleta a partir del 14 de junio de 2025. Hasta entonces, solo puedes diseñar o evaluar agentes existentes. Te recomendamos migrar tus agentes existentes y empezar a utilizar Agentes en Studio Web. Para obtener más información, consulta Migrar agentes a Studio Web.

Para crear nuevos agentes, consulta Crear un agente en Studio Web.

1. En UiPath® Automation Cloud^TM, selecciona Agentes en la barra de navegación de la izquierda.
   Se mostrará el espacio de trabajo de Agentes.
2. En la lista de Agentes de vista previa, selecciona un agente para abrir el Agent Builder.
3. El espacio de trabajo Agentes incluye tres pestañas: Diseño, Evaluaciones y Seguimientos.

   Utiliza la pestaña Diseño para diseñar y definir los elementos básicos de tu agente. Una vez que hayas definido los argumentos de entrada/salida, puedes usar este espacio para previsualizar tus ejecuciones de agente.

   Utiliza la pestaña Evaluaciones para crear evaluaciones y almacenar resultados. Las evaluaciones miden de forma objetiva el resultado de tu agente y evalúan si es o no coherente con tus objetivos.

   Utiliza la pestaña Seguimientos para registrar y representar todos los seguimientos de tiempo de diseño y evaluación para este agente. Aquí es donde puedes ver todas las ejecuciones del agente y los detalles de la ejecución.

4. Selecciona el modelo de lenguaje grande que deseas utilizar con tu agente. Los modelos se aprovisionan a través de UiPath AI Trust Layer.
   1. Para configurar los ajustes del modelo, selecciona el icono de ajustes junto al campo Modelo. Aquí puedes configurar 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 2 (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.
5. En la pestaña General , edita el nombre y la descripción del agente.

   El nombre y la descripción del agente deben ofrecer detalles sobre el propósito del agente en un lenguaje sencillo. La descripción se utiliza para ayudar a identificar el agente en Studio.

6. En la pestaña Solicitud, añade una solicitud del sistema y una solicitud de usuario bien estructuradas para dar instrucciones a tu agente sobre lo que debe hacer, y las restricciones que debe seguir.
7. Selecciona Argumentos para acceder a la ventana Argumentos, donde puedes configurar los argumentos de entrada y salida utilizados en tu solicitud.
8. En la pestaña Herramientas , añade cualquier herramienta que tu agente pueda utilizar durante la ejecución. Pueden ser un conjunto de actividades de Integration Service, procesos publicados a los que tienes acceso u otros agentes.

   Cada herramienta debe incluir una descripción detallada que ayude al agente a entender cómo y cuándo utilizar esta herramienta.

9. Utiliza la pestaña Contextos para añadir cualquier contexto necesario.

   Los índices de Contextualización permiten al agente acceder a las bases de conocimiento para las que tiene permiso de acceso. Esto ayuda a contextualizar las acciones o respuestas del agente en tus datos empresariales.

10. Usa la pestaña Escaladas para añadir un humano en el bucle y habilitar la memoria de agente.

    Añadir una escalada permite a tu agente involucrar a un humano para revisar, aprobar o actualizar la salida a medida que se ejecuta.

11. En la ventana Campo de juego, proporciona la entrada para una ejecución de pruebas y selecciona Ejecutar.

    Debes probar tu agente para asegurarte de que funciona según lo esperado.

12. A continuación, ve a la pestaña Evaluaciones para revisar y medir a tu agente.

    Una evaluación es un par entre una entrada y una afirmación realizada en la salida, y se puede utilizar para calificar a tu agente durante una ejecución de extremo a extremo.

13. Después de ejecutar las evaluaciones, utiliza la pestaña Seguimientos para revisar todos los registros de seguimiento para tu agente.
14. Cuando hayas probado, evaluado y refinado tu agente, selecciona Publicar para publicarlo en Orchestrator como un proceso.
    • Selecciona dónde publicar:
      • Fuente de espacio de trabajo personal de Orchestrator: el proceso se publica en tu espacio de trabajo personal y solo estará disponible para ti. Esta es la selección predeterminada.
      • Fuente de procesos de tenant de Orchestrator: el proceso se publicará en la fuente global del tenant y estará disponible para todos los usuarios asignados a carpetas que utilicen la fuente del tenant.
    • 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.

    Importante: Este paso es necesario para que el agente esté disponible en la actividad Ejecutar trabajo.

    Selecciona Exportar para ver y empaquetar la definición de agente como JSON. A continuación, puedes utilizar este extracto JSON para importar el agente en una organización diferente.

15. Por último, inserta tu agente en una automatización utilizando la actividad Ejecutar trabajo en Studio. Para obtener más información, consulta Ejecutar el agente.

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.