UiPath Documentation
maestro
latest
false
Guía del usuario de Maestro Orchestrate
Importante :
Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Seguimientos de agente externo

Usa Contexto de seguimiento W3C y Exportación de datos para ver qué sucede dentro de los agentes externos que invocan tus procesos de Maestro, cosidos en tu plataforma de observabilidad.

Declaración del problema​

Los procesos de Maestro invocan cada vez más agentes externos: agentes que se ejecutan en plataformas como Azure AI Foundry, Databricks y otras. Por sí misma, una llamada de agente externo le dice a Maestro solo que el agente se ejecutó y si tuvo éxito, no lo que sucedió dentro de él: qué modelo se llamó, qué herramientas se utilizaron, cuánto tiempo llevó cada paso o por qué falló una llamada.

Sin esa visibilidad, los propietarios de procesos no pueden auditar, optimizar o solucionar problemas de los pasos de agente externo en sus procesos. Cuando una llamada externa falla, el registro muestra solo el resultado en el límite, lo que permite a los equipos iniciar sesión en cada plataforma externa, adivinar las marcas de tiempo y buscar en la actividad no relacionada para reconstruir lo que salió mal. Los seguimientos de agentes externos cierran esta brecha.

Cómo ayudan los seguimientos de agentes externos​

Maestro participa en el seguimiento distribuido utilizando el estándar abierto de contexto de seguimiento del W3C . Cada llamada de agente externo que Maestro realiza lleva un ID de seguimiento compartido. Los agentes que entienden el estándar registran su propia actividad bajo ese mismo ID de seguimiento, por lo que tu plataforma de observabilidad puede unir los pasos de Maestro y los pasos internos del agente externo en una única vista de extremo a extremo.

Cómo funciona​

  1. Maestro genera un ID de seguimiento. Cuando se inicia una instancia de proceso, Maestro crea un ID de seguimiento maestro único para la ejecución.
  2. Maestro lo propaga en cada llamada saliente. Antes de invocar un agente externo, Maestro inyecta el ID de seguimiento en la solicitud como un encabezado traceparent W3C, por ejemplo: traceparent: 00-<trace-id>-<span-id>-01
  3. Los agentes compatibles continúan el seguimiento. Un agente externo que admite el contexto de seguimiento del W3C lee el encabezado, mantiene el ID de seguimiento maestro y registra su trabajo interno (llamadas al modelo, uso de herramientas, latencia, errores) como intervalos secundarios en ese mismo seguimiento.
  4. Los intervalos fluyen a tu plataforma de observabilidad. Los intervalos de Maestro llegan a tu plataforma a través de la exportación de datos; los intervalos del agente externo llegan a través de su propio proceso de telemetría. Como ambos llevan el mismo ID de seguimiento, tu plataforma los reúne en una vista en cascada.
Nota:

La propagación de seguimiento es un comportamiento único a nivel de marco. Se aplica a las llamadas de agentes externos a través de Maestro automáticamente: no hay nada que habilitar por conector o por agente.

Requisitos previos​

  • Debes ser administrador de la organización para configurar la exportación de datos, y el tenant debe tener Insights habilitado.
  • Un destino de seguimiento compatible: Databricks, Arize o un punto final OTLP (OpenTelemetry Protocol).
  • El agente externo debe emitir seguimientos, con el seguimiento habilitado en el lado del agente. Los puntos finales de servicio solo de modelo o LLM generalmente no producen seguimientos: solo lo hacen los agentes con el seguimiento habilitado.

Configurar exportación de datos​

Los seguimientos de agentes externos se vuelven visibles una vez que los seguimientos de ejecución de Maestro se exportan a tu plataforma de observabilidad.

  1. Navega a tu organización, selecciona la pestaña Administrador y luego selecciona la tarjeta Exportar datos .
  2. Selecciona + Añadir y completa el asistente de configuración.
  3. Selecciona el tenant y, a continuación, elige el origen de datos de seguimientos de agente y Maestro . Este origen de datos se exporta como datos de OTEL Trace .
  4. Elija su destino: Databricks, Arize o un punto final OTLP , proporcione sus detalles de conexión y guarde.

Una vez que la exportación está activa, los seguimientos de Maestro, incluidos los intervalos de las llamadas de agente externo, se transmiten a tu destino, donde puedes buscar por ID de seguimiento para ver la ejecución completa.

Para obtener detalles de configuración e instrucciones específicas de destino, consulta Exportación de datos.

Nota:

Databricks: la API del agente de Databricks no respeta los encabezados de seguimiento W3C entrantes y en su lugar emite su propio ID de seguimiento por invocación. Para correlacionar las llamadas de Databricks, Maestro captura el ID de seguimiento de Databricks devuelto por la llamada y lo registra en un intervalo de invocación de agente externo , anidado en el intervalo de actividad. Para que esto funcione en el lado de Databricks:

  • El seguimiento de MLflow debe estar habilitado en el agente.
  • El agente debe estar configurado para devolver su ID de seguimiento a UiPath.
  • Se requiere una versión reciente de MLflow: las versiones anteriores no devuelven el ID de seguimiento, por lo que no se genera ningún intervalo de seguimiento.

Preguntas frecuentes​

¿Necesito instalar algo en mis agentes externos?​

No. Maestro propaga el contexto de seguimiento utilizando el estándar abierto de contexto de seguimiento del W3C. Cualquier agente externo que ya admita este estándar registra sus intervalos bajo el ID de seguimiento de Maestro automáticamente: no hay nada que añadir al código del agente.

¿Necesito configurar el seguimiento para cada conector o agente?​

No. La propagación de seguimiento es un comportamiento único a nivel de marco que se aplica a las llamadas de agente externo en Maestro. La única configuración necesaria es configurar un destino de exportación de datos para que los seguimientos lleguen a tu plataforma de observabilidad.

¿Por qué veo seguimientos de algunos agentes externos pero no de otros?​

Un agente externo solo aporta seguimientos si realmente los emite. Los puntos finales de servicio de modelo simple o LLM generalmente no producen seguimientos: solo lo hacen los agentes con el seguimiento habilitado. Para los agentes que admiten el contexto de seguimiento del W3C, sus intervalos aparecen automáticamente bajo el ID de seguimiento de Maestro. Para los agentes que no lo hacen, como Databricks, el seguimiento debe estar habilitado y configurado en el lado del agente para que devuelva un ID de seguimiento a Maestro.

¿Dónde puedo ver los seguimientos?​

En tu propia plataforma de observabilidad. Una vez que la exportación de datos esté activa, busca por el ID de seguimiento para ver los intervalos de Maestro y los intervalos del agente externo unidos en una única vista de extremo a extremo.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado