إضافة SharePoint كمصدر معرفي

يمكنك استخدام SharePoint كمصدر معارف عن طريق إقران وكيلك بعنوان URL SharePoint أو قوائم SharePoint. تتناول هذه المقالة وظيفة التكامل SharePoint الكاملة المتوفرة عن طريق تحديد الخيار SharePoint في مربع الحوار إضافة المعرفة.

ملاحظة

• في مربع الحوار إضافة معرفة، يظهر خياران SharePoint. يتم استخدام خيار SharePoint في قسم تحميل الملفات لتحميل ملفات أو مجلدات SharePoint فردية، كما أنه يتيح قدرات مزامنة الملفات. تتناول هذه المقالة خيار SharePoint الذي يوفر الدعم الكامل SharePoint في Copilot Studio.

• للحصول على قائمة بالحدود ووظائف SharePoint المدعومة، راجع SharePoint حدود تطبيق الويب.

• لإضافة ملفات أو مجلدات SharePoint فردية، راجع إضافة ملفات ومجلدات SharePoint.

عند استخدام SharePoint كمصدر معارف، لا تتضمن نسخ المحادثة محتوى المستندات المصدر المستخدمة لإنشاء الاستجابة search_results (الحقل). لا يزال السؤال والإجابة مضمنين.

• بالنسبة للوكلاء المستندين إلى مصادر المعرفة SharePoint، يوفر Turn on Work IQ جودة أفضل لاسترداد المعرفة والاستجابة. تستخدم هذه الميزة أدوات استرداد داخلية متطورة، والتي تسمح للعامل بالحصول على حجم أكبر من السياق، بدقة أكبر. ومع ذلك، نظرا لزيادة تعقيد النظام، قد يواجه بعض المستخدمين والاستعلامات زيادة صغيرة في زمن الانتقال.

عند نشر وكيلك، يتم إجراء المكالمات التي تستخدم إجابات إنشاءية نيابة عن المستخدم الذي يتحدث مع العامل. يستخدم العامل إعدادات المصادقة التي تقوم بتكوينها. بشكل افتراضي، يتم تكوين الوكلاء الذين تم إنشاؤهم في Copilot Studio وفي Microsoft Teams باستخدام خيار المصادقة مع المصادقة Microsoft. يعمل هذا الخيار في بيئات مثل Microsoft Teams Power Apps Microsoft 365 Copilot.

ملاحظة

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

إذا كنت ترغب فِي اِسْتِخْدام المصادقة اليدوية لعاملك، فشاهد سيناريوهات المصادقة المتقدمة.

إضافة مواقع SharePoint كمصدر للمعرفة

عندما يطرح الْمُسْتَخْدِم سؤالا ولا يكون لدى الْعامِلُ موضوع لاِسْتِخْدامه للإجابة، يبحث الْعامِلُ فِي عنوان URL وجميع الصفحات الفرعية. على سبيل المثال، يتضمن عنوان URL مثل contoso.sharepoint.com/sites أيضا ممرات فرعية مثل contoso.sharepoint.com/sites/policies. تلخص الإجابات التوليدية هذا المحتوى فِي استجابة مستهدفة.

لإضافة موقع SharePoint كمصدر معارف، أكمل الخطوات التالية:

1. افْتَحِ الْوَكِيلَ.

2. حدد إضافة معلومات من صفحتي الملخص أو المعرفة أو خصائص أو عقدة الإجابات المولِّدة.

3. في قسم Featured ، حدد SharePoint.

   

4. أدخل عنوان URL SharePoint. افصل عناوين URL متعددة باستخدام فواصل الأسطر اليدوية (استخدم مفتاح Shift + Enter). لاستخدام متغير بدلا من عنوان URL ثابت، حدد أيقونة منتقي المتغيرات بجوار حقل URL واختر متغير مخصص أو نظام أو بيئة.

