spring petclinic langchain4j

แอปพลิเคชันตัวอย่าง Genai Spring Petclinic สร้างด้วย langchain4j

ทำความเข้าใจกับแอปพลิเคชัน Spring Petclinic Langchain4J

chatbot ที่ใช้ AI Generative ถูกเพิ่มเข้าไปในแอปพลิเคชัน Petclinic ที่มีชื่อเสียง รุ่นนี้ใช้ โครงการ Langchain4J และปัจจุบันรองรับ OpenAI หรือ Azure ของ OpenAI ในฐานะ ผู้ให้บริการ LLM นี่คือส้อมจาก Spring-Petclinic-AI บนพื้นฐานของฤดูใบไม้ผลิ AI

ตัวอย่างนี้แสดงให้เห็นถึงวิธี การรวมความสามารถของ AI/LLM เข้ากับแอปพลิเคชัน Java โดยใช้ Langchain4J สามารถทำได้ขอบคุณ:

• เลเยอร์ที่เป็น นามธรรมแบบครบวงจรที่ออกแบบมาเพื่อแยกรหัสของคุณจากการใช้งานเฉพาะเช่น LLM หรือผู้ให้บริการฝังตัวทำให้สามารถเปลี่ยนส่วนประกอบได้ง่าย เฉพาะแอปพลิเคชันไฟล์อ้างอิงผู้ให้บริการ LLM เช่น OpenAI หรือ Azure OpenAI
• หน่วยความจำนำ เสนอบริบทให้กับ LLM สำหรับการสนทนาทั้งในปัจจุบันและก่อนหน้านี้โดยรองรับผู้ใช้หลายคน อ้างถึงการใช้คลาส MessageWindowChatMemory ใน AssistantConfiguration และ @MemoryId Annotation ในอินเทอร์เฟซผู้ช่วย
• บริการ AI ช่วยให้คำจำกัดความของพฤติกรรม AI ที่ซับซ้อนผ่าน Java API ที่ตรงไปตรงมา ดูการใช้คำอธิบายประกอบ @AiService ในส่วนประกอบผู้ช่วย
• ระบบพร้อมที่จะ มีบทบาทสำคัญใน LLMs เนื่องจากเป็นรูปแบบที่โมเดลตีความและตอบสนองต่อการสืบค้นผู้ใช้ ดูการใช้คำอธิบายประกอบ @SystemMessage ในอินเทอร์เฟซผู้ช่วย
• การสตรีม การตอบสนองต่อการสตรีมโทเค็นโดยอาสาสมัครเมื่อใช้ประเภท TokenStream Return และ เหตุการณ์ Server-Server-sent รองรับ ลองดูที่ผู้ช่วย REST AssistantController
• การเรียกใช้ฟังก์ชั่น หรือ เครื่องมือ ช่วยให้ LLM สามารถโทรได้เมื่อจำเป็นวิธี Java หนึ่งวิธีขึ้นไป ส่วนประกอบ AssistantTool ประกาศฟังก์ชั่นโดยใช้คำอธิบายประกอบ @Tool จาก langchain4j
• เอาต์พุตที่มีโครงสร้าง ช่วยให้การตอบสนอง LLM ได้รับในรูปแบบที่ระบุเป็น Java Pojos AssistantTool ใช้ระเบียน Java เป็นโครงสร้างข้อมูล LLM/ อินพุต/ เอาต์พุต
• Retrieval-Augmented Generation (RAG) ช่วยให้ LLM สามารถรวมและตอบสนองตามข้อมูลเฉพาะ-เช่นข้อมูลจากฐานข้อมูล PetClinic-โดยการบริโภคและการอ้างอิงในระหว่างการโต้ตอบ AssistantConfiguration ประกาศ EmbeddingModel , InMemoryEmbeddingStore และ EmbeddingStoreContentRetriever Beans ในขณะที่ EmbeddingStoreInit จัดการกับการบริโภคข้อมูลสัตวแพทย์เมื่อเริ่มต้น VetQueryRouter แสดงให้เห็นถึงวิธีการข้ามการดึงข้อมูลอย่างมีเงื่อนไขด้วยการตัดสินใจที่ขับเคลื่อนโดย LLM

Spring Petclinic รวม chatbot ที่ช่วยให้คุณสามารถโต้ตอบกับแอปพลิเคชันในภาษาธรรมชาติ นี่คือ ตัวอย่าง ของสิ่งที่คุณถามได้:

