Integrazione dell'osservabilità per Copilot Studio

Gli agenti di Microsoft Copilot Studio inviano automaticamente la telemetria al backend di osservabilità di Microsoft Agent 365, senza bisogno di strumentazione manuale tramite SDK. Questa osservabilità automatica offre visibilità sull'attività, sulle prestazioni e sugli errori degli agenti nell'interfaccia di amministrazione di Microsoft 365, Microsoft Defender e Microsoft Purview.

Questo articolo spiega come Copilot Studio gestisce automaticamente l'osservabilità e dove visualizzare i dati di telemetria.

Nota

Per i concetti generali di osservabilità di Agent 365 e la strumentazione manuale per agenti tradizionali, consulta Osservabilità dell'Agente. Questo articolo si concentra sull'osservabilità automatica per gli agenti di Copilot Studio.

Osservabilità automatica

Gli agenti di Copilot Studio partecipano automaticamente al framework di osservabilità Agent 365:

  • Nessun SDK richiesto: A differenza degli agenti pro-code che richiedono l'installazione e la configurazione dell'SDK OpenTelemetry, Copilot Studio gestisce l'emissione della telemetria nel runtime della piattaforma.
  • Conformità OpenTelemetry: la telemetria segue le convenzioni semantiche OpenTelemetry, garantendo la coerenza con gli agenti pro-code e altre piattaforme.
  • Inserimento automatico: La telemetria viene inviata automaticamente al backend di osservabilità di Agent 365 senza configurazioni aggiuntive.
  • Disponibilità immediata: i dati di osservabilità appaiono nell'interfaccia di amministrazione di Microsoft 365 entro pochi minuti dall'attività degli agenti.

Questa automazione consente il monitoraggio centralizzato, l'analisi della sicurezza e la creazione di report sulla conformità senza intervento degli sviluppatori.

Quali dati di telemetria vengono acquisiti?

Copilot Studio emette automaticamente due convenzioni semantiche di OpenTelemetry per gli span di IA generativa.

Nota

  • La telemetria viene acquisita solo per le sessioni autenticate
  • Gli agenti multi-tenant sono esclusi dalla telemetria
  • Gli agenti con nomi superiori a 42 caratteri non sono registrati
  • Gli input e output di grandi dimensioni vengono automaticamente troncati nei seguenti campi:
    • Messaggi di output
    • Argomenti dello strumento
    • Risposta dello strumento (gen_ai.event.content)
    • Descrizione agente

Richiama agente

Acquisisce l'attività di invocazione dell'agente:

  • Identificazione dell'agente: ID, nome, Entra ID e tipo dell'agente chiamato
  • Identificazione utente: chi ha interagito con l'agente (quando si usa il flusso on-behalf-of)
  • Messaggio di input: Messaggio dell'utente inviato all'agente (dati sensibili redatti)
  • Altri identificatori: ID tenant e ambiente
  • Timestamp di inizio e fine: Quando l'invocazione è iniziata e terminata

Evento di esempio

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

Messaggio di output

Acquisisce l'output dell'agente:

  • Messaggio di output: La risposta dell'agente all'utente (dati sensibili redatti)

Nota

I messaggi di errore derivanti dall'invocazione dell'agente o dall'esecuzione dello strumento vengono registrati come messaggi di output.

Di seguito è riportato un altro evento di esempio.

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

Esegui strumento

Registra l'esecuzione dello strumento quando il tuo agente utilizza connettori o azioni:

  • Identificazione dell'agente: ID, nome, Entra ID e tipo dell'agente chiamato
  • Identificazione dello strumento: l'ID e il nome dello strumento eseguito
  • Argomenti dello strumento: quali dati sono stati inviati (dati sensibili redatti)
  • Identificazione utente: chi ha interagito con l'agente (quando si usa il flusso On-Behalf-Of)
  • Altri identificatori: ID tenant e ambiente
  • Timestamp di inizio e fine: quando l'esecuzione è iniziata e terminata

Di seguito è riportato un altro evento di esempio.

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

Tutta la telemetria rispetta i limiti della privacy. I dati sensibili degli utenti presenti nei messaggi e negli input e output degli strumenti sono redatti e non sono visibili agli amministratori. La telemetria viene utilizzata per il monitoraggio interno della sicurezza e per scopi di conformità.

Passaggi successivi

  • Last updated on