5. أضف اسمًا ووصفًا. قدم وصفاً مفصلاً، خاصةً إذا تم تمكين الذكاء الاصطناعي التوليدي، حيث يساعد الوصف على تنسيق العمليات التوليدية.

6. حدد Add to agent لإنهاء إضافة مصدر المعرفة.

تحديث الارتباط المصدر إذا تمت إعادة تسمية الموقع أو المجلد SharePoint

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

لاستعادة الوصول:

1. اطلب من مسؤول SharePoint منح الأذونات المناسبة على الموقع الذي تمت إعادة تسميته وإنشاء ارتباط مصدر جديد.

2. افتح العامل وحدث مصدر المعرفة SharePoint مع الارتباط الذي تم إنشاؤه حديثا.

إضافة قوائم SharePoint كمصدر للمعرفة

تعد قوائم SharePoint طريقة شائعة لتخزين البيانات الجدولية وتوفير وصول سريع وسهل إلى المعلومات. يمكن لعاملك اِسْتِخْدام هذه القوائم كمصدر معارف. عند إضافة SharePoint list كمصدر معارف، يمكنك إنشاء اتصال في الوقت الحقيقي بالمصدر، بحيث يتم استخدام أحدث البيانات للاستعلامات والاستدلال. تتم مصادقة المستخدمين باستخدام بيانات اعتماد SharePoint الخاصة بهم، ما يضمن حصولهم على إذن للوصول إلى البيانات قبل أن يقدم وكيلك استجابة.

1. افْتَحِ الْوَكِيلَ.

2. حدد إضافة معلومات من صفحتي الملخص أو المعرفة أو خصائص أو عقدة الإجابات المولِّدة.

3. في القسم Featured أو قسم Upload file، حدد SharePoint.

   

4. حدد استعراض العناصر للعثور على القَائِمَة المطلوبة، أو أدخل عنوان URL لقَائِمَة SharePoint معينة.

   

5. عند تحديد استعراض العناصر، يتم ملء مربع الحوار تلقائيا بالقوائم والقوائمالأخيرة. تعرض القوائم فقط القوائم التي تم إنشاؤها فِي تطبيق قوائم SharePoint. تظهر كافة القوائم الأخرى فِي القوائم الأخيرة. إذا لم تتمكن من رؤية قَائِمَة تحتاج إليها، فافتح SharePoint وقم بالوصول إلى القَائِمَة، ثم تظهر القَائِمَة فِي القوائم الأخيرة.

   

   يمكنك تحديد ما يصل إلى 10 قوائم في كل مرة. للحصول على أفضل النتائج، استخدم ما يصل إلى 10 قوائم فقط لكل عامل. تؤثر القوائم التي تحتوي على أكثر من 35000 صف على الجودة وزمن الانتقال.

   تتم إضافة كل قَائِمَة إلى مصادر معارف الْعامِلُ كعناصر فردية. لإضافة المزيد من القوائم إلى الْعامِلُ، استخدم هذه الخطوات مرة أخرى وحدد المزيد من القوائم.

   ملاحظة

   إذا كنت تريد استخدام قائمة SharePoint مع وصول مشترك ولكنها لم تظهر في القوائم الحديثة، فالصق عنوان URL للقائمة في حقل تحديد URL.

6. بعد تحديد القوائم المطلوبة، حدد تأكيد التحديد.

7. أضف اسمًا ووصفًا. قدم وصفاً مفصلاً، خاصةً إذا تم تمكين الذكاء الاصطناعي التوليدي، حيث يساعد الوصف على تنسيق العمليات التوليدية.

8. حدد Add to agent لإنهاء إضافة مصدر المعرفة.

سيناريوهات المصادقة المتقدمة

