تثبيت مجموعة Copilot Agent

Copilot Agent Kit هو مجموعة أدوات مفتوحة المصدر لاختبار وتقييم وكلاء Copilot Studio. على سبيل المثال، يساعدك على تحديد حالات الاختبار ومحاكاة استعلامات المستخدم والتحقق من صحة استجابات العامل. توفر هذه المقالة تعليمات خطوة بخطوة لتثبيت المجموعة من Marketplace أو GitHub، إلى جانب خطوات ما بعد النشر وخيارات التكوين.

ملاحظة

قبل تحميل وتثبيت مجموعة Copilot Agent، تأكد من استيفاء جميع المتطلبات المسبقة.

تثبيت مجموعة Copilot Agent من Marketplace

إذا كنت تفضل تثبيت Copilot Agent Kit من GitHub، تخطى إلى تثبيت Copilot Agent Kit من GitHub.

النشر من Marketplace

لنشر Copilot Agent Kit من Marketplace، اتبع الخطوات التالية:

1. اذهب إلى مجموعة Copilot Agent في السوق.
2. حدد الحصول عليه الآن.
3. سجل الدخول إذا لزم الأمر.
4. في عرض تثبيت Copilot Agent Kit، اختر البيئة التي تريد نشر مجموعة Copilot Agent Kit.
5. راجع الشروط والعبارات. إذا وافقت، فحدد المربعات وحدد تثبيت.

يبدأ تركيب Copilot Agent Kit.

خطوات النشر اللاحقة (Marketplace)

بعد انتهاء التثبيت، اتبع خطوات ما بعد التوزيع التالية:

1. سجل الدخول إلى Power Apps.
2. انتقل إلى الحلول.
3. حدد الحل الافتراضي.
4. حدد مراجع الاتصال.
5. حدد موقع Copilot Agent Kit - Dataverse وافتحه للتحرير.
6. تأكد من تعبئة كافة الحقول المطلوبة ومن أن الاتصال المحدد صالح. إنشاء اتصال جديد ب Dataverse حسب الحاجة.
7. اختر حفظ.
8. اتبع خطوات التكوين الإضافية والاختيارية.

تثبيت مجموعة Copilot Agent من GitHub

اتبع هذه الخطوات لتثبيت Copilot Agent Kit من GitHub. إذا كنت تفضل التثبيت من Marketplace، اذهب إلى Install Copilot Agent Kit من Marketplace.

تنزيل أحدث إصدار GitHub

قم بتحميل أحدث إصدار من الحل المدار لمجموعة Power CAT Copilot Agent.

تثبيت ملف مضغوط مدار من Copilot Agent Kit

لتثبيت الحل الذي يديره Copilot Agent Kit:

1. سجل الدخول إلى Power Apps.
2. اختر البيئة التي تريد تثبيت Copilot Agent Kit.
3. انتقل إلى الحلول.
4. حدد Import Solution.
5. حدد استعراض.
6. حدد ملف _managed.zipCopilotStudioKit* .
7. حدد التالي.
8. بعد مراجعة معلومات الحل، حدد التالي.
9. إذا طلب منك ذلك، قم بإنشاء الاتصالات المطلوبة، وحدد استيراد.
10. اترك قيم تقارير مؤشرات الأداء الرئيسية للمحادثة كما هي في الوقت الحالي. يمكنك تحديث هذه القيم لاحقا.
11. انتظر حتى تنتهي عملية الاستيراد.

ترقية الحل الحالي (GitHub)

للترقية إلى أحدث إصدار من مجموعة Copilot Agent، اتبع الخطوات التالية:

1. سجل الدخول إلى Power Apps.
2. اختر البيئة التي تريد ترقية مجموعة Copilot Agent Kit.
3. انتقل إلى الحلول.
4. حدد Import Solution.
5. حدد استعراض.
6. حدد CopilotStudioKit*_managed.zip.
7. حدد التالي. يتعرف Power Apps على أن هذه الترقية هي حل مُدار مسبقًا.
8. تأكد من رغبتك في ترقية الحل الموجود عن طريق تحديد التالي.
9. اترك قيم تقارير مؤشرات الأداء الرئيسية للمحادثة كما هي في الوقت الحالي. يمكنك تحديث هذه القيم لاحقا.
10. حدد استيراد.

ملاحظة

أثناء ترقية مجموعة الوكيل Copilot، قد تواجه الخطأ التالي: فشل الاستيراد: فشل الاستيراد في حل "Power CAT Copilot Agent Kit": فشل ImportAsHolding مع استثناء: لا يمكن حذف السمة: cat_copilottestrunid من الكيان: cat_CopilotTestRun لأن السمة ليست حقلا مخصصا.

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

خطوات التكوين الإضافية والاختيارية

