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

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

Note

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

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

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

• لا يتم تضمين ردود الوكلاء التي تستخدم SharePoint كمصدر للمعرفة فِي نصوص المحادثة.

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

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

Note

من الممكن اِسْتِخْدام إجابات إنشاءية مَعَ بيانات 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 طريقة شائعة لتخزين البيانات الجدولية وتوفير وصول سريع وسهل إلى المعلومات. يمكن لعاملك اِسْتِخْدام هذه القوائم كمصدر معارف. بإضافة قَائِمَة SharePoint كمصدر معارف، يمكنك إنشاء اتصال فِي الوقت الحقيقي بالمصدر، بحيث يتم اِسْتِخْدام أحدث البيانات للاستعلامات والاستدلال. تتم مصادقة الْمُسْتَخْدِمين باِسْتِخْدام بيانات اعتماد SharePoint الخاصة بهم، ما يضمن حصولهم على إذن للوصول إلى البيانات قبل أن يوفر الْعامِلُ استجابة.

1. افْتَحِ العامل.

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

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

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

   

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

   

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

   Note

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

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

7. أضف اسمًا ووصفًا. يجب أن يكون الوصف مفصلا قدر الإمكان، خاصة إذا تم تمكين الذَّكَاءُ الِاصْطِنَاعِيُّ التوليدية، حيث يساعد الوصف على التزامن التوليدي.

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

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

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

Important

إذا تم تمكين البحث المقيد في 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 الخاص بوكيلهم عن طريق تحديد المعلمات لاستعلام البحث. تحدد معلمات الاستعلام هذه ما يتم البحث فيه داخل مصدر المعرفة. على سبيل المثال، يمكنك تحديد أنك تريد فقط عمليات البحث عن العناصر التي تم تعديلها في الأشهر الستة الماضية. سيتم إنشاء هذا النوع من عوامل التصفية على النحو التالي:

Attribute	المشغل	Value
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 المُحل.

Note

استخدام متغير يغير عنوان 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 الخاصة بالبيئة: التبديل بين مواقع التطوير والاختبار والإنتاج.

Considerations

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

Important

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