بشكل افتراضي، يقوم Copilot Studio بتكوين العوامل مسبقا لمصادقة الْمُسْتَخْدِمين باِسْتِخْدام مصادقة Microsoft للوصول إلى مصادر SharePoint عند الاتصال بعامل من خلال Microsoft Teams أو Power Apps أو Microsoft 365 Copilot. ومع ذلك، إذا كنت بحاجة إلى تكوين المصادقة يدويا، فإن الخطوات التالية مطلوبة للإجابات التوليدية للعمل مَعَ مصادر بيانات SharePoint.

مهم

إذا تم تمكين البحث المقيد في SharePoint، يتم حظر اِسْتِخْدام SharePoint.

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

• لمصادقة عاملك، راجع المصادقة.

• للحصول على إرشادات حول كيفية إنشاء تسجيل تطبيق معرف Microsoft Entra المطلوب، راجع تكوين مصادقة الْمُسْتَخْدِم باِسْتِخْدام معرف Microsoft Entra. عند إنشاء هذا التسجيل، يجب عليك أنت أو المسؤول تحديد Sites.Read.All النطاقين و Files.Read.All فِي تسجيل تطبيق Microsoft Entra ID.

• تحديد لا توجد مصادقة يحدد أن الْعامِلُ لا يسترد المعلومات من SharePoint.

• عند تكوين المصادقة، تتحكم النطاقات في صلاحية وصول المستخدم. حدد Sites.Read.All و Files.Read.All فِي حقل النطاقات بالقرب من القيم الموجودة profile و openid فِي Copilot Studio. لا تمنح هذه النطاقات الْمُسْتَخْدِمين أذونات متزايدة عند اِسْتِخْدام الْعامِلُ، ولكنها تسمح بالمحتوى المسموح به من موقع SharePoint كما تم تكوينه للإجابات التوليدية.

• يدعم SharePoint إعداد المصادقة يدويًّا مَعَ موفِّري خدمات المصادقة التالية:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 مَعَ بيانات اعتماد موحدة
  • معرف Microsoft Entra ID الإصدار الثاني مَعَ الشهادات
  • Microsoft Entra ID V2 مَعَ أسرار العميل

• لا يدعم SharePoint المصادقة اليدوية باستخدام OAuth العام.

• ينطبق هذا التكوين فقط على الإجابات التوليدية، ولا ينطبق على مُوصِّلات Power Platform.

تصفية مصدر SharePoint

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

السمة	المُشغِّل	قيمة
Modified on	on or after	X date

إنشاء شروط التصفية

بعد إضافة مصدر معارف SharePoint، قم بتعيين شروط البحث.

1. في صفحة المعرفة ، حدد مصدر SharePoint.

2. حدد النقاط الثلاث (... ) لمصدر SharePoint وحدد Edit.

3. حدد الإعدادات المتقدمة.

4. أنشئ عوامل التصفية لتضمين المعلومات أو استبعادها من مصدر معارف SharePoint. قم بإسناد عامل التصفية إلى أحد التحديدات التالية:

   • العنوان‬
   • الكاتب
   • تعديل بواسطة
   • تاريخ التعديل

5. تعيين قيمة الشرط إلى إحدى القيم التالية:

   • قيمة ثابتة
   • إدخال متغير يوفره الْمُسْتَخْدِم أثناء المحادثة مَعَ الْعامِلُ، والذي يتم حفظه بعد ذلك كمتغير عمومي مخصص
   • متغير نِظَامٌ

6. حدد حفظ عند الانتهاء من تكوين عوامل التصفية.

المزيد من الإعدادات لتحسين البحث

لتصفية مصدر SharePoint، قم بإيقاف تشغيل الإعدادات التالية:

• بحث الويب
• على مستوى الوَكيل، في إعدادات استخدام المعرفة العامة، ضمن إعدادات الذكاء الاصطناعي التوليدي الوَكيل
• على مستوى الموضوع، إعداد السماح للذكاء الاصطناعي باستخدام المعرفة العامة الخاصة به (معاينة) في عقدة الإجابات التوليدية

عند إيقاف تشغيل هذه الإعدادات، يستجيب العامل ب "لا استجابة" إذا لم يتمكن من العثور على نتيجة في مصدر المعرفة SharePoint المصفاة.

استخدام المتغيرات كعناوين URL

استخدم المتغيرات في موقع ويب العام أو SharePoint عناوين URL لمصدر المعرفة للتحكم ديناميكيا في نطاق المحتوى الذي يستخدمه وكيلك.

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

دعم المتغير

عند إضافة موقع ويب عام أو SharePoint عنوان URL لمصدر المعرفة أو تحريره، يمكنك إدراج متغير في حقل URL.

استخدم متغيرا من أجل:

• إلحاق مسار بعنوان URL أساسي

  https://www.contoso.com/{variable}

• استبدال عنوان URL بأكمله

  {variable}

في وقت التشغيل، يحل المتغير إلى قيمة سلسلة. يتم تحديد نطاق مصدر المعرفة لعنوان URL المحلول.

ملاحظة

استخدام متغير يغير عنوان URL المستخدم للربط. لا يغير متطلبات بنية عنوان URL أو قيود العمق لمواقع الويب العامة.

إنشاء متغير وتعيينه

لاستخدام متغير في موقع ويب عام أو SharePoint مصدر المعرفة:

1. إنشاء متغير سلسلة مع النطاق العمومي .

2. تعيين قيمة المتغير باستخدام أحد الخيارات التالية:

   • إدخالات الموضوع
   • خصائص ملف تعريف المستخدم، مثل اللغة
   • متغيرات البيئة
   • تدفقات العامل أو الموصلات

3. إدراج المتغير في حقل URL عن طريق تحديد {x} (إدراج متغير).

4. اختبر العامل لتأكيد حل المتغير إلى عنوان URL المتوقع.

مثال: النطاق حسب المنتج

يمكنك تحديد نطاق المعرفة إلى مناطق منتجات مختلفة استنادا إلى استعلام المستخدم.

1. استخدم إدخال موضوع لالتقاط اسم المنتج كمتغير يسمى Product.

2. أضف عقدة تعيين قيمة متغير بعد عقدة المشغل ، وأنشئ متغيرا جديدا باسم ProductTable.

3. استخدم صيغة Power Fx لتعريف وتعيين أسماء المنتجات إلى مسارات URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. أضف عقدة قيمة متغيرة أخرى واستخدمها لإنشاء متغير عمومي لنوع سلسلة جديد يسمى GlobalProductURL.

5. في إعداد إلى قيمة ، حدد صيغة واستخدم دالة Power Fx لإجراء بحث في الجدول استنادا إلى قيمة Product متغير الإدخال، ، Topic.Productكما يلي:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. استخدم المتغير في عنوان URL لمصدر المعرفة:

   https://www.microsoft.com/en-us/{GlobalProductURL}

يستعلم العامل فقط عن القسم المحدد في موقع الويب في وقت التشغيل.

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

استخدم المتغيرات في مصادر معارف موقع الويب العام من أجل:

• التوجيه المستند إلى المنتج: تحديد نطاق الاستعلامات إلى وثائق منتج معين.

• تصفية المنطقة أو اللغة: تعيين User.Language إلى عناوين URL المترجمة (على سبيل المثال، en-us، it-it).

• عناوين URL الخاصة بالبيئة: التبديل بين مواقع التطوير والاختبار والإنتاج.

الاعتبارات

• تستخدم مصادر معارف موقع الويب العام بحث Bing وتعتمد على المحتوى المفهرس.
• لا تزال حدود عمق عنوان URL تنطبق عند استخدام المتغيرات.
• المتغيرات تغير عنوان URL الهدف فقط. لا تؤثر على كيفية فهرسة المحتوى أو استرداده.

مهم

يجب أن يتم حل المتغير إلى عنوان URL عام صالح يلبي متطلبات مصادر معرفة موقع الويب العام. قد لا ترجع عناوين URL غير الصالحة أو غير المعتمدة النتائج.