تكامل قابلية الرصد مع 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:

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

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

ما البيانات التليمترية التي يتم جمعها؟

يقوم Copilot Studio تلقائيًا بإصدار اتفاقيتين دلاليتين لنظام OpenTelemetry لعمليات الذكاء الاصطناعي التوليدي:

إشعار

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

استدعاء العامل

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

  • تعريف عامل: المعرف، الاسم، معرف إنترا، ونوع عامل:
  • تحديد هوية المستخدم: من تفاعل مع العامل (عند استخدام تدفق نيابة عن)
  • رسالة المستخدم: الرسالة التي أرسلها المستخدم إلى عامل (تم تنقيح بيانات حساسة)
  • معرفات أخرى: معرف المستأجر ومعرف البيئة:
  • طوابع زمنية للبداية والنهاية: وقت بدء وانتهاء الاستدعاء

حدث مثال

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

تنفيذ الأداة

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

  • تعريف عامل: المعرف، الاسم، معرف إنترا، ونوع عامل:
  • تحديد الأداة: معرف واسم الأداة التي تم تنفيذها:
  • معاملات الأداة: ما هي البيانات التي تم إرسالها (تم تنقيح البيانات الحساسة)
  • تحديد هوية المستخدم: من تفاعل مع العامل (عند استخدام تدفق نيابة عن)
  • معرفات أخرى: معرف المستأجر ومعرف البيئة:
  • طوابع زمنية للبداية والنهاية: وقت بدء وانتهاء التنفيذ

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

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