تكوين الاتصالات وإدارتها

يستخدم الوكلاء الأدوات والمعرفة لتنفيذ الإجراءات نيابة عن ٱلْمُسْتَخْدَمُين وجمع المعلومات السياقية ذات الصلة. غالبا ما يخزن المطورون هذه الأدوات ومصادر المعرفة في أنظمة خارجية، مثل Microsoft Dataverse أو Microsoft SharePoint أو واجهات برمجة التطبيقات الأخرى. للوصول إلى هذه الموارد بشكل آمن، يحتاج الوكلاء إلى المصادقة لإنشاء اتصالات بينهم وبين النظام الخارجي. يمكن للعامل استخدام إما مصادقة كاتب العامل أو مصادقة المستخدم، اعتمادا على السيناريو.

في Microsoft Copilot Studio، يمكنك استخدام الاتصالات للوصول بأمان إلى الخدمات المصادق عليها للأدوات والمعرفة. يمكنك إنشاء اتصالات بمصادر بيانات مختلفة، مثل Microsoft Dataverse أو Microsoft SharePoint أو واجهات برمجة ٱلتَّطْبِيقَاتُ الخارجية.

عرض وإدارة اتصالات الوكلاء

في Copilot Studio، يمكنك عرض وتكوين الاتصالات التي يستخدمها الوكيل على صفحة إعدادات الاتصال.

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

عرض الاتصالات فِي صفحة إعدادات الاتصال

1. انتقل إلى صفحة العامل في Copilot Studio عن طريق تحديد Agents ثم تحديد العامل الذي تريد عرضه.

   تفتح صفحة نظرة عامة عَلَى العامِل.

2. حدد ٱلْإِعْدَادَاتُ لفتح صفحة إعدادات ٱلْعَامِلُ.

3. حدد إعدادات الاتصال.

يتم عرض قائمة في جدول مع كافة الاتصالات المقترنة بوكيلك. لكل اتصال، يمكنك عرض:

• اسم الاتصال
• الأدوات ومصادر المعرفة باستخدام الاتصال
• حالة الاتصال

تعريفات حالة الاتصال

تشير حالة الاتصال إلى الحالة الحالية للاتصال. توجد العديد من الحالات المحتملة:

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

تصفية الاتصالات

إذا كان لديك العديد من الاتصالات على الوكيل، قم بتصفية القائمة للعثور على الاتصال الذي تريد التعامل معه. يمكنك تطبيق فلاتر مختلفة لعرض الاتصالات بناءً عَلَى حالتها، مثل: منشط/غير منشط, متصل/غير متصل, غير منشط, منتهيأوخطأ اتصال.

تحديد اتصال فردي أو إنشائه

1. ضمن حالة إدخال الاتصال في القائمة، حدد الارتباط التشعبي الموجود بجانب الحالة لفتح جزء إنشاء أو اختيار اتصال .

2. حدد ... لفتح تكوين الاتصال .

3. حدد اتصالا موجودا من القائمة أو حدد إضافة اتصال جديد لإنشاء اتصال جديد.

   إذا حددت إضافة اتصال جديد، يتم فتح جزء إعداد اتصال. حسب الحاجة، قد تتم مطالبتك بتسجيل الدخول إلى الخدمة أو توفير معلومات إضافية لإكمال إعداد الاتصال.

4. عند الانتهاء حدد ارساللحفظ التغييرات.

   تم تكوين الاتصال الآن وربطه بوكيلك، ويمكن للوكيل استخدام الاتصال للوصول إلى الأدوات والمعرفة.

عرض التفاصيل وتكوين معلمات الاتصال

ضمن إدارة لإدخال الاتصال فِي القائمة، حدد عرض التفاصيل لعرض مزيد مِنْ التفاصيل حول الاتصال.

تظهر المعلومات فِي علامة تبويب:

• التفاصيل: يعرض اسم الاتصال والوصف والحالة وتفاصيل الإنشاء.
• معلمات الاتصال: يعرض معلمات الاتصال، مثل تفاصيل المصادقة أو مفاتيح واجهة برمجة ٱلتَّطْبِيقَاتُ أو غيرها مِنْ المعلومات المطلوبة ويسمح لك بتكوين التفاصيل.

مشاركة معلمات الاتصال لمصادقة On-Behalf-Of (OBO)

بالنسبة لبعض الاتصالات التي تدعم تسجيل الدخول الأحادي (SSO)، يمكنك تعيين الاتصال لاستخدام مصادقة نيابة عن (OBO). في تدفق OBO، يقوم المستخدم بتفويض العامل لاستخدام معلمات الاتصال المشتركة مع الخدمة نيابة عنه. يعد أسلوب المصادقة هذا مفيدا عندما يحتاج العامل إلى الوصول إلى الموارد التي تتطلب أذونات خاصة بالمستخدم أو عندما تحتاج الإجراءات إلى تنفيذ في سياق هوية المستخدم.

تمكين المشاركة البارامترية لنظام OBO

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

1. ضمن معلمات الاتصال، قُمْ بتفعيل السماح بمشاركة المعلمات.

   

2. حدد خانات الاختيار للمعلمات التي تريد السماح للمستخدم بمشاركتها.

   تتم مطالبة ٱلْمُسْتَخْدَمُ بمنح إذن لهذه المعلمات عندما يستخدم ٱلْعَامِلُ مصادقة OBO.

تجربة ٱلْمُسْتَخْدَمُ لمصادقة OBO

عندما يستخدم ٱلْعَامِلُ مصادقة OBO، تتم مطالبة ٱلْمُسْتَخْدَمُ بمنح إذن للعامل لاستخدام معلمات الاتصال الخاصة به. يمكن للمستخدم اختيار السماح بهذا الإذن أو رفضه. إذا كان ٱلْمُسْتَخْدَمُ يسمح بذلك، يمكن للعامل الوصول إلى الموارد وتنفيذ الإجراءات نيابة عن ٱلْمُسْتَخْدَمُ. يتصل ٱلْعَامِلُ بالخدمة بشفافية باستخدام معلمات الاتصال المشتركة.

مطالبات الاتصال المتكررة عند استخدام OAuth 2.0 مع أدوات Microsoft Graph API

عند استخدام مصادقة OAuth 2.0 ، يجب على كل مستخدم تسجيل الدخول ومنح الموافقة. عند مشاركة العامل أو استضافته، لم يوافق المستخدمون الآخرون بعد، لذلك يرون بطاقة الاتصال .

لتجنب المطالبات المتكررة، يمكنك تجربة أحد الخيارات التالية للمصادقة:

• تمكين تسجيل الدخول الأحادي (SSO) إلى Teams باستخدام تدفق نيابة عن (OBO): يقوم المستخدمون بتسجيل الدخول مرة واحدة في Teams. لا يلزم الحصول على موافقة إضافية في الدردشة.

• استخدام أذونات التطبيق (كيان الخدمة): تقوم الواجهة الخلفية بإجراء استدعاءات إلى Microsoft Graph باستخدام بيانات اعتماد التطبيق. لا يلزم الحصول على موافقة المستخدم.

• استخدام OAuth SSO العام للوكلاء المستضافين على الويب: يعالج تطبيقك تسجيل الدخول ويمرر الرمز المميز إلى العامل.

• منح موافقة المسؤول للنطاقات المفوضة: يزيل مطالبات الإذن لكل مستخدم. لا يزال تسجيل الدخول الأولي مطلوبا.

ملحوظة

• إذا كانت مكالماتك تتطلب بيانات خاصة بمستخدم، فاستخدم SSO.
• إذا كانت الاستدعاءات على مستوى المستأجر، فاستخدم أذونات التطبيق.

المحتوى ذو الصلة

• قُمْ بتكوين مصادقة OBO للمُوَصِّلٌات المخصصة