استنساخ عامل Microsoft Copilot Studio في Microsoft تعليمة Visual Studio برمجية

ملحوظة

تصف هذه المقالة الميزات المستخدمة في الوكلاء أو تدفقات الوكلاء التي تعمل بواسطة الحزام القياسي.

عند استنساخ عامل من Microsoft Copilot Studio باستخدام الملحق، يمكنك تنزيل تعريف العامل وتعريفات المكونات ذات الصلة من Copilot Studio إلى جهازك المحلي. يمكنك تحرير هذه الملفات باستخدام Microsoft تعليمة Visual Studio برمجية. تنشئ عملية النسخ مساحة عمل محلية مع كافة ملفات العامل بتنسيق دليل منظم.

المتطلبات الأساسية

قبل البدء في استنساخ العوامل، هناك بعض المتطلبات الأساسية والاعتبارات الهامة.

اختيار موقع مساحة عمل

حدد مجلدا محليا مناسبا لملفات الوكيل. هذا الموقع هو المكان الذي يحفظ فيه الملحق ملفات العامل. فيما يلي بعض النصائح المهمة لاختيار موقع:

• تأكد من وجود مساحة كافية على القرص. يمكن أن يتراوح العامل النموذجي في الحجم اعتمادا على عدد المكونات.
• إذا أمكن، استخدم مسارًا بدون مسافات، على الرغم من أن المسافات مدعومة.
• ضع في اعتبارك استخدام موقع تم تعقبه بالفعل بواسطة Git.

فهم ما يتم استنساخه

عند استنساخ عامل، يتم نسخ ملفات العامل محليا في الموقع الذي تختاره، مما يؤدي إلى إنشاء تعريف بنية كما يلي في تعليمة Visual Studio برمجية Explorer:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

أساليب الاستنساخ

إذا كنت تستخدم الملحق للمرة الأولى، أو حتى جديدا على تعليمة Visual Studio برمجية، فإن أسهل طريقة لاستنساخ عامل هي تحديد Clone Agent عند فتح جزء Extension. ومع ذلك، لا يتوفر هذا الخيار عندما يكون لديك بالفعل عامل مستنسخ ومفتوح محليا. يمكن استخدام الأساليب التالية بدلا من ذلك:

الطريقة الأولى: استنساخ من جزء الوكلاء (موصى به)

هذه هي الطريقة الأكثر وضوحا والموصى بها لاستنساخ عامل.

1. افتح ملحق Copilot Studio عن طريق تحديد أيقونة Copilot Studio في شريط النشاط. يمكنك أيضا الضغط على Ctrl+Shift+P وإدخال "Copilot Studio: التركيز على طريقة عرض العوامل". يتم فتح جزء Copilot Studio في الشريط الجانبي.

2. في جزء Agents ، حدد البيئة المستهدفة من القائمة المنسدلة (على سبيل المثال، "Environment 1") لمشاهدة قائمة بالوكلاء في البيئة.

   > Environment 1
     Environment 2
     Environment 3
   

3. حدد العامل الذي تريد نسخه من القائمة. يعرض الوكلاء تاريخ التعديل الأخير. انقر بزر الماوس الأيمن فوق اسم العامل وحدد Clone agent.

   > Customer Support Agent
       HR Assistant
       Sales Agent
       IT Helpdesk Agent
   

   يتم فتح مربع حوار أداة انتقاء الملفات.

4. انتقل إلى الموقع الذي تريده في مربع حوار أداة انتقاء الملفات أو أنشئ مجلدا جديدا وحدد تحديد مجلد. تبدأ عملية الاستنساخ.

5. انتظر حتى تكتمل عملية الاستنساخ. يظهر إعلام تقدم يعرض "عامل الاستنساخ: روبوت دعم العملاء"، متبوعا برسالة نجاح "تم استنساخ العامل بنجاح". تستغرق هذه العملية عادة من 10 إلى 30 ثانية.

6. تحقق من اكتمال الاستنساخ بنجاح. يفتح مجلد العامل في مستكشف تعليمة Visual Studio برمجية، ويعرض جزء التحكم بالمصادر شجرة عمل نظيفة، وتعرض نافذة الملف اسم المجلد الخاص بك.

الطريقة 3: استنساخ باستخدام لوحة الأوامر

استخدم هذا الأسلوب إذا كنت تفضل مهام سير العمل التي تركز على لوحة المفاتيح.

