Observabilitetsintegration för Copilot Studio

Microsoft Copilot Studio-agenter avger automatiskt telemetri till Microsoft Agent 365-observabilitetsbackend – ingen manuell SDK-instrumentering krävs. Denna automatiska observabilitet ger insyn i agentaktivitet, prestanda och fel i Administrationscenter för Microsoft 365, Microsoft Defender och Microsoft Purview.

Denna artikel förklarar hur Copilot Studio hanterar observerbarhet automatiskt och var man kan se telemetridata.

Kommentar

För grundläggande Agent 365-observabilitetskoncept och manuell instrumentering för pro-code-agenter, se Agentobservabilitet. Den här artikeln fokuserar på automatisk observabilitet för Copilot Studio-agenter.

Automatisk överskådlighet

Copilot Studio-agenter deltar automatiskt i Agent 365-observabilitetsramverket:

  • Ingen SDK krävs: Till skillnad från pro-code-agenter som kräver installation och konfiguration av OpenTelemetry SDK, hanterar Copilot Studio all telemetriemission i plattformens runtime.
  • OpenTelemetry-efterlevnad: Telemetri följer OpenTelemetrys semantiska konventioner och garanterar enhetlighet med kodbaserade agenter och andra plattformar.
  • Automatisk insamling: Telemetri överförs till Agent 365:s observabilitetsbackend utan ytterligare konfiguration.
  • Omedelbar tillgänglighet: Observabilitetsdata visas i Administrationscenter för Microsoft 365 inom några minuter efter agentaktivitet.

Denna automatisering möjliggör centraliserad övervakning, säkerhetsanalys och efterlevnadsrapportering utan att utvecklare behöver anstränga sig.

Vilken telemetri registreras?

Copilot Studio sänder automatiskt två semantiska OpenTelemetri-konventioner för generativa AI-span:

Kommentar

  • Telemetri registreras endast för autentiserade sessioner
  • Multi-tenant-agenter är undantagna från telemetri
  • Agenter med namn längre än 42 tecken loggas inte
  • Stora inmatningar och utdata trunkeras automatiskt i följande fält:
    • Utdatameddelanden
    • Verktygsargument
    • Verktygsvar (gen_ai.event.content)
    • Beskrivning av agenten

Anropa agent

Registrerar agentens anropsaktivitet:

  • Agentidentifiering: ID, namn, Entra-ID och typ av den anropade agenten
  • Användaridentifiering: Vem som interagerade med agenten (när on-behalf-of-flödet används)
  • Användarmeddelande: Meddelande från användaren som skickats till agenten (känsliga data redigerade)
  • Andra identifierare: Hyresgäst- och miljö-ID:n
  • Start- och sluttidsstämplar: När åkallandet började och slutade

Exempel på händelse

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

Utdatameddelande

Fångar agentens utdata:

  • Utdatameddelande: Agentens svar till användaren (känsliga data maskerad)

Kommentar

Felmeddelanden från agentanrop eller verktygskörningar loggas som utdatameddelanden.

Följande är ytterligare ett exempel på händelse.

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

Kör verktyg

Fångar verktygsutförande när din agent använder anslutningsprogram eller åtgärder:

  • Agentidentifiering: ID, namn, Entra-ID och typ av den anropade agenten
  • Verktygsidentifiering: ID och namn på det körda verktyget
  • Verktygsargument: Vilken data skickades (känslig data redigerad)
  • Användaridentifiering: Vilken användare interagerade med agenten (vid användning av On-Behalf-Of-flöde)
  • Andra identifierare: Hyresgäst- och miljö-ID:n
  • Start- och sluttidsstämplar: När körningen började och slutade

Följande är ytterligare ett exempel på händelse.

{
  "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 respekterar sekretessgränser. Känslig användardata i meddelanden och verktygsin- och utdata är maskerad och inte synlig för administratörer. Telemetri används för intern säkerhetsövervakning och regelefterlevnad.

Nästa steg

  • Last updated on