مشاركة عبر

التعاون مـع الكُتَّاب والمحررين الآخرين

  • مقالة

تعاون مـع الكُتَّاب والمحررين الآخرين باستخدام التحكم في الوصول المستند إلى الدور في Azure (Azure RBAC) الموضوع على مورد QnA Maker.

إشعار

ستتوقف خدمة QnA Maker في 31 مارس 2025. يتوفر الآن إصدار أحدث من إمكانية السؤال والإجابة كجزء من Azure الذكاء الاصطناعي Language. للحصول على إمكانيات الإجابة على الأسئلة داخل خدمة اللغة، راجع الإجابة على الأسئلة. اعتبارًا من 1 أكتوبر 2022، لن تتمكن من إنشاء موارد QnA Maker جديدة. للحصول على معلومات عن ترحيل قواعد معارف صانع QnA الحالية إلى الإجابة على الأسئلة، راجع دليل الترحيل .

يتم توفير الوصول علـى مورد QnA Maker

يتم التحكم فـي جميع الأذونات بواسطة الأذونات الموضوعة على مورد QnA Maker. تتوافق هذه الأذونات مـع القراءة والكتابة والنشر والوصول الكامل. يمكنك السماح بالتعاون بين عدة مستخدمين عـن طريق تحديث الوصول إلى RBAC لمورد QnA Maker.

تتضمن ميزة التحكم في الوصول استنادًا إلى الدور في Azure هذه ما يلي:

  • معرف Microsoft Entra متوافق مع الإصدارات السابقة بنسبة 100٪ مع المصادقة المستندة إلى المفتاح للمالكين والمساهمين. يمكن للعملاء استخدام المصادقة المستندة إلى المفتاح أو المصادقة المستندة إلى التحكم في الوصول استنادًا إلى الدور في Azure طلباتهم.
  • قم بإضافة الكُتَّاب والمحررين بسرعة إلى جميع قواعد المعرفة في المورد لأن عنصر التحكم على مُستوى المورد، وليس على مُستوى قاعدة معارف.

إشعار

تأكد من إضافة مجال فرعي مُخصص للمورد. يجب أن يكون المجال الفرعي المخصص موجودًا بشكل افتراضي، ولكن إذا لم يكن كذلك، فالرجاء إضافته

يتم توفير الوصول بواسطة دور مُحدد

يتم تَوفير الأدوار التالية للتعاون:

الدور الوظائف الوصول إلى API أذونات واجهة برمجة التطبيقات
المالك الكل مفتاح المصادقة الكل
المساهم في الخدمات المعرفية الكل باستثناء القدرة على إضافة أعضاء جـدد إلى الأدوار مفتاح المصادقة الكل باستثناء القدرة على إضافة أعضاء جـدد إلى الأدوار
الخدمات المعرفية QnA Maker Reader
(اقرأ)		 تَصدير/تنزيل
اختبار		 رمز مميز للرمز المميز للحامل 1. تنزيل واجهة برمجة تطبيقات قاعدة معارف
2. قائمة قواعد المعارف لواجهة برمجة تطبيقات المُستخدم
3. الحصول على تفاصيل قاعدة المَعارف
4. تنزيل التعديلات
إنشاء إجابة
الخدمات المعرفية محرر QnA Maker Editor
(قراءة/ كتابة)		 تَصدير/تنزيل
اختبار
تحديث قاعدة المعارف
تصدير قاعدة المعارف
استيراد قاعدة المعارف
استبدال قاعدة معارف
إنشاء قاعدة معارف (KB)		 رمز مميز للرمز المميز للحامل 1. إنشاء واجهة برمجة تطبيقات قاعدة المعارف
2. تحديث واجهة برمجة تطبيقات قاعدة المعارف
3. استبدال واجهة برمجة تطبيقات قاعدة المعارف
4. استبدال التعديلات
5. "تدريب واجهة برمجة التطبيقات" [في نموذج الخدمة الجديدة بالإصدار 5]
مستخدم الخدمات المعرفية
(قراءة/كتابة/نَشر)		 الكل مفتاح المصادقة جميع الوصول إلى مورد خدمات Azure الذكاء الاصطناعي باستثناء القدرة على:
1. إضافة أعضاء جـدد إلى الأدوار.
2. إنشاء مَوارد جديدة.

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

يوضح الرسم البياني التالي التدفق، من منظور المؤلف، لتسجيل الدخول إلى بوابة QnA Maker واستخدام واجهات برمجة التطبيقات الخاصة بالتأليف.

The following diagram shows the flow, from the author's perspective, for signing into the QnA Maker portal and using the authoring APIs.

الخطوات ‏‏الوصف
1 يحصل المَدخل على رمز مميز لمورد QnA Maker.
2 يستدعي المدخل واجهة برمجة تطبيقات تأليف QnA Maker المناسبة (APIM) التي تمرر الرمز المُميز بدلًا من المفاتيح.
3 تتحقق واجهة برمجة تطبيقات QnA Maker من صحة الرمز المُميز.
4 تستدعي QnA Maker API خِدمة QnAMaker.

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

المصادقة بواسطة مَدخل QnA Maker

إذا قمت بالكتابة والتعاون باستخدام مدخل QnA Maker، بعد إضافة الدور المُناسب إلى المورد لمتعاون، فإن مَدخل QnA Maker يدير جميع أذونات الوصول.

المصادقة بواسطة واجهات بَرمجة تطبيقات QnA Maker ومجموعات SDK

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

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

  • تصميم قاعدة مَعارف للغات وتطبيقات العميل