1. โปรดแสดงรายการเจ้าของที่มาที่คลินิก
2. มีโรคหัวใจสัตวแพทย์กี่คน?
3. มีเจ้าของชื่อเบ็ตตี้หรือไม่? นามสกุลของเธอคืออะไร?
4. เจ้าของคนไหนมีสุนัข?
5. เพิ่มสุนัขสำหรับเบ็ตตี้ ชื่อของมันคือ Moopsie วันเกิดของเขาคือวันที่ 2 ตุลาคม 2567
6. เพิ่มการเยี่ยมชม Moopsie ในวันนี้

Spring Petclinic ปัจจุบันรองรับ OpenAI หรือ Azure ของ OpenAI ในฐานะผู้ให้บริการ LLM เพื่อเริ่ม spring-petlinic-langchain4j ทำตามขั้นตอนต่อไปนี้:

1. ตัดสินใจว่าผู้ให้บริการรายใดที่คุณต้องการใช้ โดยค่าเริ่มต้นการพึ่งพา langchain4j-open-ai-spring-boot-starter ถูกเปิดใช้งาน คุณสามารถเปลี่ยนเป็น langchain4j-azure-open-ai-spring-boot-starter ทั้งใน pom.xml หรือใน build.gradle ขึ้นอยู่กับเครื่องมือสร้างที่คุณเลือก
2. สร้างคีย์ OpenAI API หรือทรัพยากร Azure OpenAI ในพอร์ทัล Azure ของคุณ อ้างถึงเอกสารประกอบของ OpenAI ของ OpenAI หรือ Azure สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการรับสิ่งเหล่านี้ คุณจะต้องเติมผู้ให้บริการที่คุณใช้ - Openai หรือ Azure -Openai หากคุณไม่มีคีย์ OpenAI API ของคุณเองไม่ต้องกังวล! คุณสามารถใช้คีย์ demo ได้ชั่วคราวซึ่ง OpenAI มอบให้ฟรีเพื่อการสาธิต คีย์ demo นี้มีโควต้า จำกัด เฉพาะโมเดล GPT-4O-MINI และมีไว้สำหรับการใช้การสาธิตเท่านั้น
3. ส่งออกคีย์ API และจุดสิ้นสุดของคุณเป็นตัวแปรสภาพแวดล้อม:
   • Openai:

    export OPENAI_API_KEY= " your_api_key_here "

   • หรือ Azure Openai:

    export AZURE_OPENAI_ENDPOINT= " https://your_resource.openai.azure.com "
   export AZURE_OPENAI_KEY= " your_api_key_here "

4. ติดตามส่วนถัดไปเรียกใช้ petclinic ในพื้นที่

เรียกใช้ petclinic ในพื้นที่

Spring Petclinic เป็นแอพพลิเคชั่นการบูตสปริงที่สร้างขึ้นโดยใช้ Maven หรือ Gradle คุณสามารถสร้างไฟล์ jar และเรียกใช้จากบรรทัดคำสั่ง (ควรใช้งานได้ดีกับ Java 17 หรือใหม่กว่า):

git clone https://github.com/spring-petclinic/spring-petclinic-langchain4j.git
cd spring-petclinic
./mvnw package
java -jar target/ * .jar

จากนั้นคุณสามารถเข้าถึง petclinic ได้ที่ http: // localhost: 8080/

หรือคุณสามารถเรียกใช้จาก Maven โดยตรงโดยใช้ปลั๊กอินสปริงบูต Maven หากคุณทำเช่นนี้มันจะรับการเปลี่ยนแปลงที่คุณทำในโครงการทันที (การเปลี่ยนแปลงไฟล์ต้นฉบับ Java ต้องมีการรวบรวมเช่นกัน - คนส่วนใหญ่ใช้ IDE สำหรับสิ่งนี้):

./mvnw spring-boot:run

หมายเหตุ: หากคุณต้องการใช้ Gradle คุณสามารถสร้างแอพโดยใช้ ./gradlew build และค้นหาไฟล์ jar ใน build/libs

การสร้างภาชนะ

ไม่มี Dockerfile ในโครงการนี้ คุณสามารถสร้างอิมเมจคอนเทนเนอร์ (ถ้าคุณมี Docker daemon) โดยใช้ปลั๊กอิน Boot Spring Boot:

./mvnw spring-boot:build-image

ในกรณีที่คุณพบข้อผิดพลาด/การปรับปรุงที่แนะนำสำหรับฤดูใบไม้ผลิ petclinic

ตัวติดตามปัญหาของเรามีอยู่ที่นี่

การกำหนดค่าฐานข้อมูล

