Einblick-Integration für Copilot Studio

Microsoft Copilot Studio-Agents geben automatisch Telemetriedaten an das Microsoft Agent 365 Einblick-Backend aus – eine manuelle SDK-Instrumentierung ist nicht erforderlich. Dieser automatische Einblick bietet Transparenz über die Agentaktivität, Leistung und Fehler im Microsoft 365 Admin Center, Microsoft Defender und Microsoft Purview.

Dieser Artikel erklärt, wie Copilot Studio Einblick automatisch handhabt und wo Sie Telemetriedaten einsehen können.

Anmerkung

Weitere Informationen zu allgemeinen Agent 365-Einblickkonzepten und zur manuellen Instrumentierung für Pro-Code-Agenten finden Sie unter Agent Einblick. Dieser Artikel konzentriert sich auf automatischen Einblick für Copilot Studio-Agents.

Automatischer Einblick

Copilot Studio-Agents sind automatisch Teil des Agent 365 Einblick-Frameworks:

  • Kein SDK erforderlich: Im Gegensatz zu Pro-Code-Agents, die die Installation und Konfiguration des OpenTelemetry SDK erfordern, übernimmt Copilot Studio die gesamte Telemetriedatenübermittlung in der Plattformumgebung.
  • OpenTelemetrie-Compliance: Telemetrie folgt den semantischen Konventionen von OpenTelemetry und sorgt so für Konsistenz mit Pro-Code-Agenten und anderen Plattformen.
  • Automatische Erfassung: Telemetrieflüsse zum Agent 365-Einblicks-Back-End ohne zusätzliche Konfiguration.
  • Sofortige Verfügbarkeit: Einblickdaten erscheinen innerhalb von Minuten nach Agentaktivität im Microsoft 365 Admin Center.

Diese Automatisierung ermöglicht zentrale Überwachung, Sicherheitsanalysen und Compliance-Berichterstattung ohne Entwickleraufwand.

Welche Telemetrie wird erfasst

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

Anmerkung

  • Telemetrie wird nur für authentifizierte Sitzungen erfasst
  • Mehrinstanzfähige Agents werden von der Telemetrie ausgeschlossen
  • Agents mit Namen, die länger als 42 Zeichen sind, werden nicht aufgezeichnet
  • Große Eingaben und Ausgaben werden in den folgenden Feldern automatisch trunkiert:
    • Ausgabemeldungen
    • Tool-Argumente
    • Toolantwort (gen_ai.event.content)
    • Agentbeschreibung

Agent aufrufen

Erfasst die Agentaufruf-Aktivität:

  • Agentidentifikation: Die ID, der Name, die Entra ID und der Typ des aufgerufenen Agents
  • Benutzeridentifikation: Wer mit dem Agent interagiert hat (bei Verwendung des On-Behalf-Of-Flusses)
  • Benutzernachricht: Nachricht, die an den Agent gesendet wurde (vertrauliche Daten maskiert)
  • Andere Bezeichner: Mandanten- und Umgebungs-IDs
  • Start- und Endzeitstempel: Wann der Aufruf begann und endete

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

Ausgabemeldung

Erfasst die Ausgabe des Agents:

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

Anmerkung

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

Nachstehend finden 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 Konnektoren oder Aktionen verwendet:

  • Agentidentifikation: Die ID, der Name, die Entra ID und der Typ des aufgerufenen Agents
  • Toolidentifikation: Die ID und der Name des ausgeführten Tools
  • Toolargumente: Welche Daten wurden übertragen (vertrauliche Daten redigiert)
  • Benutzeridentifikation: Wer mit dem Agent interagiert hat (bei Verwendung des On-Behalf-Of-Flusses)
  • Andere Bezeichner: Mandanten- und Umgebungs-IDs
  • Start- und Endzeitstempel: Wann die Ausführung begann und endete

Nachstehend finden 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 Telemetrie respektiert Datenschutzgrenzen. Sensible Benutzerdaten in Nachrichten sowie in Tooleingaben und -ausgaben werden redigiert und sind für Administratoren nicht sichtbar. Telemetrie wird für interne Sicherheitsüberwachung und Compliance-Zwecke verwendet.

Nächste Schritte,

  • Last updated on