app templates java openai springapps
v1.1.0
| page_type | اللغات | منتجات | urlfragment | اسم | وصف | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
عينة |
|
| app-templates-java-openai-springapps | عربة التسوق منظمة العفو الدولية - قالب التطبيقات لتطبيقات Java و Azure Openai و Azure Spring | عينة العربة التسوق AI مع Azure Openai و Azure Spring Apps |
AI AI Shopping Cart هي تطبيق عينة يتجرب من تجربة التسوق الخاصة بك مع قوة الذكاء الاصطناعى. إنه يعزز تطبيقات Azure Openai و Azure Spring لإنشاء محرك توصية ليس فقط قابلاً للتطوير ومرونة وآمنة ، ولكن أيضًا مخصصة لاحتياجاتك. الاستفادة من Azure Openai ، يقوم التطبيق بتحليل التغذية على العناصر الموجودة في عربة التسوق الخاصة بك ويولد أفضل 3 وصفات باستخدام تلك المكونات. مع مطور Azure CLI (AZD) ، فأنت مجرد عدد قليل من الأوامر بعيدًا عن وجود هذا التطبيق العاملة الكاملة في التشغيل وتشغيله في Azure. لنبدأ!
هذا التطبيق يأخذ الإلهام في هذا العمل الأصلي: https://github.com/lopezleandro03/ai-assisted-groceries
ارجع إلى مستودع قوالب التطبيقات لمزيد من العينات المتوافقة مع
azd.
gpt-4 أو gpt-35-turbo [ملاحظة] لمعرفة كيفية البدء في أي قالب ، اتبع هذا Quickstart. بالنسبة إلى هذا القالب Azure-Samples/app-templates-java-openai-springapps تحتاج إلى تنفيذ بعض الخطوات الإضافية كما هو موضح أدناه.
سيوضح لك هذا Quickstart كيفية المصادقة على Azure ، وتمكين ميزة تطبيقات Spring Apps Alpha لـ AZD ، وتهيئة باستخدام قالب ، وتعيين متغيرات البيئة لـ Azure Openai ، وتوفير البنية التحتية ، ونشر الكود إلى Azure:
# Log in to azd if you haven't already
azd auth login
# Enable Azure Spring Apps alpha feature for azd
azd config set alpha.springapp on
# First-time project setup. Initialize a project in the current directory using this template
azd init --template Azure-Samples/app-templates-java-openai-springapps
# Set the environment variables for Azure OpenAI
azd env set azureOpenAiApiKey < replace-with-Azure-OpenAi-API-key >
azd env set azureOpenAiEndpoint < replace-with-Azure-OpenAi-endpoint >
azd env set azureOpenAiDeploymentId < replace-with-Azure-OpenAi-deployment-id/name >
# To use GPT-3.5 Turbo model set this environment variable to false
azd env set isAzureOpenAiGpt4Model true
# Provision and deploy to Azure
azd upملحوظات
- استبدل العناصر النائبة بالقيم من مورد Azure Openai الخاص بك.
- إذا كنت تستخدم نموذج
gpt-35-turbo، فأنت بحاجة إلى تعيينisAzureOpenAiGpt4Modelعلىfalseقبل توفير المورد ونشر تطبيق العينة على Azure:azd env set isAzureOpenAiGpt4Model false
في نهاية النشر ، سترى عنوان URL في الواجهة الأمامية. افتح عنوان URL في المتصفح لرؤية التطبيق أثناء العمل.
يستخدم تطبيق العينة موارد Azure التالية:
إليك مخطط الهندسة المعمارية عالية المستوى يوضح هذه المكونات. باستثناء Azure Openai ، يتم توفير جميع الموارد الأخرى في مجموعة موارد واحدة يتم إنشاؤها عند إنشاء مواردك باستخدام azd up .
يوضح هذا القالب الموارد لاشتراك Azure الذي ستختاره عند توفيرها. يرجى الرجوع إلى حاسبة التسعير لـ Microsoft Azure ، وإذا لزم الأمر ، قم بتحديث تعريفات موارد Azure المضمنة الموجودة في
infra/main.bicepلتناسب احتياجاتك.
يستخدم هذا التطبيق Azure Openai. إنها ليست جزءًا من عملية النشر الآلية. ستحتاج إلى إنشاء مورد Azure Openai وتكوين التطبيق لاستخدامه. يرجى اتباع التعليمات الواردة في وثائق Azure Openai للوصول إلى Azure Openai. لا تنس أن تقرأ نظرة عامة على ممارسات الذكاء الاصطناعى المسؤولة لنماذج Azure Openai قبل البدء في استخدام Azure Openai وطلب الوصول.
يتطلب الإصدار الحالي من تطبيق Sample مورد Azure Openai الذي يمكن الوصول إليه بشكل عام (أي السماح للوصول من جميع الشبكات). هذه العينة غير المقصود استخدامها في الإنتاج. لمعرفة المزيد عن الشبكات والأمان لـ Azure Openai ، يرجى الرجوع إلى وثائق Azure Openai.
تم تطوير تطبيق العينة هذا ليتم استخدامه مع نموذج gpt-4 . كما يدعم gpt-35-turbo . لاستخدام gpt-35-turbo ، تحتاج إلى تعيين isAzureOpenAiGpt4Model على false (راجع QuickStart). بشكل افتراضي ، يتم تعيين متغير المعلمة/البيئة على true . لإكمال إعداد التطبيق ، تحتاج إلى تعيين المعلومات التالية من مورد Azure Openai:
azureOpenAiApiKey - Azure Openai API KeyazureOpenAiEndpoint - نقطة نهاية Azure OpenaiazureOpenAiDeploymentId معرف نشر Azure Openai من gpt-4 أو gpt-3.5-turbo Model يمكن العثور على مفتاح API ونقطة النهاية في بوابة Azure. يمكنك متابعة هذه التعليمات: استرداد المفتاح و Enpoint. يتوافق معرف النشر مع deployment name في هذا الدليل.
من المهم الحصول على أفضل النتائج من Azure Openai. مطالبات النص هي كيفية تفاعل المستخدمين مع نماذج GPT. كما هو الحال مع جميع نموذج اللغة الكبير التوليدي (LLM) ، تحاول نماذج GPT إنتاج السلسلة التالية من الكلمات التي من المرجح أن تتبع النص السابق. إنه يشبه إلى حد ما السؤال عن نموذج الذكاء الاصطناعي: ما هو أول شيء يتبادر إلى الذهن عندما أقول <prompt> ؟
مع API لإكمال الدردشة ، هناك أقسام مميزة من المطالبة التي يتم إرسالها إلى واجهة برمجة التطبيقات المرتبطة بدور محدد: النظام والمستخدم والمؤكد. يتم تضمين رسالة النظام في بداية المطالبة ويتم استخدامها لتوفير التعليمات الأولية للنموذج: وصف للسمات الشخصية ، والتعليمات/القواعد التي ستتبعها ، إلخ ، إلخ.
تستخدم AI Shopping Cart Service مكتبة عميل Azure Openai لـ Java. هذا libary هو جزء من Azure SDK لجافا. يتم تنفيذه كإكمال دردشة. في الخدمة ، لدينا رسالتان نظامان في SystemMessageConstants.java: واحد لتحليل التغذية من الذكاء الاصطناعي وواحد لإنشاء أفضل 3 وصفات. تتبع رسالة النظام رسالة مستخدم: The basket is: <list of items in the basket separated by a comma> . الرسالة المساعد هي الرد من النموذج. تستخدم الخدمة مجموعة التسوق للتفاعل مع Azure Openai. ستجد في هذه الفئة الرمز المسؤول عن إنشاء المطالبة والاتصال بـ Azure Openai API: getChatCompletion . لمعرفة المزيد عن درجة الحرارة و TOPP المستخدمة في هذه الفئة ، يرجى الرجوع إلى الوثائق.
بالنسبة لنموذج gpt-35-turbo ، تتم إضافة المزيد من السياق إلى رسالة المستخدم. تتم إضافة هذا السياق الإضافي في نهاية رسالة المستخدم. يوفر مزيدًا من المعلومات حول تنسيق JSON الذي يحتاجه نموذج Openai إلى العودة واطلب من النموذج TOR إرجاع JSON فقط دون نص إضافي. يتوفر هذا السياق الإضافي في usermessageConstants.java.
تم تنظيم هذا القالب لمتابعة شروح قالب CLI مطور Azure. يمكنك معرفة المزيد عن azd Architecture في الوثائق الرسمية.
في هذه المرحلة ، لديك تطبيق كامل تم نشره على Azure.
لتلبية احتياجات المؤسسات ، والبحث عن نشر تطبيقات Polyglot ، ودعم مكونات TANZU وضمان SLA ، نوصي باستخدام Azure Spring Apps Enterprise. تحقق من Azure Spring Apps Landing Zone Accelerator الذي يوفر إرشادات معمارية مصممة لتبسيط توفير البنية التحتية جاهزة للإنتاج ونشر تطبيقات Spring Boot و Spring Cloud إلى تطبيقات Azure Spring. بصفته مالك عبء العمل ، استخدم التوجيه المعماري المقدم في مسرع منطقة الهبوط لتحقيق حالتك التقنية المستهدفة بثقة.
لقد قمت بنشر تطبيق العينة باستخدام Azure Developer CLI ، ولكن هناك الكثير مما يمكن لمطور Azure CLI القيام به. ستقدمك هذه الخطوات التالية إلى أوامر إضافية تجعل إنشاء تطبيقات على Azure أسهل بكثير. باستخدام Azure Developer CLI ، يمكنك إعداد خطوط الأنابيب الخاصة بك ومراقبة التطبيق والاختبار والتصحيح محليًا.
azd down - لحذف جميع موارد Azure التي تم إنشاؤها باستخدام هذا القالب
azd pipeline config - لتكوين خط أنابيب CI/CD (باستخدام إجراءات GitHub أو Azure DevOps) لنشر التطبيق الخاص بك كلما تم دفع الرمز إلى الفرع الرئيسي.
AZURE_OPENAI_API_KEY : مفتاح API لمورد Azure OpenaiAZURE_OPENAI_ENDPOINT : نقطة نهاية لمورد Azure OpenaiAZURE_OPENAI_DEPLOYMENT_ID : معرف النشر/الاسم لمورد Azure OpenaiIS_AZURE_OPENAI_GPT4_MODEL : اضبط على true إذا كنت تستخدم نموذج GPT-4 وإلى false إذا كنت تستخدم نموذج GPT-3.5 TURBO azd monitor - لمراقبة التطبيق والانتقال بسرعة إلى لوحات معلومات التطبيقات المختلفة (مثل نظرة عامة ، مقاييس مباشرة ، سجلات)
قم بتشغيل وتصحيح التصحيح محليًا - باستخدام رمز Visual Studio و Azure Developer CLI Extension
azd إضافية يتضمن مطور Azure CLI العديد من الأوامر الأخرى للمساعدة في تجربة تطوير Azure. يمكنك عرض هذه الأوامر في المحطة عن طريق تشغيل azd help . يمكنك أيضًا عرض القائمة الكاملة للأوامر على صفحة أوامر مطور Azure CLI.
هذه موارد إضافية يمكنك استخدامها لمعرفة المزيد حول تطبيق العينة وتقنياته الأساسية.
قد يقوم البرنامج بجمع معلومات عنك واستخدامك للبرنامج وإرساله إلى Microsoft. قد تستخدم Microsoft هذه المعلومات لتوفير الخدمات وتحسين منتجاتنا وخدماتنا. يمكنك إيقاف تشغيل القياس عن بعد كما هو موضح في المستودع. هناك أيضًا بعض الميزات في البرنامج التي قد تمكنك و Microsoft من جمع البيانات من مستخدمي التطبيقات الخاصة بك. إذا كنت تستخدم هذه الميزات ، فيجب عليك الامتثال للقانون المعمول به ، بما في ذلك تقديم إشعارات مناسبة لمستخدمي التطبيقات الخاصة بك مع نسخة من بيان خصوصية Microsoft. يقع بيان الخصوصية الخاص بنا على https://go.microsoft.com/fwlink/؟linkid=521839. يمكنك معرفة المزيد حول جمع البيانات واستخدامها في وثائق المساعدة وبيان الخصوصية لدينا. يعمل استخدامك للبرنامج كموافقتك على هذه الممارسات.
مجموعة القياس عن بعد بشكل افتراضي.
لإلغاء الاشتراك ، قم بتعيين متغير enialtelemetry على false في infra/main.parameters.json أو في قالب Bicep infra/main.bicep . يمكن تعيينه باستخدام الأمر التالي عند الانتهاء من التوفير مع مطور Azure CLI:
azd env set enableTelemetry false قد يحتوي هذا المشروع على علامات تجارية أو شعارات للمشاريع أو المنتجات أو الخدمات. يخضع الاستخدام المعتمد للعلامات التجارية أو الشعارات Microsoft ويجب أن يتبعوا إرشادات Microsoft التجارية والعلامة التجارية. يجب ألا يسبب استخدام العلامات التجارية Microsoft أو الشعارات في إصدارات معدلة من هذا المشروع الارتباك أو يعني رعاية Microsoft. يخضع أي استخدام للعلامات التجارية أو الشعارات من طرف ثالث لسياسات تلك الطرف الثالث.
