تثبيت Copilot Studio Kit

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

ملحوظة

قبل تنزيل Copilot Studio Kit وتثبيتها، تأكد من تلبية جميع prerequisites.

تثبيت Copilot Studio Kit من Marketplace

إذا كنت تفضل تثبيت Copilot Studio Kit من GitHub، فانتقل إلى تثبيت Copilot Studio Kit من GitHub.

الْنشر مِنْ Marketplace

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

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

يبدأ تثبيت Copilot Studio Kit.

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

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

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

تثبيت Copilot Studio Kit من GitHub

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

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

قم بتنزيل أحدث إصدار من الحل المُدار لحزمة أدوات Power CAT Copilot Studio Kit.

تثبيت الملف المُدار بصيغة zip من CopilotStudioKit

لتثبيت مجموعة أدوات Copilot Studio الحل المُدار:

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

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

إذا قمت بتثبيت إصدار سابق من Copilot Studio Kit وتريد الترقية إلى أحدث إصدار، فاتبع الخطوات التالية:

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

ملحوظة

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

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

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

تنطبق خطوات التكوين هذه سواء قمت بتثبيت Copilot Studio Kit من Marketplace أو GitHub.

نصيحة

تتضمن Copilot Studio Kit معالج إعداد لتكوين مراجع الاتصال ومتغيرات البيئة وتدفقات السحابة. تعرف على المزيد حول استخدام معالج الإعداد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تمكين مقاييس الاستخدام

لتمكين مقاييس الاستخدام الاختيارية في مخزون العامل، أكمل الخطوات التالية:

1. تأكد من السماح للموصل HTTP مع المعرف Microsoft Entra ID (مُصرح به مسبقاً) في بيئتك.
2. استيراد ملف _AgentInventoryUsage*managed.zip من مستودع GitHub Power CAT Copilot Studio Kit.
3. أثناء عملية الاستيراد، قم بإنشاء اتصال باستخدام عنوان URL لمضيف الترخيص: https://licensing.powerplatform.microsoft.com/

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

ملحوظة

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

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

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

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

لإعداد Compliance Hub، اتبع الخطوات الواردة في إعداد Copilot Studio Kit Compliance Hub وتكوينه. يتطلب مركز التوافق مخزون الوكيل.

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

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

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

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

نشر التقرير

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

1. قم بتثبيت Copilot Studio Kit، الموضحة سابقا في هذه المقالة.

2. قم بتنزيل Conversation.KPIs.zip من مستودع GitHub Power CAT Copilot Studio Kit.

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 Studio Kit.
2. حدد الحلول>الحل الافتراضي.
3. حدد متغيرات البيئة.
4. ابحث عن تقرير مؤشرات الأداء الرئيسية للمحادثة وحدده.
5. استبدل العناصر النائبة في القيمة الافتراضيةباسم مساحة العملومعرف GUID لمساحة العملواسم التقرير وقيم المعرف الفريد العمومي للتقرير التي لاحظتها أثناء عملية النشر.
6. حَدِّد حِفظ.

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

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

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

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

مشاركة تطبيق Copilot Studio Kit

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

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

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

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

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