ในการกำหนดค่าเริ่มต้น PetClinic ใช้ฐานข้อมูลในหน่วยความจำ (H2) ซึ่งได้รับการเติมเมื่อเริ่มต้นด้วยข้อมูล คอนโซล H2 ถูกเปิดเผยที่ http://localhost:8080/h2-console และเป็นไปได้ที่จะตรวจสอบเนื้อหาของฐานข้อมูลโดยใช้ jdbc:h2:mem:<uuid> url UUID ถูกพิมพ์เมื่อเริ่มต้นไปยังคอนโซล

มีการตั้งค่าที่คล้ายกันสำหรับ MySQL และ PostgreSQL หากจำเป็นต้องมีการกำหนดค่าฐานข้อมูลแบบถาวร โปรดทราบว่าเมื่อใดก็ตามที่ประเภทฐานข้อมูลเปลี่ยนไปแอปจะต้องทำงานด้วยโปรไฟล์อื่น: spring.profiles.active=mysql สำหรับ MySQL หรือ spring.profiles.active=postgres สำหรับ PostgreSQL ดูเอกสารประกอบสปริงสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการตั้งค่าโปรไฟล์ที่ใช้งานอยู่

คุณสามารถเริ่ม MySQL หรือ postgreSQL ในเครื่องด้วยตัวติดตั้งใด ๆ ที่ใช้งานได้สำหรับระบบปฏิบัติการของคุณหรือใช้ Docker:

docker run -e MYSQL_USER=petclinic -e MYSQL_PASSWORD=petclinic -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:8.4

หรือ

docker run -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -e POSTGRES_DB=petclinic -p 5432:5432 postgres:16.3

มีการจัดทำเอกสารเพิ่มเติมสำหรับ MySQL และ PostgreSQL

แทนที่จะเป็น Vanilla docker คุณยังสามารถใช้ไฟล์ docker-compose.yml ที่ให้ไว้เพื่อเริ่มต้นคอนเทนเนอร์ฐานข้อมูล แต่ละคนมีโปรไฟล์เช่นเดียวกับโปรไฟล์สปริง:

docker-compose --profile mysql up

หรือ

docker-compose --profile postgres up

ทดสอบแอปพลิเคชัน

ในเวลาพัฒนาเราขอแนะนำให้คุณใช้แอปพลิเคชันทดสอบที่ตั้งค่าเป็นวิธีการ main() ใน PetClinicIntegrationTests (ใช้ฐานข้อมูล H2 เริ่มต้นและยังเพิ่ม Spring Boot Devtools), MySqlTestApplication และ PostgresIntegrationTests สิ่งเหล่านี้ถูกตั้งค่าเพื่อให้คุณสามารถเรียกใช้แอพใน IDE ของคุณเพื่อรับข้อเสนอแนะที่รวดเร็วและเรียกใช้คลาสเดียวกันกับการทดสอบการรวมกับฐานข้อมูลที่เกี่ยวข้อง การทดสอบการรวม MySQL ใช้ testContainers เพื่อเริ่มฐานข้อมูลในคอนเทนเนอร์ Docker และการทดสอบ Postgres ใช้ Docker เขียนเพื่อทำสิ่งเดียวกัน

รวบรวม CSS

มี petclinic.css ใน src/main/resources/static/resources/css มันถูกสร้างขึ้นจากแหล่ง petclinic.scss รวมกับไลบรารี bootstrap หากคุณทำการเปลี่ยนแปลง scss หรืออัพเกรด bootstrap คุณจะต้องคอมไพล์ทรัพยากร CSS อีกครั้งโดยใช้โปรไฟล์ Maven "CSS" เช่น ./mvnw package -P css ไม่มีโปรไฟล์การสร้างสำหรับ Gradle เพื่อรวบรวม CSS

ทำงานกับ Petclinic ใน IDE ของคุณ

ข้อกำหนดเบื้องต้น

ควรติดตั้งรายการต่อไปนี้ในระบบของคุณ:

• Java 17 หรือใหม่กว่า (เต็ม JDK ไม่ใช่ JRE)
• เครื่องมือบรรทัดคำสั่ง git
• IDE ที่คุณต้องการ
  • Eclipse พร้อมปลั๊กอิน M2E หมายเหตุ: เมื่อมี M2E มีไอคอน M2 ใน Help -> About กล่องโต้ตอบ หาก M2E ไม่อยู่ที่นั่นให้ทำตามกระบวนการติดตั้งที่นี่
  • Spring Tools Suite (STS)
  • Intellij Idea
  • รหัส VS

ขั้นตอน

1. บนบรรทัดคำสั่งเรียกใช้:

   git clone https://github.com/spring-petclinic/spring-petclinic-langchain4j.git

