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

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

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

ملاحظة

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

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

يشارك عاملو Copilot Studio تلقائيًا في إطار عمل مراقبة Agent 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