Überwachbarkeitsintegration für Copilot Studio

Microsoft Copilot Studio Agents senden automatisch Telemetrie an das Microsoft Agent 365 Observability-Back-End – keine manuelle SDK-Instrumentierung erforderlich. Diese automatische Observabilität bietet Einblicke in Agentaktivitäten, Leistung und Fehler von Microsoft 365 Admin Center, Microsoft Defender und Microsoft Purview.

In diesem Artikel wird erläutert, wie Copilot Studio die Observierbarkeit automatisch verarbeitet und wo Telemetriedaten angezeigt werden.

Schein

Allgemeine Agent 365-Observability-Konzepte und manuelle Instrumentierung für Pro-Code-Agents finden Sie unter Agent Observability. Dieser Artikel konzentriert sich auf die automatische Observierbarkeit für Copilot Studio Agenten.

Automatische Beobachtbarkeit

Copilot Studio Agents nehmen automatisch am Agent 365 Observability Framework teil:

  • Kein SDK erforderlich: Im Gegensatz zu Pro-Code-Agents, die openTelemetry SDK-Installation und -Konfiguration erfordern, verarbeitet Copilot Studio alle Telemetrieemissionen in der Plattformlaufzeit.
  • OpenTelemetry-Compliance: Telemetrie folgt OpenTelemetry-Semantikkonventionen und stellt die Konsistenz mit Pro-Code-Agents und anderen Plattformen sicher.
  • Automatische Erfassung: Telemetrieflüsse zum Agent 365-Observability-Back-End ohne zusätzliche Konfiguration.
  • Sofortige Verfügbarkeit: Observability-Daten werden innerhalb von Minuten nach Agentaktivität in Microsoft 365 Admin Center angezeigt.

Diese Automatisierung ermöglicht eine zentralisierte Überwachung, Sicherheitsanalyse und Compliance-Berichterstellung ohne Entwickleraufwand.

Welche Telemetrie erfasst wird

Copilot Studio gibt automatisch zwei OpenTelemetry-Semantikkonventionen für generative KI-Bereiche aus:

Schein

  • Telemetrie wird nur für authentifizierte Sitzungen erfasst
  • Mandantenübergreifende Agents werden von telemetrie ausgeschlossen
  • Agents mit Namen, die länger als 42 Zeichen sind, werden nicht protokolliert.
  • Große Eingaben und Ausgaben werden in den folgenden Feldern automatisch verkürzt:
    • Ausgabemeldungen
    • Toolargumente
    • Toolantwort (gen_ai.event.content)
    • Agentbeschreibung

Aufruf-Agent

Erfasst die Agentaufrufaktivität

  • Agentidentifikation: Id, Name, Entra ID und Typ des aufgerufenen Agents
  • Benutzeridentifikation: Wer mit dem Agent interagiert hat (bei Verwendung im Auftrag des Flusses)
  • Eingabenachricht: Benutzernachricht, die an den Agenten gesendet wurde (vertrauliche Daten sind geschwärzt)
  • Andere Bezeichner: Tenant- und Umgebungs-IDs
  • Start- und Endzeitstempel: Wann der Aufruf begonnen und beendet hat

Beispielereignis

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

Ausgabemitteilung

Erfasst die Ausgabe des Agents:

  • Ausgabemeldung: Die Antwort des Agenten an den Benutzer (vertrauliche Daten sind geschwärzt)

Schein

Fehlermeldungen von Agentaufrufen oder Toolausführungen werden als Ausgabemeldungen protokolliert.

Nachfolgend sehen Sie ein weiteres Beispielereignis.

{
  "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 ausführen

Erfasst die Toolausführung, wenn Ihr Agent Connectors oder Aktionen verwendet:

  • Agentidentifikation: Id, Name, Entra ID und Typ des aufgerufenen Agents
  • Toolidentifikation: Die ID und der Name des ausgeführten Tools
  • Toolargumente: Welche Daten wurden gesendet (vertrauliche Daten wurden unkenntlich gemacht)
  • Benutzeridentifikation: Wer mit dem Agent interagiert hat (bei Verwendung von On-Behalf-Of Flow)
  • Andere Bezeichner: Tenant- und Umgebungs-IDs
  • Start- und Endzeitstempel: Wann die Ausführung begonnen und beendet hat

Nachfolgend sehen Sie ein weiteres Beispielereignis.

{
  "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 Formen von Telemetrie respektieren die Privatsphären-Grenzen. Sensible Benutzerdaten in Nachrichten sowie in Werkzeug-Eingaben und -Ausgaben sind geschwärzt und nicht für Administratoren sichtbar. Telemetrie wird für interne Sicherheitsüberwachungs- und Compliance-Zwecke verwendet.

Nächste Schritte

  • Last updated on