Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Puedes añadir un agente de datos Fabric como herramienta a un agente que construyas en Microsoft Foundry. Una vez conectado, el agente de Foundry llama al agente de datos de Fabric para responder a preguntas fundamentadas en tus datos empresariales almacenados en Fabric OneLake.
Este artículo trata sobre la observabilidad para esa configuración. Cuando construyes un agente en Foundry y conectas un agente de datos Fabric a él, quieres ver qué hizo el agente de datos en cada petición, no solo la respuesta final. Foundry Observability te da esa visibilidad. Los registros y las trazas del agente de datos se envían al mismo lugar al que tu agente de Foundry ya envía información, por lo que puedes seguir una petición de principio a fin, desde el agente de Foundry hasta el agente de datos de Fabric y hasta las fuentes de datos que consultó.
El resto de este artículo explica dónde se almacena esa telemetría, cómo llega allí, cómo leerla, quién puede verla y cómo controlarla.
Para una visión general, véase Observabilidad en IA generativa . Para conectar un agente de datos de Fabric a Foundry, consulta Consumir un agente de datos en Microsoft Foundry.
Proyectos de fundición y perspectivas de aplicación
Un proyecto de Foundry es donde construyes y gestionas tus agentes. Foundry almacena trazas de agente en un recurso de Azure Monitor Application Insights, y cada proyecto se conecta a uno de esos recursos.
Como creador del agente, configúralo una sola vez. En tu proyecto Foundry, abre la sección de Agentes , selecciona Trazas y selecciona Conectar. Puedes crear un nuevo recurso de Insights de Aplicaciones o conectar uno que ya exista. Después de conectar el recurso, Foundry activa automáticamente el rastreo del lado del servidor para el proyecto. No necesitas hacer cambios en el código, y los trazos empiezan a fluir en cuestión de minutos.
La relación es sencilla: el proyecto apunta a un recurso de Application Insights y cada agente de ese proyecto envía sus rastros allí. El proyecto define dónde se recoge la telemetría; Application Insights es donde se encuentra y donde lo consultas.
Puedes ver las trazas en la pestaña Traces de tu agente de Foundry, o consultarlas directamente en el recurso conectado Application Insights. El portal de la fundición muestra rastros de los últimos 90 días.
Para la configuración paso a paso, consulta Configurar trazado para agentes de IA en Microsoft Foundry.
Cómo llegan los registros y trazas de los agentes de datos Fabric a tu proyecto
Para conectar un agente de datos Fabric a Foundry, trabaja en un proyecto de Foundry. Si conectas un recurso de Application Insights a ese proyecto, el agente de datos de Fabric envía sus registros y trazas a ese mismo recurso. La telemetría de tu agente de Foundry y la del agente de datos de Fabric se centralizan en un solo lugar, para que puedas consultarlas conjuntamente.
El flujo funciona así:
- En tu proyecto Foundry, conecta un recurso de Application Insights, como se ha descrito en la sección anterior.
- Añadir un agente de datos Fabric como herramienta a un agente de Foundry en ese proyecto.
- Cuando el agente de Foundry se ejecuta, llama al agente de datos de Fabric para obtener conclusiones a partir de los datos empresariales de Fabric OneLake.
- Fabric valida el recurso de Application Insights conectado al proyecto y, a continuación, envía a este los registros y las trazas del agente de datos.
- La telemetría del agente de datos aparece junto con las trazas de tu agente Foundry, tanto en el recurso de Application Insights conectado como en la vista Traces del agente.
El resultado es que el trabajo que realiza el agente de datos de Fabric se convierte en parte del seguimiento de la solicitud. Ves que tu agente de Foundry llamó al agente de datos, y ves qué hizo el agente de datos para obtener su respuesta, incluyendo qué fuentes de datos consultó, cuánto tiempo llevó cada paso y si cada paso tuvo éxito.
Lee las huellas
Foundry Observability registra cada solicitud como una traza. Una traza consiste en tramos, y cada tramo representa una unidad de trabajo con su propia hora, duración y estado. Los spans están anidados, así que, al leer una traza de arriba abajo, se muestra el recorrido que siguió la solicitud y en qué se empleó el tiempo.
Un agente de datos de Fabric añade dos tipos de intervalos a la traza:
- Agente span: la ejecución total del agente de datos Fabric para una sola solicitud.
- Uso de herramienta: una única fuente de datos o herramienta que el agente de datos invoca mientras responde a la solicitud. Una sola solicitud puede producir más de un tramo de herramienta.
El siguiente ejemplo muestra un agente de Foundry que llama a un agente de datos Fabric, que consulta dos fuentes de datos para responder a la pregunta:
Request (trace)
└─ Foundry agent run
└─ Fabric data agent (called as a tool)
└─ Agent span Overall run of the Fabric data agent
├─ Tool span First data source the data agent queried
└─ Tool span Second data source the data agent queried
La siguiente tabla describe cada nivel de la traza y el tipo de metadatos que se le aduntan.
| Level | Emitido por | Representa | Metadatos de ejemplo |
|---|---|---|---|
| Ejecución del agente de Foundry | Fábrica | El agente de Foundry que gestiona la solicitud del usuario | ID de conversación, estado, duración |
| Agente de datos de Fabric (llamada de herramienta) | Fábrica | El punto donde el agente de Foundry llama al agente de datos Fabric | Nombre para mostrar del agente, estado, duración |
| Alcance del agente | Agente de datos de Fabric | La ejecución completa del agente de datos de Fabric para la solicitud | Nombre visible del agente, ID de conversación, estado, duración |
| Intervalo de herramientas | Agente de datos de Fabric | Cada fuente de datos o herramienta a la que el agente de datos llama para responder | Nombre de la fuente de datos, ID del paso de razonamiento, estado, duración |
Con esta estructura, puedes responder a las preguntas que importan cuando algo no cuadra:
- Cuando una respuesta es lenta, la duración de cada tramo muestra qué paso ha tardado más.
- Cuando una respuesta es incorrecta, los segmentos de la herramienta muestran qué fuentes de datos se consultaron y en qué orden.
- Cuando una petición falla, el estado de cada tramo muestra dónde ocurrió el fallo.
Que pueda ver los registros y las huellas
El recurso Application Insights que almacena los registros y trazas del agente de datos regula el acceso. Cualquiera que tenga acceso a ese recurso puede ver la telemetría. Conectar un recurso a un proyecto no otorga acceso a los datos que contiene.
| Dónde visualizas los datos | Acceso necesario |
|---|---|
| Application Insights | Un rol con permisos de lectura en el recurso conectado Application Insights, como Monitoring Reader o Log Analytics Reader |
| Proyecto de Microsoft Foundry | Permisos de lectura sobre el recurso conectado de Application Insights, además del rol Foundry User en el proyecto de Foundry o uno superior |
El acceso a un proyecto de fundición por sí solo no incluye acceso a la telemetría. Siempre se requiere permiso de lectura en el recurso Application Insights.
Configuración de tenente de metadatos operativos
Una configuración de tenant en el portal de administración de Fabric controla si los agentes de datos de Fabric envían metadatos operativos para observabilidad en Foundry. La configuración está activada de manera predeterminada.
La configuración solo envía metadatos operativos. Estos metadatos incluyen nombres de visualización de agentes, nombres de fuentes de datos, IDs de pasos de razonamiento e IDs de conversación. Fabric no envía ningún contenido para clientes. Las indicaciones de los usuarios y las respuestas de los agentes de datos permanecen dentro del límite de cumplimiento de Fabric y no se incluyen en esta telemetría.
Note
Un administrador de Fabric puede desactivarlo para el tenant. Los cambios en la configuración del inquilino pueden tardar hasta una hora en hacer efecto.
El escenario es lo siguiente.
Los agentes de datos Fabric pueden enviar metadatos operativos para observabilidad en Microsoft Foundry
Los creadores de agentes pueden utilizar metadatos operativos para monitorizar el estado de salud de los agentes, detectar problemas y entender cómo se utilizan sus agentes publicados en aplicaciones y servicios. Estos conocimientos ayudan a los creadores de agentes a mejorar la fiabilidad y el rendimiento de los mismos.
Cuando activas esta configuración, los agentes de datos de Fabric envían metadatos operativos a un recurso configurado de Application Insights para su procesamiento y almacenamiento. Estos datos incluyen nombres de visualización de agentes, nombres de fuentes de datos, IDs de pasos de razonamiento e IDs de conversación. El recurso Application Insights que procesa y almacena estos datos podría estar ubicado fuera de la región geográfica de tu inquilino, el límite de cumplimiento o la instancia nacional de la nube.
Para acceder a los metadatos operativos, necesitas un rol con permisos de lectura (como Monitoring Reader o Log Analytics Reader) en el recurso configurado Application Insights. Los usuarios con este acceso pueden ver los datos en Application Insights. Los usuarios también pueden ver los datos a través de un proyecto Foundry que se conecta con el recurso configurado de Application Insights. El acceso a través de Foundry requiere acceso basado en roles al proyecto Foundry (Foundry User o superior), además de permisos de lectura en el recurso Application Insights. El acceso a un proyecto de Foundry por sí solo no incluye el acceso a los datos de telemetría.
Importante
El recurso Application Insights que almacena estos metadatos podría estar ubicado fuera de la región geográfica de tu inquilino, el límite de cumplimiento o la instancia nacional de la nube. Revisa los requisitos de residencia de los datos y de cumplimiento normativo antes de mantener activada esta configuración.