Seguimiento y control de datos

El seguimiento de Foundry es una capacidad de observabilidad de Microsoft Foundry que captura Datos del cliente procedentes de agentes de IA. Ayuda a los desarrolladores y operadores a comprender el comportamiento del sistema, depurar problemas y optimizar el rendimiento.

El seguimiento registra información como:

  • Entradas y solicitudes de usuario
  • Entradas y salidas del agente y del modelo
  • Llamadas a herramientas y pasos intermedios
  • Metadatos de ejecución (marcas de tiempo, latencia, uso de tokens, errores, etc.)

Estos datos pueden incluir contenido generado por el usuario y telemetría operativa.

Estos datos se usan para proporcionar visibilidad sobre cómo se ejecutan los agentes, lo que permite la solución de problemas y las mejoras de rendimiento en los flujos de trabajo del agente. Foundry usa estándares openTelemetry y almacena datos de seguimiento en sistemas de telemetría conectados Azure Monitor Application Insights.

Importante

Al habilitar AppInsights para un proyecto, los seguimientos de registros de AppInsights ayudan a supervisar y evaluar las interacciones de nivel de usuario con los agentes. Los miembros del proyecto con el rol Lector de Log Analytics en AppInsights pueden ver los datos de seguimiento, que podrían contener datos personales y contenido del cliente. Si las tablas de Log Analytics subyacentes están protegidas (su nivel de protección está establecido en Protegido), los miembros necesitan el rol Lector de datos de supervisión con privilegios para ver esos datos de seguimiento. Revise qué datos de seguimiento se recopilan y quién puede ver y usar estos datos. Más información se encuentra en la sección siguiente.

Estado predeterminado:

  • El seguimiento está desactivado de forma predeterminada.
  • No se recopilan ni almacenan datos de seguimiento a menos que lo habilite explícitamente el propietario de la cuenta de Foundry o el propietario de Foundry.

Pueden aplicarse precios adicionales por Azure Monitor App Insights.

Esto garantiza que los clientes conserven el control sobre cuándo comienza la recopilación de datos.

Habilitar seguimiento

El seguimiento se habilita cuando un proyecto está conectado a un recurso de Application Insights de Azure Monitor. Entre los flujos de habilitación comunes se incluyen los siguientes:

  • Creación o conexión de un recurso de Application Insights durante la creación del proyecto.
  • Creación o conexión de un recurso de Application Insights a un proyecto existente sin un recurso de Application Insights conectado.

Al habilitar el seguimiento:

  • Los datos de seguimiento comienzan a recopilarse y almacenarse para todos los agentes del proyecto.
  • Para ver los seguimientos en la interfaz de usuario de Foundry Tracing, los usuarios necesitan acceso al proyecto Foundry y permiso de lectura en el área de trabajo conectada de Application Insights o Log Analytics. Por ejemplo, roles como Log Analytics Reader, Monitoring Reader o Reader en el recurso de Application Insights, el área de trabajo de Log Analytics o un ámbito primario adecuado pueden otorgar este acceso. Si las tablas de Log Analytics subyacentes están protegidas, los asignados también necesitan el rol Lector de datos de supervisión con privilegios para leer esos datos.

Deshabilitar el seguimiento

Deshabilite el seguimiento mediante:

  • Desconectar o quitar el recurso de Application Insights.

Después de deshabilitar el seguimiento:

  • No se recopilan nuevos datos de seguimiento en agentes de ese proyecto.
  • Los datos recopilados anteriormente permanecen sujetos a directivas de retención de Application Insights.

Note

Los pasos exactos sobre cómo deshabilitar el seguimiento dependen de la interfaz de usuario o la superficie del SDK y deben alinearse con la documentación del producto.

Dónde se almacenan los datos

Consideraciones sobre el uso compartido de datos

  • Los datos de seguimiento pueden ser accesibles para los usuarios con los permisos adecuados en el recurso de telemetría conectado.
  • En función de la configuración, los usuarios del mismo proyecto o inquilino podrían ver los datos.
  • Para ver los seguimientos en la interfaz de usuario de Foundry Tracing, los usuarios necesitan acceso al proyecto Foundry y permiso de lectura en el área de trabajo conectada de Application Insights o Log Analytics. Por ejemplo, roles como Log Analytics Reader, Monitoring Reader o Reader en el recurso de Application Insights, el área de trabajo de Log Analytics o un ámbito primario adecuado pueden otorgar este acceso. Si las tablas de Log Analytics subyacentes están protegidas, los asignados también necesitan el rol Lector de datos de supervisión con privilegios para leer esos datos.
  • Para conocer consideraciones adicionales e información importante específica de los agentes hospedados, revise los agentes hospedados y las variables de entorno insertadas en la plataforma del agente hospedado.

Los clientes son responsables de configurar controles de acceso y garantizar el cumplimiento de sus directivas organizativas.

Privacidad

El seguimiento puede capturar datos personales, entre los que se incluyen:

  • Solicitudes y respuestas del usuario
  • Contenido específico de la aplicación

procedimientos recomendados

  • Evite registrar secretos, credenciales o tokens.
  • Redacte o minimice los datos personales antes de que se registren.
  • Aplique controles de acceso y directivas de retención para realizar el seguimiento de los datos.

Controles de protección de datos

  • Redacción de datos personales: redacte datos personales, como direcciones de correo electrónico y números de teléfono.
  • Restrinja el acceso a los datos de seguimiento mediante la administración cuidadosa de los usuarios a los que se concede el rol RBAC Log Analytics Lector. Cuando las tablas de Log Analytics subyacentes están protegidas, administre también quién tiene el rol Lector de datos de supervisión con privilegios, ya que concede acceso de lectura a las tablas protegidas.
  • Directivas configurables: controle qué datos se capturan y ven.

Estos controles le ayudan a administrar el riesgo y a cumplir los requisitos de privacidad.

Responsabilidades del cliente

Al habilitar el seguimiento, usted es responsable de:

  • Informar a los usuarios finales sobre la recopilación de datos, incluidos los tipos de datos que se recopilan, el propósito, quién tiene visibilidad, sus opciones y otra información necesaria para que tomen decisiones razonables (si procede).
  • Garantizar el cumplimiento de los requisitos de privacidad, legales y normativos.
  • Configurar los controles de acceso adecuados y las directivas de retención de datos.

Resumen

Foundry Tracing es una potente función de observabilidad que permite depurar, supervisar y optimizar agentes de IA. Es:

  • Desactivado de forma predeterminada.
  • Se habilita explícitamente mediante la conexión de recursos de telemetría.
  • Diseñado para que el cliente tenga control sobre la recopilación y el tratamiento de datos.

Contenido relacionado

  • Last updated on