1. افتح لوحة الأوامر بالضغط على Ctrl+Shift+P.

2. اكتب "Copilot Studio: Clone Agent" واضغط على Enter. يتم تنفيذ الأمر وتظهر الإشعارات.

3. اتبع المطالبات لتحديد بيئتك، وحدد العامل، واختر المجلد الوجهة، وانتظر حتى يكتمل الاستنساخ. يتم نسخ العامل إلى موقعك المحدد.

الطريقة 3: استنساخ باستخدام عنوان URL للعامل

هذه الطريقة مفيدة عندما يشارك شخص ما عنوان URL للوكيل معك.

1. افتح وكيلك في مدخل ويب Copilot Studio.

2. حدد Settings>Agent details، وانسخ عنوان URL للعامل. يجب أن يكون عنوان URL بالتنسيق: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. عنوان URL موجود الآن في الحافظة.

3. ارجع إلى تعليمة Visual Studio برمجية وافتح ملحق Copilot Studio.

4. حدد Clone agent. يكتشف الملحق عنوان URL في الحافظة ويعرض العامل الذي تم وضع علامة عليه على أنه "(من الحافظة)."

5. حدد الوكيل الذي تم وضع علامة "(من الحافظة)" عليه، ثم حدد مجلد الوجهة، وانتظر حتى يكتمل الاستنساخ. يتم نسخ العامل إلى موقعك المحدد.

سيناريوهات الاستنساخ الشائعة

فيما يلي بعض السيناريوهات الشائعة عندما يكون استنساخ العوامل مفيدا، مع تفاصيل عالية المستوى حول سير العمل المقترح.

السيناريو 1: استنساخ للتطوير المنفرد

الهدف: العمل على وكيل بنفسك

1. استنساخ العامل إلى مجلد محلي.

2. تهيئة مستودع Git من خلال التحكم في المصدر في الواجهة.

3. قم بإجراء التغييرات محليا.

4. قم بإجراء التثبيتات الخاصة بك.

5. تطبيق التغييرات على Copilot Studio عندما تكون جاهزة.

السيناريو 2: استنساخ لتعاون الفريق

الهدف: العديد من المطورين الذين يعملون على نفس العامل

1. المطور الأول ينسخ العامل.

2. يقوم المطور الأول بتهيئة Git ودفع المحتوى إلى مستودع مشترك (GitHub، Azure DevOps).

3. ينسخ المطورون الآخرون من مستودع Git المشترك.

4. يقوم كل مطوّر بتشغيل Copilot Studio: إعادة إرفاق الوكيل لتوصيل مجلده المحلي بـ Copilot Studio.

5. يستخدم الفريق Git للتعاون وتتبع التغييرات، ويستخدم ملحق تعليمة Visual Studio برمجية للعمل على العامل.

6. ثم يطبق كل مطور التغييرات على Copilot Studio للاختبار أو يدفع إلى بيئة أخرى في سير العمل بناءً على دورة حياة تطوير البرمجيات أو أنظمة خطوط النقل الآلية.

السيناريو 3: استنساخ بيئات متعددة

الهدف: إدارة إصدارات التطوير والاختبار والإنتاج

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

1. استنساخ العامل من بيئة التطوير إلى مجلد تطوير محلي.

2. قم بإجراء تغييرات في مجلد التطوير.

3. طبق هذه التغييرات واختبر التغييرات في نفس البيئة.

4. استخدم Copilot Studio: Reattach Agent لتوصيل العامل بالبيئة البديلة.

5. اختبر العامل في جزء اختبار Copilot Studio.

أفضل الممارسات

افعل

• استنساخ جميع العوامل إلى موقع متناسق.
• تهيئة نظام Git مباشرة بعد الاستنساخ.
• استخدم اسم مجلد ذي معنى.
• تحقق من عمل النسخة قبل إجراء التغييرات.
• احتفظ بموقع النسخ الاحتياطي (على سبيل المثال، في GitHub أو Azure DevOps).
• قم بتوثيق موقع النسخة المستنسخة في ويكي الفريق الداخلي أو مستنداته.

لا

• لا تستنسخ إلى الأدلة المؤقتة.
• لا تنسخ عدة مرات إلى مواقع مختلفة. ويمكن أن يؤدي القيام بذلك إلى حدوث ارتباك.

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

بعد استنساخ وكيلك:

• تعلم كيفية تحرير مكونات العامل.
• فهم المزامنة.