Observabilitetsintegrasjon for Copilot Studio

Microsoft Copilot Studio-agenter sender automatisk telemetri til Microsoft Agent 365 observabilitetsbackend—ingen manuell SDK-instrumentering kreves. Denne automatiske observabiliteten gir innsikt i agentaktivitet, ytelse og feil på tvers av Administrasjonssenter for Microsoft 365, Microsoft Defender og Microsoft Purview.

Denne artikkelen forklarer hvordan Copilot Studio håndterer observabilitet automatisk og hvor man kan se telemetridata.

Notat

For generelle konsepter for Agent 365-observabilitet og manuell instrumentering for pro-code-agenter, se Agent-observabilitet. Denne artikkelen tar for seg automatisk observabilitet for Copilot Studio-agenter.

Automatisk observerbarhet

Copilot Studio-agenter deltar automatisk i Agent 365-observabilitetsrammeverket:

  • Ingen SDK kreves: I motsetning til pro-code-agenter som krever installasjon og konfigurering av OpenTelemetry SDK, håndterer Copilot Studio all telemetriutsending i plattformens kjøretid.
  • OpenTelemetry-kompatibilitet: Telemetri følger OpenTelemetrys semantiske konvensjoner, noe som sikrer samsvar med pro-code-agenter og andre plattformer.
  • Automatisk innsamling: Telemetri overføres til Agent 365-observabilitetssystemet uten ekstra konfigurasjon.
  • Umiddelbar tilgjengelighet: Observabilitetsdata vises i Administrasjonssenter for Microsoft 365 innen minutter etter agentaktivitet.

Denne automatiseringen muliggjør sentralisert overvåking, sikkerhetsanalyse og samsvarsrapportering uten utviklerinnsats.

Hva slags telemetri registreres

Copilot Studio genererer automatisk to OpenTelemetry-semantiske konvensjoner for generativ kunstig intelligens-spans:

Notat

  • Telemetri fanges kun opp for autentiserte økter
  • Multi-tenant-agenter er ekskludert fra telemetri
  • Agenter med navn lengre enn 42 tegn blir ikke loggført
  • Store innganger og utganger trunkeres automatisk i følgende felter:
    • Utdata-meldinger
    • Verktøyargumenter
    • Verktøysvar (gen_ai.event.content)
    • Agentbeskrivelse

Aktiver agent

Fanger agentens påkallingsaktivitet:

  • Agentidentifikasjon: ID, navn, Entra-ID og type på den påkalte agenten
  • Brukeridentifikasjon: Hvem som interagerte med agenten (når on-behalf-of-flow brukes)
  • Inndatamelding: Brukermelding sendt til agenten (sensitiv data sensurert)
  • Andre identifikatorer: Leietaker- og miljø-IDer
  • Start- og sluttidsstempler: Når påkallelsen begynte og sluttet

Eksempel på hendelse

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

Utdata-melding

Registrerer agentens utdata:

  • Utdatamelding: Agentens svar til brukeren (sensitiv data redigert)

Notat

Feilmeldinger fra agentinvokasjoner eller verktøykjøringer logges som utdata-meldinger.

Følgende er et annet eksempel på en hendelse.

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

Utfør verktøy

Registrerer verktøyutførelse når agenten din bruker koblinger eller handlinger:

  • Agentidentifikasjon: ID, navn, Entra-ID og type på den påkalte agenten
  • Verktøyidentifikasjon: ID og navn på det kjørte verktøyet
  • Verktøyargumenter: Hvilke data som ble sendt (sensitive data maskert)
  • Brukeridentifikasjon: Hvem som interagerte med agenten (når on-behalf-of-flow brukes)
  • Andre identifikatorer: Leietaker- og miljø-IDer
  • Start- og sluttidsstempler: Når utførelsen begynte og sluttet

Følgende er et annet eksempel på en hendelse.

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

All telemetri respekterer personverngrenser. Sensitiv brukerdata i meldinger og verktøyinn- og utdata er redigert bort og ikke synlig for administratorer. Telemetri brukes til intern sikkerhetsovervåking og etterlevelse.

Neste trinn

  • Last updated on