UiPath Documentation
agents
latest
false
Guía del usuario de Agents
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Agentes en flujo (vista previa)

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 FlowAgentes independientes
Espacio de configuraciónLienzo de flujo en Studio WebAgent Builder en Studio Web
ImplementaciónSin paso de publicación independiente: el agente forma parte del flujoDebe publicarse como un proceso de agente independiente antes de su uso en un flujo
Intercambio de variablesVariables de flujo referenciadas de forma nativa en la solicitud y la salida del agenteVariables pasadas a través de parámetros de invocación de proceso
EncadenamientoVarios agentes en serie en un solo flujoInvocar un agente desde otro utilizando la herramienta Agente
Inserción de variables en solicitudesUtiliza 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 herramientaDisponibilidad
Procesos RPADisponible
Flujos de trabajo de APIDisponible
ActividadesDisponible
Otros flujos (Maestro)Disponible
Agente (invoca un agente independiente publicado)Disponible
Conectores de Integration ServiceDisponible
Herramientas integradas (Analizar archivos, Resumir, Transformación por lotes)Disponible
EscaladasDisponible
MCP toolsNo 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íaTipoDescripción
Validación de salidaContiene textoPasa cuando la salida del agente contiene el texto especificado
Validación de salidaCoincidencia exactaComprueba si la salida del agente coincide exactamente con la salida esperada
Validación de salidaSimilitud de JSONCompara la similitud estructural de los objetos o valores JSON
Juez de LLMSalida de juez de LLMUtiliza un modelo de lenguaje para puntuar en qué medida la salida coincide con la salida esperada en significado e intención
Juez de LLMJSON estricto de juez de LLMUtiliza un modelo de lenguaje para juzgar la coincidencia estructural JSON estricta
Juez de LLMTrayectoria de juez de LLMUtiliza un modelo de lenguaje para juzgar si el agente siguió el comportamiento esperado
Juez de LLMSimulación de juez de LLMUtiliza un modelo de lenguaje para juzgar la ruta de ejecución del agente simulado
Tool CallArgumentos de llamada de herramientaComprueba que las herramientas se llamaron con los argumentos correctos
Tool CallRecuento de llamadas de herramientaComprueba el número de veces que se ha llamado a cada herramienta
Tool CallOrden de llamada de herramientaComprueba que las herramientas se llamaron en la secuencia esperada
Tool CallSalida de llamada de herramientaComprueba que las salidas de la herramienta coinciden con los valores esperados

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado