البرنامج التعليمي: إضافة البحث باستخدام الذكاء الاصطناعي في Azure إلى تطبيق ويب C# على Azure Container Apps

ملحوظة

البحث باستخدام الذكاء الاصطناعي في Azure متوفر من خلال بوابة Azure، وواجهات برمجة التطبيقات REST، وAzure SDKs. كما يدعم طبقة المعرفة المدارة Foundry IQ، وهي طبقة المعرفة المدارة التي تحول محتوى المؤسسات إلى قواعد معرفية قابلة لإعادة الاستخدام وواثقة للأذونات للوكلاء في بوابة Microsoft Foundry.

ينشئ هذا البرنامج التعليمي موقع ويب يبحث من خلال كتالوج من الكتب وينشر موقع الويب على Azure Container Apps. يستخدم التوزيع Azure Developer CLI (azd) والهوية المدارة كطريقة مصادقة افتراضية البحث باستخدام الذكاء الاصطناعي في Azure.

في هذا البرنامج التعليمي، يمكنك:

  • انشر البحث باستخدام الذكاء الاصطناعي في Azure وزرع فهرس تلقائيا باستخدام Azure Developer CLI.
  • دمج استعلامات البحث والاقتراحات والواجهات وفصل الصفحات والبحث عن المستندات في تطبيق C#‎.
  • انشر التطبيق على Azure Container Apps بهوية مدارة كطريقة مصادقة افتراضية.

ماذا تفعل العينة؟

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

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

لقطة شاشة لنموذج التطبيق في نافذة مستعرض.

تتضمن تجربة البحث ما يلي:

  • البحث - يوفر وظيفة البحث للتطبيق.
  • اقتراح - يوفر اقتراحات لأنواع المستخدمين في شريط البحث.
  • الواجهات وعوامل التصفية - توفر بنية تنقل ذات واجهة تقوم بالتصفية حسب الكاتب أو اللغة.
  • نتائج مرقمة الصفحات - توفر عناصر تحكم ترحيل الصفحات للتمرير عبر النتائج.
  • البحث عن المستند - البحث عن مستند حسب المعرف لاسترداد كافة محتوياته لصفحة التفاصيل.

كيف يتم تنظيم العينة؟

يتضمن الكود النموذجي المكونات التالية:

App Purpose موقع مستودع GitHub
client تطبيق React (طبقة العرض التقديمي) لعرض الكتب مع البحث. يستدعي واجهة برمجة التطبيقات. /azure-search-static-web-app/client
api C# دالات Azure API (طبقة الأعمال)، المستضافة في حاوية على Azure Container Apps، التي تستدعي واجهة برمجة تطبيقات البحث باستخدام الذكاء الاصطناعي في Azure مع .NET SDK. /azure-search-static-web-app/api
bulk-insert .NET المشروع الذي ينشئ الفهرس ويحمل المستندات. azd يقوم التوزيع بتشغيل هذا تلقائيا من خلال الوصلةpostprovision. /azure-search-static-web-app/bulk-insert
infra Bicep البنية الأساسية المستخدمة من قبل azd لنشر البحث باستخدام الذكاء الاصطناعي في Azure Azure Container Apps والموارد الداعمة. Azure-Samples/azure-search-static-web-app

إعداد بيئة التطوير

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

لا يقوم هذا البرنامج التعليمي بتشغيل واجهة برمجة تطبيقات دالات Azure محليا. إذا كنت تريد تشغيله محليا، فقم بتثبيت دالات Azure Core Tools.

استنساخ نموذج البحث باستخدام Git

يمكنك نشر العينة من نسخة محلية. azd up يقرأ الأمر ملفات التطبيق والبنية الأساسية من المستودع المحلي الخاص بك، وينشئ الحاويات، ويحافظ Azure الموارد، وينشر العميل وواجهة برمجة التطبيقات إلى Azure Container Apps.

  1. في محطة Bash الطرفية، انسخ نموذج التطبيق إلى الكمبيوتر المحلي.

    git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
    
  2. في نفس محطة Bash الطرفية، انتقل إلى دليل المستودع لمثال البحث هذا.

    cd azure-search-static-web-app
    
  3. استخدم الأمر تعليمة Visual Studio برمجية، code .، لفتح المستودع. ما لم يتم تحديد خلاف ذلك، يمكنك إكمال المهام المتبقية في تعليمة Visual Studio برمجية.

    code .
    

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