تكامل تقنيات المراقبة مع Copilot Studio

يرسل وكلاء Microsoft Copilot Studio تلقائيًا بيانات القياس عن بعد إلى الخلفية Microsoft Agent 365 للمراقبة - دون الحاجة إلى أدوات SDK يدوية. توفر إمكانية المراقبة التلقائية هذه رؤية لنشاط العامل والأداء والأخطاء عبر مركز مسؤولي Microsoft 365 Microsoft Defender Microsoft Purview.

توضح هذه المقالة كيفية تعامل Copilot Studio مع إمكانية المراقبة تلقائيا ومكان عرض بيانات القياس عن بعد.

ملاحظة

للحصول على مفاهيم إمكانية المراقبة العامة للعامل 365 والأجهزة اليدوية لوكلاء التعليمات البرمجية، راجع مراقبة العامل. تركز هذه المقالة على إمكانية المراقبة التلقائية لعوامل Copilot Studio.

إمكانية المراقبة التلقائية

Copilot Studio وكلاء يشاركون تلقائيًا في إطار مراقبة الوكيل 365.

  • لا يلزم وجود SDK: على عكس العوامل البرمجية الاحترافية التي تتطلب تثبيت وتكوين OpenTelemetry SDK، يتولى استوديو Copilot معالجة جميع عمليات إرسال البيانات في وقت تشغيل النظام الأساسي.
  • توافق OpenTelemetry: يتبع القياس عن بعد المعايير الدلالية لـ OpenTelemetry، ما يضمن الاتساق مع وكلاء التعليمات البرمجية المحترفين والأنظمة الأساسية الأخرى.
  • الاستيعاب التلقائي: تتدفق بيانات التيليمترية إلى واجهة المراقبة الخلفية لـ Agent 365 دون الحاجة إلى تكوين إضافي.
  • التوفر الفوري: تظهر بيانات إمكانية المراقبة في مركز مسؤولي Microsoft 365 في غضون دقائق من نشاط العامل.

تتيح هذه الأتمتة المراقبة المركزية وتحليل الأمان وإعداد تقارير التوافق دون جهد المطور.

ما القياسات عن بعد التي يتم التقاطها

Copilot Studio يصدر تلقائياً اثنين من الاصطلاحات الدلالية الخاصة بـ OpenTelemetry لنطاقات الذكاء الاصطناعي التوليدية.

ملاحظة

  • يتم التقاط بيانات تتبع الاستخدام فقط للجلسات المصادق عليها
  • يتم استبعاد العوامل متعددة المستأجرين من بيانات تتبع الاستخدام
  • لا يتم تسجيل الوكلاء ذات الأسماء التي يزيد طولها عن 42 حرفاً
  • يتم اقتطاع المدخلات والمخرجات الكبيرة تلقائيا في الحقول التالية:
    • رسائل الإخراج
    • مُعاملات الأداة
    • استجابة الأداة (gen_ai.event.content)
    • وصف الوكيل

استدعاء عامل

يلتقط نشاط استدعاء العامل:

  • تعريف العامل: المعرف والاسم Entra 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"
}

رسالة الإخراج

يلتقط إخراج الوكيل:

  • رسالة الإخراج: استجابة العامل للمستخدم (تم تنقيح البيانات الحساسة)

ملاحظة

يتم تسجيل رسائل الخطأ من استدعاءات العامل أو عمليات تنفيذ الأدوات كرسائل إخراج.

فيما يلي مثال آخر على الحدث.

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

تنفيذ الأداة

يلتقط تنفيذ الأداة عندما يستخدم عاملك الموصلات أو الإجراءات:

  • تعريف العامل: المعرف والاسم Entra 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