استخدم تتبع النشاط لتصحيح وكيلك

يظهر لك تتبع النشاط في الوكلاء المدعومين بواسطة حزمة GitHub Copilot في Microsoft Copilot Studio بالضبط كيف يعالج عميلك كل رسالة. استخدمه لفهم سلسلة التفكير لدى عامل ك، والتحقق من مصدر معرفي، وتأكيد تنفيذ الأدوات، واستكشاف الأخطاء.

ملحوظة

الميزات في هذا المقال مدعومة بحزام GitHub Copilot، الذي يستخدم Copilot Credits للفوترة حسب الاستخدام. تعرف على المزيد حول Copilot Credits في نظرة عامة على الفوترة للوكلاء المدعومين بحزام GitHub Copilot.

تنطبق الفوترة القائمة على الاستخدام على استخدام وبناء واختبار وتقييم الوكلاء. قد تستهلك هذه الأفعال Copilot Credits.

المتطلبات المسبقه

• وكيل تم إنشاؤه باستخدام حزام GitHub Copilot
• على الأقل محادثة اختبار واحدة في علامة التبويب إصدار أولي

فتح تتبع اللنشاط

1. في Copilot Studio، افتح عاملك ثم حدد علامة التبويب إصدار أولي.

2. تأكد من أن زر تبديل إصدار أولي المستخدم النهائي في وضع الإيقاف (وضع منشئ الافتراضي). يظهر تتبع النشاط بجانب نافذة الدردشة، ويعرض تفاصيل المعالجة لكل رسالة.

3. إرسال رسالة إلى العامل. يتم تحديث التتبع في الوقت الحقيقي أثناء معالجة عامل للرسالة.

التعرّف على تتبع النشاط

يعرض تتبع النشاط عرض سلسلة التفكير (CoT) لمعالجة عاملك. كل خطوة في التتبع تظهر كعقدة توضح ما فعله عامل ولماذا.

أنواع العقدة

يتضمن التتبع أنواع العقد التالية:

نوع العقدة	ماذا يظهر
رسالة المستخدم	الرسالة التي أرسلتها للعامل
رد العامل	الرد الذي يولدّه العامل
المعرفة	مصدر معرفة استشارها العامل للتأسيس. يتم عرضها كبطاقة قابلة للطي بعنوان "مصدر معرفي تم البحث عنه"، وتُظهر مصادر معرفية تم الوصول إليها وروابط الاستشهاد عند توفرها.
تشغيل الإجراء	استدعاء الموصل أو الأداة يُعرض كبطاقة قابلة للطي تظهر فيها معلومات الموصل، معاملات الإدخال المكتملة، ومدة التنفيذ.
Tool	أداة استدعاها عامل لتنفيذ إجراء أو استرجاع بيانات
موصل	موصل استخدمه عامل للوصول إلى بيانات خارجية
سير مهام	تدفق عامل تم تفعيله
مهارة	مهارة تم تنفيذها
الخطأ	خطأ حدث أثناء المعالجة
Complete	علامة صح خضراء تظهر في أسفل التتبع عند اكتمال جميع استدعاءات الأدوات

عرض تفاصيل العقدة

1. اختر أي عقدة في التتبع لتوسيع تفاصيلها.

2. راجع المعلومات المعروضة، والتي يمكن أن تشمل:

   • المدخل الذي أرسله العامل إلى الخطوة
   • المخرج أو النتيجة التي تم إرجاعها
   • وقت المعالجة والمقاييس
   • تفاصيل الخطأ إذا فشلت الخطوة

تصحيح أخطاء مشاكل مصادر المعرفة

عندما يستخدم عامل المعرفة للإجابة على سؤال، يُظهر التتبع المصادر التي تم الرجوع إليها:

1. ابحث عن عقدة المعرفة في التتبع.

2. راجع المصدر لمعرفة المصادر المعرفية التي تم الوصول إليها.

3. اختر المصدر للاطلاع على المحتوى الذي تم استرجاعه.

4. تحقق من أن عامل استخدم المصدر الصحيح وأن المحتوى المسترجع ذو صلة.

إذا استخدم عامل مصدراً غير صحيح أو قدم معلومات غير دقيقة، راجع إعدادات المعرفة في تبويب البناء.

تنفيذ أداة التصحيح

عندما يستدعي عاملك أداة، يظهر التتبع تفاصيل التنفيذ:

1. ابحث عن عقدة الأداة، أو عقدة الموصل، أو عقدة التدفق، أو عقدة المهارة في التتبع.

2. راجع تفاصيل التنفيذ، بما في ذلك معلمات الإدخال ونتائج الإخراج.

3. تحقق من أن الأداة الصحيحة تم استدعاؤها وأن النتائج كما هو متوقع.

4. إذا فشل تنفيذ الأداة، راجع تفاصيل الخطأ في العقدة.

لإعادة تكوين الأداة، افتح علامة التبويب Build وحدد موقع الأداة في تكوين عاملِك.

استكشاف الأخطاء وإصلاحها

عندما تحدث أخطاء أثناء المعالجة، يبرزها التتبع.

1. ابحث عن العقد التي يظهر عليها مؤشر الخطأ في التتبع.

2. اختر عقدة الخطأ لعرض تفاصيل الخطأ، بما في ذلك رسالة الخطأ والسياق.

3. تتضمن المشكلات الشائعة:

   • فشل المصادقة للأدوات أو الموصلات
   • أخطاء الوصول إلى المصدر المعرفي
   • أخطاء المهلة لاستدعاءات الأدوات طويلة التشغيل
   • علامات إشراف عَلى المحتوى

4. عالج السبب الجذري في تبويب البناء أو الإعدادات، ثم أعد الاختبار.

انتقل من التتبع إلى تبويب البناء.

يتكامل تتبع النشاط مع تبويب البناء للتحرير السريع.

1. اختر أي مصدر أو أداة أو مكون في التتبع.

2. ينتقل Copilot Studio إلى المكون المقابل في تبويب البناء.

3. قم بإجراء التغييرات وارجع إلى تبويب المعاينة لإعادة الاختبار.

المعلومات ذات الصلة

• معاينة واختبار الوكيل
• اختبر وكيل
• شارك وكيلك مع الآخرين
• إدارة محادثات المعاينة
• مراقبة عامل