تنطبق هذه الخطوات سواء قمت بتثبيت مجموعة Copilot Agent Kit من Marketplace أو GitHub.

Tip

تتضمن مجموعة Copilot Agent Wizard لتكوين مراجع الاتصال، ومتغيرات البيئة، وتدفقات السحابة. تعرف أكثر على استخدام معالج الإعداد.

تكوين مزامنة SharePoint

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

توجيه الاتصال بـ SharePoint إلى موقع SharePoint المصدر. قم بتعيين عنوان URL لـ Dataverse إلى مثيل Dataverse المخصص للوكلاء المستهدفين حيث تتم مزامنة المحتوى.

يمكنك اتباع هذه الخطوات أو استخدام معالج Setup لتكوين مرجع اتصال SharePoint.

لاستخدام ميزة المزامنة SharePoint:

1. قم بتركيب مجموعة Copilot Agent Kit، كما تم وصفها سابقا في هذا المقال.
2. سجل الدخول إلى Power Apps.
3. انتقل إلى الحلول.
4. حدد الحل الافتراضي.
5. حدد مراجع الاتصال.
6. حدد مرجع اتصال Copilot Agent Kit - SharePoint وافتحه للتحرير.
7. تأكد من تعبئة كافة الحقول المطلوبة وأن الاتصال المحدد صالح. إنشاء اتصال جديد SharePoint كما هو مطلوب.
8. اختر حفظ.

مزيد من المعلومات: تعرف على كيفية تكوين الوكلاء في Copilot Agent Kit، بما في ذلك كيفية تكوين وكيل جديد لمزامنة الملفات.

تكوين جرد الوكيل

الخطوات التالية اختيارية ومطلوبة فقط إذا كنت تخطط لاستخدام ميزة Agent Inventory . يمكنك تعيين هذه القيم في أي وقت قبل استخدام الميزة.

تتحكم مراجع الاتصال في الحل في رؤية الوكلاء. على الرغم من أنه يمكنك استخدام حسابات أخرى، استخدم هذه الأذونات للحصول على رؤية كاملة.

• Copilot Agent Kit - Power Platform for Admins يجلب قائمة البيئات في المستأجر. يتطلب أذونات على مستوى مسؤول Power Platform.
• Copilot Agent Kit - يجمع Dataverse معلومات العميل من البيئات. يتطلب أذونات على مستوى مسؤول النظام لجميع البيئات.

يمكنك اتباع هذه الخطوات أو استخدام معالج الإعداد لتكوين مراجع اتصال مخزون العامل.

لاستخدام ميزة Agent Inventory:

1. قم بتركيب مجموعة Copilot Agent Kit، كما تم وصفها سابقا في هذا المقال.
2. سجل الدخول إلى Power Apps.
3. انتقل إلى الحلول.
4. حدد الحل الافتراضي.
5. حدد مراجع الاتصال.
6. حدد موقع مجموعة Copilot Agent - Power Platform for Admins وفتحها للتحرير.
7. تأكد من تعبئة كافة الحقول المطلوبة وأن الاتصال المحدد صالح.
8. اختر حفظ.
9. حدد موقع مجموعة Copilot Agent - مرجع اتصال Dataverse وافتحها للتحرير.
10. تأكد من تعبئة كافة الحقول المطلوبة وأن الاتصال المحدد صالح.
11. اختر حفظ.

تمكين التدفقات

ملاحظة

إذا كنت تخطط لاستخدام المزامنة SharePoint، تكوين مزامنة SharePoint قبل تمكين التدفقات ذات الصلة (تبدأ الأسماء بالمزامنة SharePoint).

لتمكين تدفقات السحابة المضمنة في مجموعة Copilot Agent، إما اتبع هذه الخطوات أو استخدم معالج الإعداد.

1. قم بتركيب مجموعة Copilot Agent Kit، كما تم وصفها سابقا في هذا المقال.
2. قم بتسجيل الدخول إلى Power Automate.
3. تأكد من اختيار البيئة التي تحتوي على مجموعة Copilot Agent Kit.
4. حدد الحلول.
5. اختر مجموعة عميل Copilot.
6. حدد التدفقات السحابية
7. تأكد من تمكين جميع التدفقات (الحالة = تشغيل).
8. تمكين أي تدفقات غير ممكنة بالترتيب التالي:
   1. التدفقات التي تنتهي بالحفيد.
   2. التدفقات التي تنتهي ب Child.
   3. بقية التدفقات كما هو مطلوب، بأي ترتيب.

إعداد مركز التوافق

لإعداد مركز الامتثال، اتبع الخطوات في إعداد وتكوين مركز الامتثال لمجموعة العوامل Copilot. يتطلب مركز التوافق مخزون الوكيل.

