Integrazione dell'osservabilità per Copilot Studio

Gli agenti di Microsoft Copilot Studio generano automaticamente i dati di telemetria per il back-end di osservabilità di Microsoft Agent 365, senza la necessità di alcuna strumentazione manuale dell'SDK. Questa osservabilità automatica offre visibilità sull'attività, sulle prestazioni e sugli errori dell'agente in interfaccia di amministrazione di Microsoft 365, Microsoft Defender e Microsoft Purview.

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

Note

Per i concetti generali di osservabilità di Agent 365 e la strumentazione manuale per gli agenti pro-code, vedere Osservabilità dell'agente. Questo articolo è incentrato sull'osservabilità automatica per gli agenti Copilot Studio.

Osservabilità automatica

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

  • Nessun SDK necessario: a differenza degli agenti pro-code che richiedono l'installazione e la configurazione di OpenTelemetry SDK, Copilot Studio gestisce tutte le emissioni di 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: i flussi di telemetria fluiscono al back-end di osservabilità di Agent 365 senza configurazione aggiuntiva.
  • Disponibilità immediata: i dati di osservabilità sono visualizzati in interfaccia di amministrazione di Microsoft 365 entro pochi minuti dall'attività dell'agente.

Questa automazione consente il monitoraggio centralizzato, l'analisi della sicurezza e la creazione di report di conformità senza impegno dello sviluppatore.

Quali dati di telemetria vengono acquisiti

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

Note

  • I dati di telemetria vengono acquisiti solo per le sessioni autenticate
  • Gli agenti multi-tenant sono esclusi dai dati di telemetria
  • Gli agenti con nomi più lunghi di 42 caratteri non vengono registrati
  • Gli input e gli output di grandi dimensioni vengono troncati automaticamente nei campi seguenti:
    • Messaggi di output
    • Argomenti degli strumenti
    • Risposta dello strumento (gen_ai.event.content)
    • Descrizione agente

Richiamare l'agente

Acquisisce l'attività di invocazione dell'agente:

  • Identificazione agente: ID, nome, Entra ID e tipo dell'agente richiamato
  • Identificazione utente: chi ha interagito con l'agente (quando si usa il flusso on-behalf-of)
  • Messaggio di input: messaggio 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

Cattura l'output dell'agente:

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

Note

I messaggi di errore provenienti dalle chiamate dell'agente o dalle esecuzioni degli strumenti 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

Rileva l'esecuzione dello strumento quando l'agente utilizza connettori o azioni:

  • Identificazione agente: ID, nome, Entra ID e tipo dell'agente richiamato
  • Identificazione dello strumento: ID e nome dello strumento eseguito
  • Argomenti dello strumento: quali dati sono stati inviati (dati sensibili elaborati)
  • Identificazione utente: Chi ha interagito con l'agente (quando si utilizza il flusso "On-Behalf-Of")
  • Altri identificatori: ID tenant e ambiente
  • Marcatori temporali 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"
}

Tutti i dati di telemetria rispettano i limiti di privacy. I dati utente sensibili nei messaggi e negli input e output degli strumenti vengono oscurati e non siano visibili agli amministratori. I dati di telemetria vengono usati per scopi di monitoraggio e conformità della sicurezza interni.

Passaggi successivi

  • Last updated on