إنشاء قاعدة معرفة لسير العمل الوكيلي لاستخدامها في Azure Logic Apps (معاينة)

ينطبق على: Azure Logic Apps (قياسي)

ملحوظة

تخضع ميزة المعاينة هذه لشروط الاستخدام الإضافية لمعاينات Microsoft Azure.

تقوم مؤسستك بتوليد بيانات غير منظمة من المستندات، وجداول البيانات، وواجهات برمجة التطبيقات، والأنظمة الداخلية. باستخدام قدرة قاعدة المعرفة كخدمة (KBaaS) في Azure Logic Apps، يمكنك تحويل هذا المحتوى إلى قاعدة معرفة منظمة وأكثر قابلية للبحث يمكن لحلقات الوكلاء في سير العمل الوكيلي استخدامها لإكمال المهام. قاعدة المعرفة هي حاوية منطقية تنظم مصادر المعرفة ذات الصلة مثل المستندات أو الملفات المتعلقة بمجال معين.

على سبيل المثال، قد تنشئ قاعدة معرفة تحتوي على جميع الوثائق المتعلقة بسياسات وإجراءات الموارد البشرية. عند إنشاء قاعدة معرفية، يقوم KBaaS تلقائيا بإعداد قواعد بيانات Azure Cosmos DB والحاويات وسياسات الفهرسة المطلوبة. لمزيد من المعلومات، راجع قواعد البيانات Azure Cosmos DB والحاويات والعناصر.

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

القيود

يحتوي هذا الإصدار التمهيدي على القيود التالية:

• تدعم هذه المعاينة القدرات التالية:

  • الملفات المرفوعة كنوع مصدر لقطع المعرفة.
  • الملفات بالصيغ التالية: DOC، DOCX، HTML، MD، PDF، PPT، PPTX، TXT، XLS، XLSX.
  • تحليل المحتوى النصي في المستندات، وليس الصور.
  • إعدادات تقسيم الأجزاء الافتراضية، ليست مخصصة للقطع.

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

• فقط بوابة Azure مدعومة حاليا لهذه القدرة.

كيف تعمل قاعدة المعرفة

يبسط KBaaS تحويل البيانات ويوفر طبقة تجريد عبر Azure Cosmos DB و Azure OpenAI بحيث يمكن لسير العمل أن يستهلك ويعالج واسترجاع المعرفة المنظمة بسهولة أكبر دون بناء خط إنتاج مخصص لتوليد Retrieval-Augmented (RAG).

يحتوي KBaaS على خطوط الأنابيب التالية:

• خط أنابيب التضمين: عندما ترفع مستندا أو مصدر معرفة إلى قاعدة معرفتك، تقوم الخدمة تلقائيا بتحليل وتقسيم وتلخيص وتحويل المحتوى. ثم تخزن الخدمة النتائج في Azure Cosmos DB.

• خط أنابيب الاسترجاع: عندما تستشفي حلقة الوكيل بقاعدة معرفتك، تعيد الخدمة كتابة الاستعلام إذا لزم الأمر، وتولد تمثيلا متجهيا، وتجري بحثا دلاليا ضد Azure Cosmos DB، وتعيد الأجزاء الأكثر صلة إلى نموذج اللغة الكبيرة (LLM) لتوليد الاستجابة.

المتطلبات المسبقه

• حساب واشتراك Azure. احصل على حساب Azure مجاني.

• مورد Azure OpenAI. لمزيد من المعلومات، راجع إنشاء ونشر مورد خدمة Azure OpenAI.

  • مورد المورد الخاص بك يحتاج إلى النماذج المنتشرة التالية:

    • نموذج إكمال، مثل gpt-4o.
    • نموذج التضمينات، مثل نص-embedding-3-small.

• An Azure Cosmos DB for NoSQL account.

  • قبل أن تنشئ قاعدة معرفتك، قم بتمكين البحث المتجه في حساب قاعدة بيانات كوزموس الخاص بك. قد تستغرق هذه العملية حتى 15 دقيقة قبل الانتهاء.

    لمزيد من المعلومات، انظر:

    • Quickstart: أنشئ Azure Cosmos DB لحساب NoSQL باستخدام بوابة Azure
    • Vector البحث في Azure Cosmos DB عن NoSQL

• تطبيق منطقي قياسي وسير عمل وكيلي.

  لمزيد من المعلومات، انظر:

  • إنشاء سير عمل وكيلي مستقل دون تفاعل بشري في Azure Logic Apps
  • إنشاء سير عمل وكيل حواري مع تفاعلات الدردشة بصيغة Azure Logic Apps

• إذا كنت تخطط لاستخدام المصادقة المدارة للهوية، اذهب إلى الموارد المقابلة، وخصص الأدوار التالية للهوية المدارة:

  • Cosmos DB Built-in Data Contributor و Cosmos DB Operator على حساب Azure Cosmos DB الخاص بك.

    • راجع واتبع أفضل الممارسات الأمنية المتعلقة بأدوار المساهمين وافهم علاقتهم بالهويات المدارة.
    • لتعيين مساهم البيانات المدمج في قاعدة بيانات Cosmos، والذي لا يتوفر في بوابة Azure، استخدم الأمر التالي: az cosmosdb sql role assignment create.

  • مستخدم خدمات Cognitive OpenAI على مورد Azure OpenAI الخاص بك.

  وإلا، قد تواجه مشاكل مثل إنشاء مجموعات وإضافة ملفات إلى قاعدة معرفتك.

  لمزيد من المعلومات، انظر:

  • تعيين أدوار Azure للهويات المدارة
  • تعيين أدوار Azure باستخدام بوابة Azure

المصادقة

تدعم قدرة KBaaS المصادقة باستخدام Microsoft Entra ID مع managed identity أو مفتاح API. إذا أمكن، قم بإعداد واستخدام هوية مدارة لتحقيق أمان أمثل ومتفوق. لا تحتاج إلى توفير وإدارة بيانات الاعتماد أو الأسرار أو مفاتيح الوصول يدويا.

إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات (API)، قم بحماية وحماية البيانات الحساسة والشخصية، مثل بيانات الاعتماد، الأسرار، مفاتيح الوصول، سلاسل الاتصال، الشهادات، بصمات الإبهام، والمعلومات المشابهة بأعلى مستوى أمني متاح أو مدعوم. تخزين هذه المعلومات بأمان باستخدام Microsoft Entra ID و Azure Key Vault. لا تقم بترميز هذه المعلومات أو مشاركتها مع مستخدمين آخرين أو حفظها في نص عادي في أي مكان يمكن للآخرين الوصول إليه. ضع خطة لتدوير أو إلغاء الأسرار في حال تم اختراقها.

لمزيد من المعلومات، راجع الموارد التالية:

• أتمتة تدوير البيانات السرية في Azure Key Vault
• أفضل الممارسات لحماية الأسرار
• البيانات السرية في Azure Key Vault

1: إنشاء رابط قاعدة المعرفة

لإنشاء اتصال قاعدة المعرفة، قم بربط قاعدة بيانات Cosmos ونماذج موارد Azure OpenAI باتباع الخطوات التالية:

1أ: إعداد اتصال قاعدة بيانات كوزموس

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

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

3. في صفحة قاعدة المعرفة ، اختر الإعداد.

4. في صفحة الإعداد ، في تبويب الأساسيات ، قدم المعلومات التالية:

   المعلمة	مطلوب	الوصف
   ‏‫اسم العرض‬	نعم	اسم يمكن للشخص قراءته لاتصالك في قاعدة المعرفة. استخدم نفس اسم قاعدة المعرفة التي تخطط لإنشائها حتى يتمكن إجراء الاسترجاع من ربط الاتصال الصحيح.
   نوع المصادقة	نعم	هوية الخدمةالقائمة على المفتاح أو الإدارة
   الاشتراك	نعم	اشتراك Azure الخاص بك.
   قاعدة بيانات	نعم	قاعدة بيانات كوزموس الخاصة بك.
   نقطة نهاية الرابط	نعم	اختيار قاعدة البيانات الخاص بك يقوم تلقائيا بملء هذه القيمة.
   مفتاح	نعم	متاح فقط إذا اخترت المصادقة القائمة على المفاتيح . اختيار قاعدة البيانات الخاص بك يقوم تلقائيا بملء هذه القيمة.

5. عِندَ الانتهَاء، حدد التَالِي.

1ب: إعداد اتصال الموارد في Azure OpenAI

1. في تبويب النموذج ، قدم المعلومات التالية:

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

2. عند الانتهاء، حدد إنشاء.

2: إضافة تشوهات معرفية

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

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

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

3. إذا أردت إنشاء مجموعة قبل إضافة الملفات، في شريط أدوات صفحة قاعدة المعرفة ، اختر New>إنشاء مجموعة جديدة، ثم اتبع التعليمات لإنشاء المجموعة.