تكوين لوحة معلومات KPI للمحادثة المضمنة

اتبع هذه الخطوات فقط إذا كنت تخطط لاستخدام لوحة معلومات مؤشرات الأداء الرئيسية للمحادثة المضمنة.

أثناء الخطوات، قم بتدوين القيم التالية:

• اسم مساحة العمل
• المعرف الفريد العمومي لمساحة العمل
• اسم التقرير
• المعرف الفريد العمومي للتقرير

نشر التقرير

لنشر تقرير مؤشرات الأداء الرئيسية للمحادثة:

1. قم بتركيب مجموعة Copilot Agent Kit، كما تم وصفها سابقا في هذا المقال.

2. حمل Conversation.KPIs.zip من مستودع Power CAT Copilot Agent Kit GitHub.

3. استخراج محتويات ملف .zip.

4. افتح ملف Conversation KPIs.pbit في تطبيق سطح المكتب Power BI.

5. أدخل عنوان URL Dataverse ك عنوان URL للبيئة في مربع الحوار الذي يظهر وحدد تحميل (على سبيل المثال، org3c23948.crm.dynamics.comبدون البادئة https:// ).

   إذا لم يظهر مربع الحوار، أدخل عنوان URL للبيئة في Home>تحويل البيانات>معلمات التحرير.

6. تحديث البيانات وتسجيل الدخول كما هو مطلوب.

7. احفظ وانشر في مساحة العمل.

8. سجل ملاحظة حول اسم التقرير واسم مساحة العمل.

9. سجل الدخول إلى Power BI.

10. افتح التقرير الذي نشرته ولاحظ المعرف الفريد العمومي لمساحة العملومعرف GUID للتقرير في عنوان URL.

    إذا قمت بالنشر إلى "مساحة العمل الخاصة بي"، فإن المعرف الفريد العمومي لمساحة العمل هو 00000000-0000-0000-0000-000000000000.

11. حدد النقاط الثلاث (...) ثم عرض النموذج الدلالي.

12. افتح إعدادات الملف.

13. تحقق من عدم وجود مشاكل في بيانات اعتماد مصدر البيانات . سجل الدخول لإصلاح أي مشكلات.

14. انتقل إلى تحديث وقم بتعيين جدول التحديث.

تحديث متغير بيئة التقرير

لإعداد لوحة معلومات مؤشرات الأداء الرئيسية للمحادثة المضمنة، قم بتحديث متغير البيئة ذي الصلة بالمعرفات الصحيحة. يمكنك إما اتباع هذه الخطوات أو استخدام معالج الإعداد.

1. سجل الدخول إلى Power Apps واختر البيئة التي قمت بتثبيت Copilot Agent Kit.
2. حدد الحلول>الحل الافتراضي.
3. حدد متغيرات البيئة.
4. ابحث عن تقرير مؤشرات الأداء الرئيسية للمحادثة وحدده.
5. استبدل العناصر النائبة في القيمة الافتراضيةباسم مساحة العملومعرف GUID لمساحة العملواسم التقرير وقيم المعرف الفريد العمومي للتقرير التي لاحظتها أثناء عملية النشر.
6. اختر حفظ.

تعرف على كيفية تكوين الوكلاء في Copilot Agent Kit، بما في ذلك كيفية تكوين وكيل جديد لمؤشرات الأداء الرئيسية للمحادثة.

الوصول إلى تطبيق Copilot Agent Kit

للوصول إلى تطبيق Copilot Agent Kit:

1. سجل الدخول إلى Power Apps واختر البيئة التي قمت بتثبيت Copilot Agent Kit.
2. اذهب إلى التطبيقات.
3. ابحث عن مجموعة Power CAT Copilot Agent واخترها.
4. حدّد تشغيل.
5. (اختياري) وضع إشارة مرجعية على التطبيق.

شارك تطبيق Copilot Agent Kit

بعد التحقق من تشغيل التطبيق بنجاح، يحتاج المالك (أو مسؤول النظام الذي قام بتثبيت المجموعة) إلى مشاركة تطبيق Copilot Agent Kit مع الفريق.

1. سجل الدخول إلى Power Apps.
2. حدد تطبيقات.
3. ابحث عن "Copilot Agent Kit" وابحث عن التطبيق الذي يحتوي على رمز النوع (وليس التطبيق المعتمد على النماذج).
4. حدد النقاط الثلاث (...)، ثم حدد مشاركة بجانب اسم التطبيق.
5. ابحث عن المستخدمين أو مجموعات الأمان التي تحتاج إلى الوصول وأضفها.
6. حدد مشاركة للتأكيد.

تعرف على المزيد في مشاركة تطبيق لوحة مع مؤسستك.

الخطوة التالية

تكوين المستخدمين والفرق