Integração de observabilidade do Copilot Studio

Agentes do Microsoft Copilot Studio emitem automaticamente telemetria para o back-end de observabilidade do Microsoft Agent 365, sem necessidade de instrumentação manual do SDK. Essa observabilidade automática oferece visibilidade sobre as atividades, desempenho e erros dos agentes no centro de administração do Microsoft 365, no Microsoft Defender e no Microsoft Purview.

Este artigo explica como o Copilot Studio gerencia automaticamente a observabilidade e onde exibir os dados de telemetria.

Observação

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

Observabilidade automática

Os agentes do Copilot Studio participam automaticamente da estrutura de observabilidade do Agent 365:

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

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

Que telemetria é capturada

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

Observação

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

Invocar o agente

Captura a atividade de invocação do agente:

  • Identificação do agente: ID, nome, Entra ID e 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 do usuário enviada ao agente (dados confidenciais editados)
  • Outros identificadores: IDs de editados e de 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 editados)

Observação

As mensagens de erro de invocações do agente ou de execuções de ferramentas são registradas como mensagens de saída.

Veja a seguir outro exemplo de evento.

{
  "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 a ferramenta

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

  • Identificação do agente: ID, nome, Entra ID e 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 editados)
  • Identificação do usuário: quem interagiu com o agente (ao usar o fluxo On-Behalf-Of)
  • Outros identificadores: IDs de editados e de ambiente
  • Carimbos de data/hora de início e término: quando a execução começou e terminou

Veja a seguir outro exemplo de evento.

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

Próximas etapas

  • Last updated on