- Primeros pasos
- Agentes de UiPath en Studio Web
- Acerca de los agentes de UiPath
- Licencia
- Ejecución de agentes
- Agentes y flujos de trabajo
- Mejores prácticas para construir agentes.
- Elegir el mejor modelo para tu agente
- Mejores prácticas para publicar e implementar agentes
- Mejores prácticas para el diseño de contexto.
- Prácticas recomendadas para DeepRAG y Transformación por Lote: JIT frente a estrategias basadas en índice.
- Trabajar con archivos
- Contextos
- Escaladas
- Evaluaciones
- Seguimientos de agente
- Puntuación del agente
- Gestión de agentes de UiPath
- Agentes de UiPath codificados
- Crear con agentes de codificación
Nodos de agente en línea en proyectos de Maestro Flow, configurados en el lienzo de Studio Web junto con conectores y nodos de script sin un paso de publicación independiente.
Los agentes de UiPath en Flow te permiten incrustar agentes de código bajo directamente dentro de un proyecto de Maestro Flow como nodos de agente en línea. En lugar de crear un agente por separado en Agent Builder e invocarlo a través de una llamada de proceso, configuras la solicitud del sistema, el modelo, el esquema de entrada/salida y las herramientas del agente desde el mismo lienzo de Studio Web donde diseñas el flujo.
Los nodos de agente en línea son nodos de primera clase en el lienzo de flujo. Aparecen junto a conectores, nodos de script y otros componentes de flujo. Las variables de flujo pasan a y desde los agentes en línea de forma nativa, y puedes encadenar varios agentes en serie dentro de un solo flujo.
Agentes en línea frente a agentes independientes
| Agentes en línea en Flow | Agentes independientes | |
|---|---|---|
| Espacio de configuración | Lienzo de flujo en Studio Web | Agent Builder en Studio Web |
| Implementación | Sin paso de publicación independiente: el agente forma parte del flujo | Debe publicarse como un proceso de agente independiente antes de su uso en un flujo |
| Intercambio de variables | Variables de flujo referenciadas de forma nativa en la solicitud y la salida del agente | Variables pasadas a través de parámetros de invocación de proceso |
| Encadenamiento | Varios agentes en serie en un solo flujo | Invocar un agente desde otro utilizando la herramienta Agente |
| Inserción de variables en solicitudes | Utiliza convenciones $ ($vars, $metadata) | Utiliza las convenciones @ de Studio Web |
Tipos de agente
- Autónomo : el agente selecciona y ejecuta herramientas para completar una tarea.
Herramientas
Los agentes en línea admiten las siguientes categorías de herramientas:
| Categoría de herramienta | Disponibilidad |
|---|---|
| Procesos RPA | Disponible |
| Flujos de trabajo de API | Disponible |
| Actividades | Disponible |
| Otros flujos (Maestro) | Disponible |
| Agente (invoca un agente independiente publicado) | Disponible |
| Conectores de Integration Service | Disponible |
| Herramientas integradas (Analizar archivos, Resumir, Transformación por lotes) | Disponible |
| Escaladas | Disponible |
| MCP tools | No disponible |
| A2A (agente a agente) | No disponible |
| Extracción y Procesamiento Inteligentes (IXP) (extracción de documentos) | No disponible |
Context
La contextualización está disponible para agentes en línea en paridad con Agent Builder.
Barandillas
Puedes añadir barreras de seguridad en el nivel de agente, en el nivel de LLM o en el nivel de herramienta individual. Las barreras evalúan las entradas y salidas del agente contra las políticas definidas y desencadenan una acción en una coincidencia.
Las barreras de seguridad integradas detectan categorías de contenido específicas automáticamente:
- Detección de PII
- Contenido dañino
- Detección de propiedad intelectual
- Ataques de solicitud de usuario
Escaladas
Las escaladas están disponibles para agentes en línea en paridad con Agent Builder.
Variables de salida
Cada agente en línea devuelve un objeto output . El campo predeterminado es content, que contiene el texto de respuesta del agente. Se pueden declarar variables de salida adicionales en la pestaña Variables para devolver datos estructurados: cada variable requiere un nombre y tipo, y la solicitud del sistema debe indicar al agente que las rellene.
La salida de los nodos anteriores se referencia en los nodos posteriores utilizando $vars.<node>.output.<field>, por ejemplo $vars.agent1.output.content.
Depuración y evaluaciones
Depuración
Puedes depurar nodos de agente en línea individuales de forma aislada de Studio Web utilizando puntos de interrupción, ejecución paso a paso y seguimientos de ejecución. Los nodos de agente individuales pueden depurarse de forma aislada seleccionando el nodo y utilizando la opción Depurar paso a paso .
Las ejecuciones de flujo completo aparecen como trabajos en Orchestrator, donde puedes supervisar el estado de ejecución. Una vez completada una ejecución, el seguimiento de la ejecución está disponible en la pestaña Ejecución del panel inferior, que muestra un desglose paso a paso con el tiempo para cada nodo, incluidas las llamadas y salidas del LLM.
Evaluaciones
Puedes evaluar los agentes en línea por nodo desde el lienzo utilizando el botón Evaluar en la barra de herramientas. Las pestañas Conjuntos de datos y Evaluadores en el panel inferior gestionan los conjuntos de datos de evaluación y los evaluadores y añaden evaluadores a una ejecución de conjunto de datos. La pestaña Ejecuciones muestra el historial de ejecuciones de evaluación.
La evaluación de los agentes en línea está en general a la par con Agent Builder, aunque la experiencia para crear evaluaciones es diferente. Algunas capacidades de Agent Builder aún no están disponibles para los agentes de Flow en línea. Para obtener más detalles, consulta Limitaciones.
Hay tres categorías de evaluadores disponibles:
| Categoría | Tipo | Descripción |
|---|---|---|
| Validación de salida | Contiene texto | Pasa cuando la salida del agente contiene el texto especificado |
| Validación de salida | Coincidencia exacta | Comprueba si la salida del agente coincide exactamente con la salida esperada |
| Validación de salida | Similitud de JSON | Compara la similitud estructural de los objetos o valores JSON |
| Juez de LLM | Salida de juez de LLM | Utiliza un modelo de lenguaje para puntuar en qué medida la salida coincide con la salida esperada en significado e intención |
| Juez de LLM | JSON estricto de juez de LLM | Utiliza un modelo de lenguaje para juzgar la coincidencia estructural JSON estricta |
| Juez de LLM | Trayectoria de juez de LLM | Utiliza un modelo de lenguaje para juzgar si el agente siguió el comportamiento esperado |
| Juez de LLM | Simulación de juez de LLM | Utiliza un modelo de lenguaje para juzgar la ruta de ejecución del agente simulado |
| Tool Call | Argumentos de llamada de herramienta | Comprueba que las herramientas se llamaron con los argumentos correctos |
| Tool Call | Recuento de llamadas de herramienta | Comprueba el número de veces que se ha llamado a cada herramienta |
| Tool Call | Orden de llamada de herramienta | Comprueba que las herramientas se llamaron en la secuencia esperada |
| Tool Call | Salida de llamada de herramienta | Comprueba que las salidas de la herramienta coinciden con los valores esperados |