Copilot Studioの可観測性の統合

Microsoft Copilot Studioエージェントは、Microsoft Agent 365 監視バックエンドにテレメトリを自動的に出力します。手動の SDK インストルメンテーションは必要ありません。 この自動可観測性により、Microsoft 365 管理センター、Microsoft Defender、およびMicrosoft Purview全体のエージェント アクティビティ、パフォーマンス、およびエラーを可視化できます。

この記事では、Copilot Studioが観測性を自動的に処理する方法と、テレメトリ データを表示する場所について説明します。

Note

プロコード エージェントの一般的な Agent 365 監視の概念と手動インストルメンテーションについては、「 エージェントの可観測性」を参照してください。 この記事では、Copilot Studio エージェントの自動可観測性に焦点を当てます。

自動可観測性

Copilot Studioエージェントは、Agent 365 監視フレームワークに自動的に参加します。

  • SDK は不要: OpenTelemetry SDK のインストールと構成を必要とするプロコード エージェントとは異なり、Copilot Studioはプラットフォーム ランタイム内のすべてのテレメトリの放出を処理します。
  • OpenTelemetry コンプライアンス: テレメトリは OpenTelemetry セマンティック規則に従い、プロコード エージェントやその他のプラットフォームとの一貫性を確保します。
  • 自動インジェスト: テレメトリは、追加の構成なしで Agent 365 監視バックエンドにフローします。
  • 即時の可用性: 監視データは、エージェントアクティビティから数分以内にMicrosoft 365 管理センターに表示されます。

この自動化により、開発者の手間をかけずに、一元的な監視、セキュリティ分析、コンプライアンス レポートが可能になります。

キャプチャされるテレメトリー内容は何か

Copilot Studioは、生成型 AI スパンに対して 2 つの OpenTelemetry セマンティック規則を自動的に出力します。

Note

  • テレメトリは、認証されたセッションに対してのみキャプチャされます
  • マルチテナント エージェントがテレメトリから除外される
  • 名前が 42 文字を超えるエージェントはログに記録されません
  • 大きな入力と出力は、次のフィールドで自動的に切り捨てられます。
    • 出力メッセージ
    • ツールの引数
    • ツールの応答 (gen_ai.event.content)
    • エージェントの説明

エージェントを呼び出す

エージェント呼び出しアクティビティをキャプチャします。

  • エージェント ID: 呼び出されたエージェントの ID、名前、Entra ID、および種類
  • ユーザー識別: 代理フローを使用する場合にエージェントと対話したユーザー
  • 入力メッセージ: エージェントに送信されたユーザー メッセージ (機密データが編集されました)
  • その他の識別子: テナント ID と環境 ID
  • 開始タイムスタンプと終了タイムスタンプ: 呼び出しが開始および終了したとき

イベントの例

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

出力メッセージ

エージェントの出力をキャプチャします。

  • 出力メッセージ: ユーザーに対するエージェントの応答 (編集された機密データ)

Note

エージェントの呼び出しまたはツールの実行からのエラー メッセージは、出力メッセージとしてログに記録されます。

イベントの例を次に示します。

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

実行ツール

エージェントがコネクタまたはアクションを使用する場合のツールの実行をキャプチャします。

  • エージェント ID: 呼び出されたエージェントの ID、名前、Entra ID、および種類
  • ツールの識別: 実行されたツールの ID と名前
  • ツール引数: 送信されたデータ (機密データの編集)
  • ユーザー ID: エージェントと対話したユーザー (On-Behalf-Of フローを使用する場合)
  • その他の識別子: テナント ID と環境 ID
  • 開始タイムスタンプと終了タイムスタンプ: 実行が開始および終了されたとき

イベントの例を次に示します。

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

すべてのテレメトリは、プライバシーの境界を尊重します。 メッセージとツールの入力と出力の機密性の高いユーザー データは編集され、管理者には表示されません。 テレメトリは、内部セキュリティの監視とコンプライアンスの目的で使用されます。

次のステップ

  • Last updated on