4. في صفحة قاعدة المعرفة ، اختر إضافة الملفات. أو، في شريط أدوات الصفحة، اخترإضافة ملفات>.

5. في لوحة إضافة الملفات ، أكمل المهام التالية:

   1. في قسم المجموعة ، أدخل المعلومات التالية:

      المعلمة	مطلوب	الوصف
      الاسم	نعم	اسم المجموعة التي تنظم الملفات في قاعدة معرفتك. أدخل اسما جديدا أو اختر مجموعة موجودة.
      الوصف	لا	وصف اختياري للمجموعة.

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

      المعلمة	مطلوب	قيمه	الوصف
      الاسم	نعم	< اسم المصدر>	اسم للملف كمصدر معرفة، على سبيل المثال، HRPolicyDocument.
      الوصف	لا	< وصف المصدر>	وصف اختياري للملف كمصدر معرفة.

6. عندما تنتهي، اختر الإضافة.

   يقوم KBaaS بإنشاء حاويات قاعدة بيانات كوزموس التالية:

   الحاوية	الغرض
   KnowledgeHubs	يخزن بيانات قاعدة المعرفة الوصفية.
   الأدلة المعرفية	يخزن بيانات وصفية المصدر ومراجع المستندات المصدرية.
   قطع المعرفة الأثرية	يخزن أجزاء المستندات كاملة النص.
   ملخصات المعلومة	كانت تخزن الأجزاء الملخصة مع تضمينات متجهية للبحث الدلالي.

   يعيد KBaaS استجابة 202 مقبولة مع معرف عملية لتتبع تقدم الرفع.

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

7. راقب حالة الرفع في بوابة Azure أو باستخدام معرف العملية.

8. بعد انتهاء KBaaS، تابع إلى القسم التالي حتى تتمكن من إضافة قاعدة المعرفة كأداة لاستخدام حلقة الوكيل في سير عمل Agentic Standard الخاص بك.

3: إضافة قاعدة المعرفة كأداة

يمكنك الآن إضافة قاعدة المعرفة إلى حلقة الوكيل لاستخدامها كأداة في سير عمل الوكلاء القياسي الخاص بك. تقوم حلقات الوكلاء تلقائيا بالاستعلام عن قاعدة المعرفة لاسترجاع المعلومات ذات الصلة الدلالية من المستندات التي تم رفعها.

1. في نفس تطبيق المنطق القياسي الذي يتضمن قاعدة معرفتك، في المصمم، افتح سير العمل الوكيلي الخاص بك، واختر حلقة الوكيل التي تريدها.

2. في لوحة معلومات الوكيل، في قسم قاعدة المعرفة ، اختر الإنشاء.

3. في لوحة إنشاء الاتصال ، من قائمة المصادر ، اختر قاعدة المعرفة.

4. لرفع المزيد من الملفات إلى قاعدة معرفتك، اختر + رفع.

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

لسرد وعرض وحذف قواعد المعرفة أو المصادر، استخدم بوابة Azure أو واجهة برمجة تطبيقات REST.

قائمة بجميع قواعد المعرفة

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

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

أو، قم بإجراء استدعاء واجهة برمجة تطبيقات REST التالية:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs

عرض قاعدة معرفة محددة

في بوابة Azure، من صفحة <>قاعدة المعرفة، اختر اسم قاعدة المعرفة.

أو، قم بإجراء استدعاء واجهة برمجة تطبيقات REST التالية:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

يتضمن الرد معلومات قاعدة المعرفة، وقائمة بالمصادر المرتبطة، وحالة الرفع الخاصة بها.

اذكر المصادر في قاعدة المعرفة

في بوابة Azure، اختر قاعدة المعرفة لعرض مصادرها.

أو، قم بإجراء استدعاء واجهة برمجة تطبيقات REST التالية:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts

حذف مصدر معرفة

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

1. في بوابة Azure، اختر قاعدة المعرفة لعرض مصادرها.

2. حدد المصدر. في شريط الأدوات، حدد حذف.

أو، قم بإجراء استدعاء واجهة برمجة تطبيقات REST التالية:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts/{artifactName}

حذف قاعدة معرفة

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

1. في بوابة Azure، اختر قاعدة المعرفة.

2. في شريط الأدوات، حدد حذف.

أو، قم بإجراء استدعاء واجهة برمجة تطبيقات REST التالية:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

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

• ما المقصود بتطبيقات Azure Logic Apps؟
• خدمة Azure OpenAI
• Azure Cosmos DB البحث المتجه
• مخزن المتجه المتكامل - Azure Cosmos DB ل NoSQL