app templates java openai springapps
v1.1.0
| page_type | ภาษา | สินค้า | urlfragment | ชื่อ | คำอธิบาย | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ตัวอย่าง |
|
| แอพ-เทมเพลต-java-openai-springapps | ตะกร้าสินค้า AI - เทมเพลตแอพสำหรับ Java, Azure Openai และ Azure Spring Apps | แอปพลิเคชั่นตัวอย่างตะกร้าสินค้า AI พร้อมแอพ Azure Openai และ Azure Spring |
AI Shopping Cart เป็นแอปพลิเคชั่นตัวอย่างที่เพิ่มประสบการณ์การช็อปปิ้งของคุณด้วยพลังของ AI มันใช้ประโยชน์จากแอพ Azure Openai และ Azure Spring เพื่อสร้างเอ็นจิ้นคำแนะนำที่ไม่เพียง แต่ปรับขนาดได้ยืดหยุ่นและปลอดภัย แต่ยังเป็นส่วนตัวตามความต้องการของคุณ การใช้ประโยชน์จาก Azure Openai แอปพลิเคชันทำการวิเคราะห์โภชนาการในรายการในรถเข็นของคุณและสร้างสูตร 3 อันดับแรกโดยใช้ส่วนผสมเหล่านั้น ด้วย Azure Developer CLI (AZD) คุณเพียงไม่กี่คำสั่งจากการมีแอปพลิเคชันตัวอย่างที่ใช้งานได้อย่างสมบูรณ์นี้และทำงานใน Azure เริ่มต้นกันเถอะ!
แอปพลิเคชันตัวอย่างนี้ใช้แรงบันดาลใจในงานต้นฉบับนี้: https://github.com/lopezleandro03/ai-assisted-cart-cart
อ้างถึง readme ที่เก็บของเทมเพลตแอพสำหรับตัวอย่างเพิ่มเติมที่เข้ากันได้กับ
azd
gpt-4 หรือ gpt-35-turbo [หมายเหตุ] หากต้องการเรียนรู้วิธีเริ่มต้นกับเทมเพลตใด ๆ ให้ติดตาม Quickstart นี้ สำหรับเทมเพลตนี้ Azure-Samples/app-templates-java-openai-springapps คุณต้องดำเนินการขั้นตอนเพิ่มเติมสองสามขั้นตอนตามที่อธิบายไว้ด้านล่าง
QuickStart นี้จะแสดงวิธีการตรวจสอบความถูกต้องบน Azure, เปิดใช้งานคุณสมบัติแอพฤดูใบไม้ผลิอัลฟ่าสำหรับ AZD, เริ่มต้นโดยใช้เทมเพลตตั้งค่าตัวแปรสภาพแวดล้อมสำหรับ Azure OpenAI จัดเตรียมโครงสร้างพื้นฐานและปรับใช้รหัสเป็น Azure: Azure: Azure: 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 อย่าลืมอ่านภาพรวมของแนวทางปฏิบัติ AI ที่รับผิดชอบสำหรับ Azure OpenAI รุ่นก่อนที่คุณจะเริ่มใช้ Azure OpenAI และขอการเข้าถึง
แอพตัวอย่างเวอร์ชันปัจจุบันต้องการทรัพยากร Azure OpenAI Azure ที่เข้าถึงได้สาธารณะ (เช่นอนุญาตการเข้าถึงจากเครือข่ายทั้งหมด) ตัวอย่างนี้ไม่ได้มีวัตถุประสงค์เพื่อใช้ในการผลิต หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับเครือข่ายและความปลอดภัยสำหรับ Azure Openai โปรดดูเอกสาร Azure Openai
แอพตัวอย่างนี้ได้รับการพัฒนาให้ใช้กับรุ่น gpt-4 นอกจากนี้ยังรองรับ gpt-35-turbo ในการใช้ gpt-35-turbo คุณต้องตั้งค่า isAzureOpenAiGpt4Model เป็น false (cf. Quickstart) โดยค่าเริ่มต้นตัวแปรพารามิเตอร์/สภาพแวดล้อมนี้ถูกตั้งค่าเป็น true ในการติดตั้งแอปพลิเคชันให้เสร็จสมบูรณ์คุณต้องตั้งค่าข้อมูลต่อไปนี้จากทรัพยากร Azure OpenAI:
azureOpenAiApiKey - Azure Openai API KeyazureOpenAiEndpoint - Azure Openai EndpointazureOpenAiDeploymentId -Azure OpenAI ID การปรับใช้ของรุ่น gpt-4 หรือ gpt-3.5-turbo คีย์ API และจุดสิ้นสุดสามารถพบได้ในพอร์ทัล Azure คุณสามารถทำตามคำแนะนำเหล่านี้: ดึงกุญแจและ enpoint ID การปรับใช้สอดคล้องกับ deployment name ในคู่มือนี้
วิศวกรรมที่รวดเร็วเป็นสิ่งสำคัญที่จะได้รับผลลัพธ์ที่ดีที่สุดจาก Azure Openai ข้อความแจ้งเป็นวิธีที่ผู้ใช้โต้ตอบกับรุ่น GPT เช่นเดียวกับโมเดลภาษาขนาดใหญ่ทั่วไป (LLM) รุ่น GPT พยายามที่จะสร้างคำชุดต่อไปที่มีแนวโน้มมากที่สุดที่จะติดตามข้อความก่อนหน้า มันเป็นเหมือนการขอโมเดล AI: สิ่งแรกที่นึกถึงเมื่อฉันพูด <prompt> ?
ด้วยการแชทเสร็จสิ้น API มีส่วนที่แตกต่างกันของพรอมต์ที่ส่งไปยัง API ที่เกี่ยวข้องกับบทบาทเฉพาะ: ระบบผู้ใช้และผู้ช่วย ข้อความระบบรวมอยู่ในช่วงเริ่มต้นของพรอมต์และใช้เพื่อให้คำแนะนำเริ่มต้นกับโมเดล: คำอธิบายของผู้ช่วยลักษณะบุคลิกภาพ, คำแนะนำ/กฎที่จะปฏิบัติตาม ฯลฯ
AI Shopping Cart Service ใช้ห้องสมุดไคลเอนต์ Azure OpenAI สำหรับ Java libary นี้เป็นส่วนหนึ่งของ Azure SDK สำหรับ Java มันถูกนำไปใช้เป็นแชทเสร็จสิ้น ในบริการเรามี 2 ข้อความระบบใน SystemMessageConstants.java: หนึ่งสำหรับการวิเคราะห์โภชนาการ AI และอีกหนึ่งรายการเพื่อสร้าง 3 สูตรสูงสุด ข้อความระบบตามด้วยข้อความผู้ใช้: The basket is: <list of items in the basket separated by a comma> ข้อความผู้ช่วยคือการตอบกลับจากโมเดล บริการนี้ใช้การช็อปปิ้ง cartairecommendations เพื่อโต้ตอบกับ Azure Openai ในชั้นเรียนนี้คุณจะพบรหัสที่รับผิดชอบในการสร้างพรอมต์และเรียก Azure OpenAI API: getChatCompletion หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับอุณหภูมิและ Topp ที่ใช้ในชั้นเรียนนี้โปรดดูเอกสารประกอบ
สำหรับรุ่น gpt-35-turbo มีการเพิ่มบริบทเพิ่มเติมลงในข้อความผู้ใช้ บริบทเพิ่มเติมนี้จะถูกเพิ่มในตอนท้ายของข้อความผู้ใช้ มันให้ข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบของ JSON ที่โมเดล OpenAI ต้องกลับมาและขอให้โมเดล TOR ส่งคืนเฉพาะ JSON โดยไม่มีข้อความเพิ่มเติม บริบทเพิ่มเติมนี้มีอยู่ใน usermessageconstants.java
เทมเพลตนี้มีโครงสร้างเพื่อติดตามการประชุมเทมเพลต CLI ของ Azure Developer คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับสถาปัตยกรรม azd ในเอกสารอย่างเป็นทางการ
ณ จุดนี้คุณมีแอปพลิเคชันที่สมบูรณ์ที่ติดตั้งบน Azure
สำหรับความต้องการขององค์กรการมองหาการปรับใช้แอปพลิเคชัน PolyGlot, การสนับสนุนส่วนประกอบ TANZU และการประกัน SLA เราขอแนะนำให้ใช้ Azure Spring Apps Enterprise ตรวจสอบ Azure Spring Apps Apps Landing Zone Accelerator ที่ให้คำแนะนำทางสถาปัตยกรรมที่ออกแบบมาเพื่อปรับปรุงการจัดเตรียมโครงสร้างพื้นฐานพร้อมการผลิตและการปรับใช้แอพพลิเคชั่นสปริงบู๊ตและสปริงคลาวด์ไปยังแอพ Azure Spring ในฐานะเจ้าของภาระงานให้ใช้คำแนะนำทางสถาปัตยกรรมที่มีให้ในตัวเร่งความเร็วโซน Landing เพื่อให้บรรลุสถานะทางเทคนิคเป้าหมายของคุณด้วยความมั่นใจ
คุณได้ปรับใช้แอปพลิเคชันตัวอย่างโดยใช้ Azure Developer CLI แต่มีอีกมากที่ CLI นักพัฒนา Azure สามารถทำได้ ขั้นตอนต่อไปเหล่านี้จะแนะนำให้คุณรู้จักกับคำสั่งเพิ่มเติมที่จะทำให้การสร้างแอปพลิเคชันบน 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 Model azd monitor - เพื่อตรวจสอบแอปพลิเคชันและนำทางไปยังแดชบอร์ดข้อมูลเชิงลึกของแอปพลิเคชันต่างๆ (เช่นภาพรวมตัวชี้วัดสดบันทึก)
เรียกใช้และดีบักในพื้นที่ - ใช้รหัส Visual Studio และ Azure Developer CLI Extension
azd เพิ่มเติม Azure Developer CLI มีคำสั่งอื่น ๆ อีกมากมายที่จะช่วยในการพัฒนา Azure Development ของคุณ คุณสามารถดูคำสั่งเหล่านี้ได้ที่เทอร์มินัลโดยใช้ azd help นอกจากนี้คุณยังสามารถดูรายการคำสั่งทั้งหมดในหน้าคำสั่ง CLI Azure Developer ของเรา
เหล่านี้เป็นแหล่งข้อมูลเพิ่มเติมที่คุณสามารถใช้เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแอปพลิเคชันตัวอย่างและเทคโนโลยีพื้นฐาน
ซอฟต์แวร์อาจรวบรวมข้อมูลเกี่ยวกับคุณและการใช้ซอฟต์แวร์ของคุณและส่งไปยัง Microsoft Microsoft อาจใช้ข้อมูลนี้เพื่อให้บริการและปรับปรุงผลิตภัณฑ์และบริการของเรา คุณสามารถปิด telemetry ตามที่อธิบายไว้ในที่เก็บ นอกจากนี้ยังมีคุณสมบัติบางอย่างในซอฟต์แวร์ที่อาจช่วยให้คุณและ Microsoft รวบรวมข้อมูลจากผู้ใช้แอปพลิเคชันของคุณ หากคุณใช้คุณสมบัติเหล่านี้คุณต้องปฏิบัติตามกฎหมายที่เกี่ยวข้องรวมถึงการแจ้งเตือนที่เหมาะสมแก่ผู้ใช้แอปพลิเคชันของคุณพร้อมกับสำเนาคำสั่งส่วนตัวของ Microsoft คำชี้แจงสิทธิ์ส่วนบุคคลของเราอยู่ที่ https://go.microsoft.com/fwlink/?linkid=521839 คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับการรวบรวมข้อมูลและใช้ในเอกสารช่วยเหลือและคำชี้แจงสิทธิ์ส่วนบุคคลของเรา การใช้ซอฟต์แวร์ของคุณทำงานตามความยินยอมของคุณในแนวทางปฏิบัติเหล่านี้
คอลเลกชัน Telemetry เปิดโดยค่าเริ่มต้น
หากต้องการยกเลิกการตั้งค่าตัวแปร enableTeleMetry เป็นเท็จใน infra/main.parameters.json หรือในเทมเพลต bicep infra/main.bicep สามารถตั้งค่าได้โดยใช้คำสั่งต่อไปนี้เมื่อการจัดเตรียมจะทำกับ Azure Developer CLI:
azd env set enableTelemetry false โครงการนี้อาจมีเครื่องหมายการค้าหรือโลโก้สำหรับโครงการผลิตภัณฑ์หรือบริการ การใช้เครื่องหมายการค้าหรือโลโก้ของ Microsoft ที่ได้รับอนุญาตขึ้นอยู่กับและต้องปฏิบัติตามแนวทางเครื่องหมายการค้าและแบรนด์ของ Microsoft การใช้เครื่องหมายการค้าหรือโลโก้ของ Microsoft ในรุ่นที่แก้ไขของโครงการนี้จะต้องไม่ทำให้เกิดความสับสนหรือบอกเป็นสปอนเซอร์ของ Microsoft การใช้เครื่องหมายการค้าหรือโลโก้ของบุคคลที่สามจะอยู่ภายใต้นโยบายของบุคคลที่สามเหล่านั้น
