Waarneembaarheidsintegratie voor Copilot Studio

Microsoft Copilot Studio-agenten verzenden automatisch telemetrie naar de Microsoft Agent 365-waarneembaarheidsbackend—geen handmatige SDK-instrumentatie vereist. Deze automatische waarneembaarheid biedt inzicht in agentactiviteit, prestaties en fouten in het Microsoft 365-beheercentrum, Microsoft Defender en Microsoft Purview.

Dit artikel legt uit hoe Copilot Studio waarneembaarheid automatisch afhandelt en waar telemetriegegevens kunnen worden bekeken.

Notitie

Voor algemene Agent 365-waarneembaarheidsconcepten en handmatige instrumentatie voor pro-code agenten, zie Waarneembaarheid van agent. Dit artikel richt zich op automatische waarneembaarheid voor Copilot Studio-agenten.

Automatische waarneembaarheid

Copilot Studio-agenten nemen automatisch deel aan het Agent 365-waarneembaarheidskader:

  • Geen SDK vereist: in tegenstelling tot pro-code agents die installatie en configuratie van een OpenTelemetry SDK vereisen, verzorgt Copilot Studio alle telemetrie-uitvoer in de platformruntime.
  • OpenTelemetry-naleving: telemetrie volgt semantische conventies van OpenTelemetry, waardoor consistentie met pro-code agenten en andere platforms wordt gewaarborgd.
  • Automatische opname: telemetrie stroomt naar de Agent 365 waarneembaarheidsbackend zonder extra configuratie.
  • Directe beschikbaarheid: waarneembaarheidsgegevens verschijnen binnen enkele minuten na agentactiviteit in het Microsoft 365-beheercentrum.

Deze automatisering maakt gecentraliseerde monitoring, beveiligingsanalyse en compliance-rapportage mogelijk zonder inspanning van ontwikkelaars.

Welke telemetrie wordt verzameld?

Copilot Studio geeft automatisch twee semantische conventies van OpenTelemetry door voor generatieve AI-spans:

Notitie

  • Telemetrie wordt alleen vastgelegd voor geverifieerde sessies
  • Multi-tenant agenten zijn uitgesloten van telemetrie
  • Agenten met namen langer dan 42 tekens worden niet vastgelegd
  • Grote invoer en uitvoer wordt automatisch ingekort in de volgende velden:
    • Uitvoerberichten
    • Toolargumenten
    • Toolrespons (gen_ai.event.content)
    • Agentbeschrijving

Agent aanroepen

Legt agentaanroepactiviteit vast:

  • Agentidentificatie: de id, naam, Entra ID en het type van de aangeroepen agent
  • Gebruikersidentificatie: wie heeft gewerkt met de agent (bij gebruik van de on-behalf-of stroom)
  • Invoerbericht: gebruikersbericht gestuurd naar de agent (gevoelige gegevens geredigeerd)
  • Andere id's: tenant- en omgevings-id's
  • Start- en eindtijdstempels: wanneer de aanroep begon en eindigde

Voorbeeldgebeurtenis

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

Uitvoerbericht

Legt de uitvoer van de agent vast:

  • Uitvoerbericht: de respons van de agent aan de gebruiker (gevoelige gegevens geredigeerd)

Notitie

Foutmeldingen van agentaanroepen of tooluitvoeringen worden als uitvoerberichten gelogd.

Hier volgt een andere voorbeeldgebeurtenis.

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

Tool uitvoeren

Legt de uitvoering van de tool vast wanneer de agent connectors of acties gebruikt:

  • Agentidentificatie: de id, naam, Entra ID en het type van de aangeroepen agent
  • Toolidentificatie: de id en naam van de uitgevoerde tool
  • Toolargumenten: welke gegevens er zijn verzonden (gevoelige gegevens geredigeerd)
  • Gebruikersidentificatie: wie heeft met de agent gewerkt (bij gebruik van On-Behalf-Of stroom)
  • Andere id's: tenant- en omgevings-id's
  • Start- en eindtijdstempels: wanneer de uitvoering begon en eindigde

Hier volgt een andere voorbeeldgebeurtenis.

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

Alle telemetrie respecteert privacygrenzen. Gevoelige gebruikersgegevens in berichten en in- en uitvoer van tools wordt geredacteerd en is niet zichtbaar voor beheerders. Telemetrie wordt gebruikt voor interne beveiligingsmonitoring en compliance-doeleinden.

Volgende stappen

  • Last updated on