استخدام تطبيق ويب Azure OpenAI
بالإضافة إلى Azure OpenAI Studio وواجهات برمجة التطبيقات وSDKs، يمكنك أيضا استخدام تطبيق الويب المستقل المتوفر للتفاعل مع نماذج Azure OpenAI باستخدام واجهة مستخدم رسومية، والتي يمكنك نشرها باستخدام استوديو Azure OpenAI أو التوزيع اليدوي.
اعتبارات هامة
يؤدي النشر إلى إنشاء Azure App Service في اشتراكك. قد تتحمل تكاليف اعتمادا على خطة التسعير التي تحددها. عند الانتهاء من تطبيقك، يمكنك حذفه من مدخل Microsoft Azure.
نماذج معاينة رؤية gpt-4 غير مدعومة.
بشكل افتراضي، سيتم نشر التطبيق مع موفر هوية Microsoft الذي تم تكوينه بالفعل، ما يقيد الوصول إلى التطبيق لأعضاء مستأجر Azure. لإضافة المصادقة أو تعديلها:
انتقل إلى مدخل Microsoft Azure وابحث عن اسم التطبيق الذي حددته أثناء النشر. حدد تطبيق الويب، ثم انتقل إلى علامة التبويب Authentication في قائمة التنقل اليسرى. ثم حدد إضافة موفر هوية.
حدد Microsoft كموفر الهوية. ستقيد الإعدادات الافتراضية في هذه الصفحة التطبيق على المستأجر الخاص بك فقط، لذلك لا تحتاج إلى تغيير أي شيء آخر هنا. ثم حدد إضافة
الآن سيطلب من المستخدمين تسجيل الدخول باستخدام حساب Microsoft Entra ID الخاص بهم حتى يتمكنوا من الوصول إلى تطبيقك. يمكنك اتباع عملية مماثلة لإضافة موفر هوية آخر إذا كنت تفضل ذلك. لا يستخدم التطبيق معلومات تسجيل الدخول الخاصة بالمستخدم بأي طريقة أخرى غير التحقق من أنه عضو في المستأجر الخاص بك.
تخصيص تطبيق الويب
يمكنك تخصيص منطق الواجهة الأمامية والخلفية للتطبيق. يوفر التطبيق العديد من متغيرات البيئة لسيناريوهات التخصيص الشائعة مثل تغيير الأيقونة في التطبيق. راجع التعليمات البرمجية المصدر لتطبيق الويب، والمزيد من المعلومات حول GitHub.
عند تخصيص التطبيق، نوصي بما يلي:
إعادة تعيين جلسة الدردشة (مسح الدردشة) إذا غير المستخدم أي إعدادات. قم بإعلام المستخدم بأنه سيتم فقدان محفوظات الدردشة الخاصة به.
سيؤثر التواصل بوضوح حول كيفية تأثير كل إعداد تنفذه على تجربة المستخدم.
عند تدوير مفاتيح واجهة برمجة التطبيقات لمورد Azure OpenAI أو Azure الذكاء الاصطناعي Search، تأكد من تحديث إعدادات التطبيق لكل تطبيق من التطبيقات المنشورة لاستخدام المفاتيح الجديدة.
يتوفر نموذج التعليمات البرمجية المصدر لتطبيق الويب على GitHub. يتم توفير التعليمات البرمجية المصدر "كما هي" وكنموذج فقط. يتحمل العملاء مسؤولية جميع التخصيصات وتنفيذ تطبيقات الويب الخاصة بهم.
تحديث تطبيق الويب
إشعار
بعد 1 فبراير 2024، يتطلب تطبيق الويب تعيين أمر بدء تشغيل التطبيق إلى python3 -m gunicorn app:app. عند تحديث تطبيق تم نشره قبل 1 فبراير 2024، تحتاج إلى إضافة أمر بدء التشغيل يدويا من صفحة App Service Configuration .
نوصي بسحب التغييرات من الفرع للتعليمات البرمجية المصدر لتطبيق الويب بشكل متكرر للتأكد من main أن لديك أحدث إصلاحات الأخطاء وإصدار واجهة برمجة التطبيقات والتحسينات. بالإضافة إلى ذلك، يجب مزامنة تطبيق الويب في كل مرة يتم فيها إيقاف إصدار واجهة برمجة التطبيقات المستخدم.
ضع في اعتبارك إما النقر فوق زري الساعة أو النجمة على مستودع GitHub لتطبيق الويب ليتم إعلامك بالتغييرات والتحديثات على التعليمات البرمجية المصدر.
إذا لم تقم بتخصيص التطبيق:
- يمكنك اتباع خطوات المزامنة أدناه
إذا قمت بتخصيص التعليمات البرمجية المصدر للتطبيق أو تغييرها:
- ستحتاج إلى تحديث التعليمات البرمجية المصدر لتطبيقك يدويا وإعادة نشرها.
- إذا كان التطبيق الخاص بك مستضافا على GitHub، فادفع تغييرات التعليمات البرمجية إلى المستودع الخاص بك، واستخدم خطوات المزامنة أدناه.
- إذا كنت تعيد نشر التطبيق يدويا (على سبيل المثال Azure CLI)، فاتبع الخطوات الخاصة باستراتيجية التوزيع الخاصة بك.
مزامنة تطبيق الويب
إذا قمت بتخصيص تطبيقك، فقم بتحديث التعليمات البرمجية المصدر للتطبيق.
حدد Deployment center في قائمة التنقل، ضمن Deployment.
حدد مزامنة في أعلى الشاشة، وتأكد من إعادة نشر التطبيق.
محفوظات الدردشة
يمكنك تمكين محفوظات الدردشة لمستخدمي تطبيق الويب. عند تمكين الميزة، سيتمكن المستخدمون من الوصول إلى استعلاماتهم واستجاباتهم السابقة الفردية.
لتمكين محفوظات الدردشة، انشر نموذجك أو أعد نشره كتطبيق ويب باستخدام Azure OpenAI Studio.
هام
سيؤدي تمكين محفوظات الدردشة إلى إنشاء مثيل Cosmos DB في مجموعة الموارد الخاصة بك، ويتحمل رسوما إضافية للتخزين المستخدم.
بمجرد تمكين محفوظات الدردشة، سيتمكن المستخدمون من إظهارها وإخفائها في الزاوية العلوية اليسرى من التطبيق. عند عرض المحفوظات، يمكنهم إعادة تسمية المحادثات أو حذفها. أثناء تسجيل الدخول إلى التطبيق، سيتم ترتيب المحادثات تلقائيا من الأحدث إلى الأقدم، وستتم تسميتها استنادا إلى الاستعلام الأول في المحادثة.
حذف مثيل Cosmos DB الخاص بك
لا يؤدي حذف تطبيق الويب إلى حذف مثيل Cosmos DB تلقائيا. لحذف مثيل Cosmos DB الخاص بك، جنبا إلى جنب مع جميع الدردشات المخزنة، تحتاج إلى الانتقال إلى المورد المقترن في مدخل Microsoft Azure وحذفه. إذا حذفت مورد Cosmos DB مع الاحتفاظ بخيار محفوظات الدردشة ممكنا على الاستوديو، فسيتم إعلام المستخدمين بخطأ في الاتصال، ولكن يمكنهم الاستمرار في استخدام تطبيق الويب دون الوصول إلى محفوظات الدردشة.