2. ภายใน eclipse หรือ STS:

   เปิดโครงการผ่าน File -> Import -> Maven -> Existing Maven project จากนั้นเลือกไดเรกทอรีรูทของ repo ที่ถูกโคลน

   จากนั้นสร้างขึ้นบนบรรทัดคำสั่ง ./mvnw generate-resources หรือใช้ตัวเรียกใช้ Eclipse (คลิกขวาในโครงการและ Run As -> Maven install ) เพื่อสร้าง CSS เรียกใช้วิธีหลักของแอปพลิเคชันโดยคลิกขวาที่มันและเลือก Run As -> Java Application

3. Inside Intellij Idea:

   ในเมนูหลักเลือก File -> Open และเลือก petclinic pom.xml คลิกที่ปุ่ม Open

   • ไฟล์ CSS ถูกสร้างขึ้นจาก Maven Build คุณสามารถสร้างพวกเขาในบรรทัดคำสั่ง ./mvnw generate-resources หรือคลิกขวาในโครงการ spring-petclinic จากนั้น Maven -> Generates sources and Update Folders

   • การกำหนดค่าการเรียกใช้ชื่อ PetClinicApplication ควรถูกสร้างขึ้นสำหรับคุณหากคุณใช้เวอร์ชัน Ultimate ล่าสุด มิฉะนั้นให้เรียกใช้แอปพลิเคชันโดยคลิกขวาที่คลาส Main PetClinicApplication และเลือก Run 'PetClinicApplication'

4. นำทางไปยัง petclinic

   เยี่ยมชม http: // localhost: 8080 ในเบราว์เซอร์ของคุณ

กำลังมองหาบางสิ่งบางอย่างโดยเฉพาะ?

การกำหนดค่าสปริงบูต	ไฟล์คลาสหรือ Java คุณสมบัติ
คลาสหลัก	Petclinicapplication
ไฟล์คุณสมบัติ	Application.properties
การแคช	cacheconfiguration

สาขา Petclinic ในฤดูใบไม้ผลิที่น่าสนใจและส้อม

สาขา Spring Petclinic "Main" ในโครงการฤดูใบไม้ผลิ GitHub org คือการใช้งาน "Canonical" โดยใช้สปริงบูตและ thymeleaf มีส้อมไม่กี่แห่งใน GitHub org Spring-Petclinic หากคุณสนใจที่จะใช้สแต็กเทคโนโลยีที่แตกต่างกันเพื่อใช้งานคลินิกสัตว์เลี้ยงโปรดเข้าร่วมชุมชนที่นั่น

ปฏิสัมพันธ์กับโครงการโอเพนซอร์ซอื่น ๆ

หนึ่งในส่วนที่ดีที่สุดเกี่ยวกับการทำงานกับแอปพลิเคชัน Spring Petclinic คือเรามีโอกาสทำงานติดต่อโดยตรงกับโครงการโอเพ่นซอร์สหลายโครงการ เราพบข้อบกพร่อง/การปรับปรุงที่แนะนำในหัวข้อต่าง ๆ เช่นฤดูใบไม้ผลิข้อมูลฤดูใบไม้ผลิการตรวจสอบถั่วและแม้แต่คราส! ในหลายกรณีพวกเขาได้รับการแก้ไข/นำไปใช้ในเวลาเพียงไม่กี่วัน นี่คือรายการของพวกเขา:

ชื่อ	ปัญหา
Spring JDBC: ลดความซับซ้อนของการใช้งานของ parameterjdbctemplate	SPR-10256 และ SPR-10257
การตรวจสอบความถูกต้องของถั่ว / hibernate ตรวจสอบ: ทำให้การพึ่งพา maven ง่ายขึ้นและความเข้ากันได้ย้อนหลัง	HV-790 และ HV-792
ข้อมูลฤดูใบไม้ผลิ: ให้ความยืดหยุ่นมากขึ้นเมื่อทำงานกับคิวรี JPQL	datajpa-292

การบริจาค

ตัวติดตามปัญหาเป็นช่องทางที่ต้องการสำหรับรายงานข้อผิดพลาดคำขอคุณสมบัติและการส่งคำขอดึง

สำหรับคำขอดึงการตั้งค่าตัวแก้ไขมีอยู่ในตัวแก้ไขการกำหนดค่าเพื่อใช้งานง่ายในตัวแก้ไขข้อความทั่วไป อ่านเพิ่มเติมและดาวน์โหลดปลั๊กอินได้ที่ https://editorconfig.org หากคุณยังไม่เคยทำมาก่อนโปรดกรอกและส่งข้อตกลงใบอนุญาตผู้สนับสนุน

ใบอนุญาต

แอปพลิเคชันตัวอย่าง Spring Petclinic ถูกปล่อยออกมาภายใต้ใบอนุญาต Apache เวอร์ชัน 2.0