Integración de observabilidad para Copilot Studio

Los agentes de Microsoft Copilot Studio emiten automáticamente telemetría al backend de observabilidad de Microsoft Agent 365—sin necesidad de instrumentación manual del SDK. Esta observabilidad automática proporciona visibilidad en la actividad, el rendimiento y los errores de los agentes en el Centro de administración de Microsoft 365, Microsoft Defender y Microsoft Purview.

Este artículo explica cómo Copilot Studio maneja la observabilidad automáticamente y dónde consultar los datos de telemetría.

Nota

Para obtener información general sobre los conceptos de observabilidad de Agent 365 y la instrumentación manual para agentes de código profesional, consulte Observabilidad del agente. Este artículo se centra en la observabilidad automática de los agentes de Copilot Studio.

Observabilidad automática

Los agentes de Copilot Studio participan en el marco de observabilidad de Agent 365 automáticamente:

  • No se requiere SDK: a diferencia de los agentes de código profesional que requieren instalación y configuración del SDK OpenTelemetry, Copilot Studio gestiona toda la emisión de telemetría en el tiempo de ejecución de la plataforma.
  • Cumplimiento de OpenTelemetry: La telemetría sigue las convenciones semánticas de OpenTelemetry, garantizando la coherencia con los agentes de código profesional y otras plataformas.
  • Ingestión automática: la telemetría fluye hacia el backend de observabilidad de Agent 365 sin configuración adicional.
  • Disponibilidad inmediata: los datos de observabilidad aparecen en el Centro de administración de Microsoft 365 a los pocos minutos de la actividad del agente.

Esta automatización permite la supervisión centralizada, el análisis de seguridad y la generación de informes de cumplimiento sin que los desarrolladores tengan que intervenir.

Qué telemetría se captura

Copilot Studio emite automáticamente dos convenciones semánticas de OpenTelemetry para intervalos de IA generativos:

Nota

  • La telemetría solo se captura para sesiones autenticadas
  • Los agentes de varios inquilinos están excluidos de la telemetría.
  • Los agentes cuyos nombres tienen más de 42 caracteres no se registran.
  • Las entradas y salidas de gran tamaño se truncan automáticamente en los siguientes campos:
    • Mensajes de salida
    • Argumentos de herramientas
    • Respuesta de la herramienta (gen_ai.event.content)
    • Descripción del agente

Invocar agente

Captura la actividad de invocación del agente:

  • Identificación del agente: el id., nombre, Entra ID y tipo del agente invocado
  • Identificación del usuario: quién interactuó con el agente (cuando se usa un flujo en representación de)
  • Mensaje de entrada: mensaje de usuario enviado al agente (datos confidenciales redactados)
  • Otros identificadores: id. de inquilino y de entorno
  • Marcas de tiempo de inicio y fin: cuándo comenzó y terminó la invocación

Evento de ejemplo

{
  "Name": "InvokeAgent",
  "Attributes": {
    "gen_ai.operation.name": "invoke_agent",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.execution.type": "HumanToAgent",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "gen_ai.input.messages": "What's the weather in Seattle?",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 1700000000000000000,
  "EndTimeUnixNano": 0,
  "SpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

Mensaje de salida

Captura la salida del agente:

  • Mensaje de salida: la respuesta del agente al usuario (datos confidenciales redactados)

Nota

Los mensajes de error de las invocaciones de agentes o las ejecuciones de herramientas se registran como mensajes de salida.

El siguiente es otro evento de ejemplo.

{
  "Name": "OutputMessages",
  "Attributes": {
    "gen_ai.operation.name": "output_messages",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.output.messages": "The current weather in **Seattle, WA** is:\n\n- **Temperature:** 18°C (feels like 17°C)...",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 0,
  "EndTimeUnixNano": 1700000005000000000,
  "SpanId": "bbbb2222-cccc-3333-dddd-444444444444",
  "ParentSpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

Ejecutar herramienta

Captura la ejecución de la herramienta cuando su agente utiliza conectores o acciones:

  • Identificación del agente: el id., nombre, Entra ID y tipo del agente invocado
  • Identificación de la herramienta: el id. y el nombre de la herramienta ejecutada
  • Argumentos de la herramienta: qué datos se enviaron (datos confidenciales redactados)
  • Identificación del usuario: quién interactuó con el agente (cuando se usa un flujo con derechos delegados)
  • Otros identificadores: id. de inquilino y de entorno
  • Marcas de tiempo de inicio y fin: cuándo comenzó y terminó la ejecución

El siguiente es otro evento de ejemplo.

{
  "Name": "ExecuteTool",
  "Attributes": {
    "gen_ai.operation.name": "execute_tool",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.tool.name": "msnweather:CurrentWeather",
    "gen_ai.tool.arguments": "{\"Location\":\"Seattle, WA\",\"units\":\"C\"}",
    "gen_ai.tool.call.id": "/providers/Microsoft.PowerApps/apis/shared_msnweather:CurrentWeather:abcdef12-3456-7890-abcd-ef1234567890",
    "gen_ai.tool.type": "Power Platform Connector",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.event.content": "{ /* tool execution results */ }",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 1700000002000000000,
  "EndTimeUnixNano": 0,
  "SpanId": "cccc3333-dddd-4444-eeee-555555555555",
  "ParentSpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

Toda la telemetría respeta los límites de privacidad. Los datos confidenciales de los usuarios presentes en mensajes y en las entradas y salidas de herramientas se redactan y no son visibles para los administradores. La telemetría se utiliza para fines internos de supervisión de seguridad y cumplimiento normativo.

Pasos siguientes

  • Last updated on