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

ملحوظة

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

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

يستخدم التوزيع الهوية المدارة كطريقة مصادقة افتراضية البحث باستخدام الذكاء الاصطناعي في Azure. يمكنك الاشتراك في المصادقة المستندة إلى المفتاح عن طريق الإعداد USE_KEYLESS_AUTH إلى false قبل النشر.

تسجيل الدخول إلى Azure

1. في تعليمة Visual Studio برمجية، افتح محطة طرفية في جذر المستودع، مثل azure-search-static-web-app.

2. سجل الدخول إلى Azure باستخدام azd.

   azd auth login
   

3. إذا طلب منك المستعرض، أكمل تدفق تسجيل الدخول باستخدام حساب Azure الذي تستخدمه لهذا البرنامج التعليمي.

إنشاء بيئة azd

• azd إنشاء بيئة. استبدل YOUR-ENVIRONMENT-NAME باسم قصير يحدد نشر البرنامج التعليمي هذا.

  azd env new YOUR-ENVIRONMENT-NAME
  

(اختياري) تكوين المصادقة المستندة إلى المفتاح

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

عيّن USE_KEYLESS_AUTH إلى false.

azd env set USE_KEYLESS_AUTH false

إذا لم تقم بتعيين USE_KEYLESS_AUTH، فإن التوزيع يستخدم الهوية المدارة. تمنح البنية الأساسية Bicep هوية تطبيق الحاوية الوصول إلى مستوى بيانات البحث باستخدام الذكاء الاصطناعي في Azure.

النشر باستخدام azd up

1. من جذر المستودع، قم بتشغيل azd up.

   azd up
   

2. عند المطالبة، حدد اشتراك Azure وموقع الموارد.

3. انتظر azd لتوفير البنية الأساسية، وبناء الحاويات، ودفع الصور، ونشر الخدمات إلى Azure Container Apps.

4. راجع الإخراج بعد التوزيع. يتضمن الإخراج أسماء المجالات المؤهلة بالكامل للعميل والخادم (FQDNs) لنشر Azure Container Apps.

   AZURE_CLIENT_URL: <client-container-app-fqdn>
   AZURE_SERVER_URL: <server-container-app-fqdn>
   SEARCH_SERVICE_NAME: <search-service-name>
   

   AZURE_CLIENT_URL استخدم القيمة لفتح موقع الويب. يستدعي تطبيق العميل تطبيق الخادم من خلال نقطة النهاية التي تم تكوينها أثناء النشر.

   أنشأ النشر أيضا خدمة البحث باستخدام الذكاء الاصطناعي في Azure وحمل الفهرس good-books تلقائيا من خلال hook postprovision في مستودع العينة.

استخدام البحث في موقع تطبيقات الحاوية على الويب

1. افتح FQDN العميل من الإخراج azd up في مستعرض.

2. في شريط البحث في موقع الويب، أدخل استعلام بحث، مثل code. تقترح ميزة الإكمال التلقائي مطابقة عناوين الكتب.

3. اختر اقتراحا أو استمر في إدخال استفسارك الخاص. حدد إدخال عند الانتهاء من استعلام البحث.

4. راجع النتائج، ثم حدد كتابا للاطلاع على مزيد من التفاصيل.

استكشاف الأخطاء وإصلاحها

إذا لم يتم نشر تطبيق الويب أو عمله، فاستخدم القائمة التالية لتحديد المشكلة وإصلاحها:

• هل azd up اكتملت؟

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

• هل يمكنك فتح نقطة نهاية العميل؟

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

• هل يمكن للعميل استدعاء نقطة نهاية الخادم؟

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

• هل يمكن أن البحث باستخدام الذكاء الاصطناعي في Azure استعلام الخادم؟

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

تنظيف الموارد

استخدم azd down --purge لحذف موارد Azure التي أنشأها هذا البرنامج التعليمي. تقوم --purge العلامة بإزالة الموارد التي تدعم الحذف المبدئي بشكل دائم، بدلا من تركها في حالة قابلة للاسترداد لفترة الاستبقاء الخاصة بها. يتجنب الإزالة تعارضات التسمية إذا قمت بإعادة نشر هذا البرنامج التعليمي لاحقا.

1. من جذر المستودع، قم بتشغيل أمر التنظيف.

   azd down --purge
   

2. راجع الموارد التي تسرد azd .

3. أكد الحذف عند طلب ذلك منك.

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

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

استكشاف رمز تكامل البحث