Integração de observabilidade para Copilot Studio

Agentes do Microsoft Copilot Studio emitem automaticamente telemetria para o back-end de observabilidade do Microsoft 365, sem necessidade de instrumentação manual do SDK. Essa observabilidade automática fornece visibilidade da atividade do agente, desempenho e erros em Centro de administração do Microsoft 365, Microsoft Defender e Microsoft Purview.

Este artigo explica como Copilot Studio lida com a observabilidade automaticamente e onde exibir dados de telemetria.

Note

Para obter conceitos gerais de observabilidade do Agent 365 e instrumentação manual para agentes pro-code, consulte Agent observability. Este artigo se concentra na observabilidade automática para agentes Copilot Studio.

Observabilidade automática

Agentes do Copilot Studio participam da estrutura de observabilidade do Agent 365 automaticamente.

  • Nenhum SDK necessário: ao contrário dos agentes de código profissional que exigem a instalação e a configuração do SDK do OpenTelemetry, o Copilot Studio gerencia todas as emissões de telemetria no ambiente de execução da plataforma.
  • Conformidade com OpenTelemetry: a telemetria segue as convenções semânticas OpenTelemetry, garantindo consistência com agentes pro-code e outras plataformas.
  • Ingestão automática: a telemetria flui para o back-end de observabilidade do Agente 365 sem configuração adicional.
  • Disponibilidade imediata: os dados de observabilidade são exibidos em Centro de administração do Microsoft 365 em poucos minutos da atividade do agente.

Essa automação permite monitoramento centralizado, análise de segurança e relatórios de conformidade sem esforço do desenvolvedor.

Qual telemetria é capturada

Copilot Studio emite automaticamente duas convenções semânticas OpenTelemetry para intervalos de IA generativos:

Note

  • A telemetria é capturada somente para sessões autenticadas
  • Agentes multilocatários são excluídos da telemetria
  • Agentes com nomes com mais de 42 caracteres não são registrados
  • Entradas e saídas grandes são truncadas automaticamente nos seguintes campos:
    • Mensagens de saída
    • Argumentos da ferramenta
    • Resposta da ferramenta (gen_ai.event.content)
    • Descrição do agente

Invocar agente

Captura a atividade de invocação do agente:

  • Identificação do agente: A ID, o nome, o Entra ID e o tipo do agente invocado
  • Identificação do usuário: quem interagiu com o agente (ao usar o fluxo em nome de)
  • Mensagem de entrada: Mensagem de usuário enviada ao agente (dados confidenciais redigidos)
  • Outros identificadores: IDs de locatário e ambiente
  • Carimbos de data/hora de início e término: quando a invocação começou e terminou

Exemplo de evento

{
  "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"
}

Mensagem de saída

Captura a saída do agente:

  • Mensagem de saída: a resposta do agente ao usuário (dados confidenciais redigidos)

Note

Mensagens de erro de invocações de agente ou execuções de ferramenta são registradas como mensagens de saída.

Veja a seguir outro evento de exemplo.

{
  "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"
}

Executar ferramenta

Captura a execução da ferramenta quando seu agente usa conectores ou ações:

  • Identificação do agente: A ID, o nome, o Entra ID e o tipo do agente invocado
  • Identificação da ferramenta: A ID e o nome da ferramenta executada
  • Argumentos da ferramenta: quais dados foram enviados (dados confidenciais redigidos)
  • Identificação do usuário: quem interagiu com o agente (ao usar o fluxo on-Behalf-Of)
  • Outros identificadores: IDs de locatário e ambiente
  • Marcadores de tempo de início e término: quando a execução começou e terminou

Veja a seguir outro evento de exemplo.

{
  "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 a telemetria respeita os limites de privacidade. Dados confidenciais do usuário em mensagens e entradas e saídas de ferramentas são redigidos e não visíveis para os administradores. A telemetria é usada para fins internos de monitoramento de segurança e conformidade.

Próximas etapas

  • Last updated on