قم بتثبيت ملحق Microsoft Copilot Studio لـ Microsoft تعليمة Visual Studio برمجية

ملحوظة

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

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

قبل تثبيت ملحق Microsoft Copilot Studio Microsoft تعليمة Visual Studio برمجية، تأكد من تلبية المتطلبات التالية:

متطلبات النظام

  • نظام التشغيل:
    • Windows (بنية x64)
      • Windows 10 الإصدار 1809 أو أحدث
      • Windows 11 (أي إصدار)
    • ماك أو إس
  • تعليمة Visual Studio برمجية: الإصدار 1.80 أو أحدث (يوصى باستخدام أحدث إصدار ثابت)
  • اتصال بالإنترنت: مطلوب للتثبيت والمصادقة

متطلبات الحساب

  • حساب Microsoft: Active حساب Microsoft مع ترخيص Copilot Studio أو حق الوصول
  • ترخيص Copilot Studio: الترخيص المناسب المعين لحسابك
  • الوصول إلى البيئة: الأذونات للوصول إلى بيئة Copilot Studio واحدة على الأقل
  • أذونات العامل: الوصول للقراءة والكتابة إلى أي وكلاء تخطط لتحريرهم

خطوات التثبيت

يمكنك تثبيت إضافة Copilot Studio في تعليمة Visual Studio برمجية بطريقتين:

  • التثبيت من داخل تعليمة Visual Studio برمجية
  • التثبيت من موقع ويب تعليمة Visual Studio برمجية Marketplace

الطريقة 1: التثبيت من تعليمة Visual Studio برمجية

  1. حدد أيقونة الملحقات في شريط النشاط أو اضغط Ctrl+Shift+Xعلى . يفتح جزء Extensions في تعليمة Visual Studio برمجية.

  2. في شريط البحث، أدخل "Copilot Studio". ابحث عن ملحق Copilot Studio الرسمي في قائمة النتائج. تحقق من أن الناشر هو "Microsoft".

  3. بمجرد العثور على الملحق الصحيح، حدده لفتح صفحة تفاصيل الملحق.

  4. حدد تثبيت لبدء التثبيت.

  5. انتظر حتى يكتمل التثبيت. قد ترى مطالبة بإعادة تحميل تعليمة Visual Studio برمجية، وفي هذه الحالة، اختر إعادة التحميل عند مطالبتك.

  6. تحقق من التثبيت. ابحث عن أيقونة Copilot Studio في شريط النشاط. تظهر الأيقونة مع العلامة التجارية Copilot Studio.

الطريقة 2: التثبيت من موقع ويب السوق تعليمة Visual Studio برمجية

  1. انتقل إلى https://marketplace.visualstudio.com/ وابحث عن "Copilot Studio". يمكنك أيضا استخدام الارتباط المباشر: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. حدد تثبيت في صفحة السوق. قد تطالبك مطالبات المستعرض بتنزيل تعليمة Visual Studio برمجية قبل أن يطلب منك فتح تعليمة Visual Studio برمجية.

  3. اسمح للمستعرض بفتح تعليمة Visual Studio برمجية وتأكيد التثبيت من خلال البحث عن أيقونة الملحق في شريط النشاط.

التكوين الأولي

التشغيل الأول

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

  2. اختر تسجيل الدخول في النافذة المنبثقة، ثم اختر السماح. يفتح المستعرض الافتراضي على صفحة مصادقة Microsoft.

  3. أدخل بيانات اعتماد المصادقة وأكمل أي مصادقة متعددة العوامل إذا لزم الأمر.

  4. راجع الأذونات المطلوبة:

    • قراءة وكتابة عوامل Copilot Studio
    • الوصول إلى معلومات البيئة
    • مزامنة الملفات إلى السحابة

    حدد قبول أو السماح. يطالبك المستعرض بأنه يمكنك إغلاق النافذة والعودة إلى تعليمة Visual Studio برمجية.

  5. عد إلى تعليمة Visual Studio برمجية. يقوم جزء الملحق بتحميل البيئات التي لديك حق الوصول إليها، والوكلاء في تلك البيئات.

التحقق من نجاح الإعداد

بعد المصادقة، ترى هيكلا تحت لوحة الوكلاء داخل امتداد Copilot Studio في تعليمة Visual Studio برمجية. ترى قائمة بمجموعات البيئة، مع بيئات ووكلاء متداخلين، مشابهة للهيكل التالي:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

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

الخطوات التالية لاستكشاف الأخطاء تعالج بعض المشكلات التي قد تحدث عند تثبيت أو تكوين إضافة Copilot Studio تعليمة Visual Studio برمجية.

لا يظهر الملحق

Problem: لا تظهر أيقونة Copilot Studio في شريط النشاط.

الحل:

  1. أعد تحميل تعليمة Visual Studio برمجية.
  2. حدد Extensions وابحث عن الملحق في القائمة Installed . تأكد من أن الإضافة غير معطلة.
  3. تحديث تعليمة Visual Studio برمجية إلى أحدث إصدار.
  4. أعد تثبيت الملحق.

حالات فشل المصادقة

المشكله: تفشل المصادقة أو تتكرر بشكل متكرر.

الحل:

  1. امسح ذاكرة التخزين المؤقت للمستعرض وملفات تعريف الارتباط ل microsoft.com.

  2. حاول تسجيل الدخول باستخدام متصفح مختلف. تعيين هذا المستعرض بشكل مؤقت كافتراضي.

  3. تعطيل ملحقات المستعرض التي قد تمنع المصادقة.

  4. تحقق من جدار حماية الشركة وإعدادات الوكيل.

  5. تأكد من استخدام نوع حساب معتمد.

لم يتم العثور على الملحق في السوق تعليمة Visual Studio برمجية

المشكلة: لا يمكنك العثور على امتداد Copilot Studio عند البحث.

الحل:

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

  2. تحقق من التهجئة: "Copilot Studio".

  3. اتصل بالمسؤول لمعرفة ما إذا كانت مؤسستك تقيد الوصول إلى السوق تعليمة Visual Studio برمجية.

قم بإلغاء تثبيت الإضافة

لإزالة الملحق:

  1. افتح جزء الملحقات.

  2. ابحث عن Copilot Studio في الملحقات المثبتة.

  3. في الإدخال في القائمة، اختر أيقونة الإدارة ، ثم اختر إلغاء التثبيت.

  4. قم بإعادة تحميل تعليمة Visual Studio برمجية عند ظهور المطالبة.

ملحوظة

لا يؤدي إلغاء تثبيت الملحق إلى حذف ملفات العامل المستنسخة محليا. تحتاج إلى إزالة هذه الملفات يدويا.

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

بعد تثبيت الملحق والمصادقة باستخدام Copilot Studio، تكون جاهزا ل:

  • Last updated on