الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Genai Spring Petclinic Sample Application Build with langchain4j

فهم تطبيق الربيع petclinic langchain4j

تمت إضافة chatbot باستخدام الذكاء الاصطناعي التوليدي إلى تطبيق الربيع الشهير petclinic. يستخدم هذا الإصدار مشروع LangChain4J ويدعم حاليًا Openai أو Azure's Openai كمزود LLM . هذا هو شوكة من Spring-Petclinic-AI على أساس الربيع الذكاء الاصطناعي.

توضح هذه العينة كيفية دمج قدرات AI/LLM بسهولة في تطبيق Java باستخدام Langchain4J . يمكن تحقيق ذلك بفضل:

  • طبقة تجريد موحدة مصممة لفصل الكود الخاص بك من تطبيقات محددة مثل LLM أو مزودي التضمين ، مما يتيح تبديل مكونات سهلة. فقط Application.Properties File File References LLM Serviders مثل Openai أو Azure Openai.
  • توفر الذاكرة سياقًا إلى LLM لكل من المحادثات الحالية والسابقة ، بدعم من عدة مستخدمين. ارجع إلى استخدام فئة MessageWindowChatMemory في AssistantConfiguration وشرح @MemoryId في الواجهة المساعدة.
  • تتيح خدمات الذكاء الاصطناعي التعاريف التعريفية لسلوكيات الذكاء الاصطناعى المعقدة من خلال واجهة برمجة تطبيقات Java مباشرة. انظر استخدام شرح @AiService في الواجهة المساعدة.
  • تلعب مطالبات النظام دورًا حيويًا في LLMS لأنها تشكل كيفية تفسير النماذج والاستجابة لاستفسارات المستخدمين. انظر إلى استخدام التعليق التوضيحي @SystemMessage في الواجهة المساعدة.
  • تدفق الرمز المميز للاستجابة عند استخدام نوع إرجاع TokenStream ودعم أحداث SPRING Server-Sent . ألق نظرة على وحدة تحكم REST AssistantController
  • تتيح استدعاء الوظيفة أو الأدوات لـ LLM الاتصال ، عند الضرورة ، طرق Java واحدة أو أكثر. يعلن مكون AssistantTool وظائف باستخدام التعليق @Tool من Langchain4J.
  • تسمح المخرجات المهيكلة باستلام استجابات LLM بتنسيق محدد مثل Java Pojos. يستخدم AssistantTool سجلات Java كهيكل بيانات LLM/ الإدخال/ الإخراج.
  • يمكّن الجيل المتمثل في الاسترجاع (RAG) LLM من دمج واستجابة بيانات محددة-مثل بيانات من قاعدة بيانات petclinic-عن طريق تناولها والرجوع إليها أثناء التفاعلات. يعلن AssistantConfiguration عن EmbeddingModel ، InMemoryEmbeddingStore و EmbeddingStoreContentRetriever Beans ، بينما يتولى فئة inmbeddingstoreinit تناول بيانات البيانات عند بدء التشغيل. يوضح VetqueryRouter كيفية تخطي استرجاع مشروط ، مع اتخاذ القرارات مدفوعة بواسطة LLM.

يدمج Spring petclinic chatbot يسمح لك بالتفاعل مع التطبيق بلغة طبيعية. فيما يلي بعض الأمثلة على ما يمكن أن تسأل:

  1. يرجى سرد المالكين الذين يأتون إلى العيادة.
  2. كم عدد أطباء القلب البيطري هناك؟
  3. هل يوجد مالك يدعى بيتي؟ ما هو اسمها الأخير؟
  4. أي من المالكين لديهم الكلاب؟
  5. أضف كلبًا لبيتي. اسمها موبسي. عيد ميلاده في 2 أكتوبر 2024.
  6. أضف زيارة اليوم إلى Moopsie.

لقطة شاشة للحوار دردشة

يدعم Spring Petclinic حاليًا Openai أو Azure's 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 الخاصة بك. ارجع إلى وثائق Quickstart أو Azure الخاصة بـ Openai لمزيد من المعلومات حول كيفية الحصول على هذه. ما عليك سوى ملء المزود الذي تستخدمه - إما 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. اتبع القسم التالي Run Petclinic محليًا

تشغيل petclinic محليا

Spring Petclinic هو تطبيق Boot Spring تم تصميمه باستخدام Maven أو Gradle. يمكنك إنشاء ملف جرة وتشغيله من سطر الأوامر (يجب أن يعمل أيضًا مع 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/.

لقطة شاشة لقائمة أصحاب Finding

أو يمكنك تشغيله من Maven مباشرة باستخدام البرنامج المساعد Maven Spring Boot Maven. إذا قمت بذلك ، فسيتم اختيار التغييرات التي تقوم بها في المشروع على الفور (تتطلب التغييرات على ملفات مصدر Java تجميعًا أيضًا - معظم الأشخاص يستخدمون IDE لهذا الغرض): 

./mvnw spring-boot:run

ملاحظة: build/libs كنت تفضل استخدام Gradle ، فيمكنك إنشاء التطبيق باستخدام ./gradlew build

بناء حاوية

لا يوجد Dockerfile في هذا المشروع. يمكنك إنشاء صورة حاوية (إذا كان لديك Docker Daemon) باستخدام البرنامج المساعد Boot 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 for postgresql. راجع وثائق Boot Spring لمزيد من التفاصيل حول كيفية تعيين ملف التعريف النشط.

يمكنك بدء تشغيل 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 الافتراضية وأيضًا إضافة devtools Spring Boot) ، و MySqlTestApplication و PostgresIntegrationTests . يتم إعدادها حتى تتمكن من تشغيل التطبيقات في IDE للحصول على ردود فعل سريعة وأيضًا تشغيل نفس الفئات مثل اختبارات التكامل مقابل قاعدة البيانات المعنية. تستخدم اختبارات تكامل MySQL TestContainers لبدء قاعدة البيانات في حاوية Docker ، وتستخدم اختبارات Postgres Docker لفعل الشيء نفسه.

تجميع CSS

هناك petclinic.css في src/main/resources/static/resources/css . تم إنشاؤه من مصدر petclinic.scss ، جنبا إلى جنب مع مكتبة bootstrap. إذا قمت بإجراء تغييرات على scss ، أو ترقية Bootstrap ، فستحتاج إلى إعادة تجميع موارد CSS باستخدام ./mvnw package -P css تعريف Maven "CSS" ، أي. لا يوجد ملف تعريف بناء لتجميع Gradle لتجميع CSS.

العمل مع petclinic في IDE الخاص بك

المتطلبات الأساسية

يجب تثبيت العناصر التالية في نظامك:

  • Java 17 أو الأحدث (Full JDK ، وليس JRE)
  • أداة سطر أوامر GIT
  • IDE المفضل لديك
    • الكسوف مع المكون الإضافي M2E. ملاحظة: عند توفر M2E ، يوجد رمز M2 في Help -> About الحوار. إذا لم يكن M2E موجودًا ، فاتبع عملية التثبيت هنا
    • جناح أدوات الربيع (STS)
    • فكرة Intellij
    • مقابل الكود

خطوات

  1. في تشغيل سطر الأوامر: 

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

  2. داخل الكسوف أو STS:

    افتح المشروع عبر File -> Import -> Maven -> Existing Maven project ، ثم حدد الدليل الجذري لإعادة الاستنساخ.

    Run As -> Maven install إما بناء على سطر الأوامر ./mvnw generate-resources قم بتشغيل الطريقة الرئيسية للتطبيق من خلال النقر بزر الماوس الأيمن على ذلك واختيار Run As -> Java Application .

  3. فكرة Intellij:

    في القائمة الرئيسية ، اختر File -> Open وحدد pom.xml petclinic. انقر على الزر Open .

    • يتم إنشاء ملفات CSS من Build Maven. spring-petclinic إنشاءها Maven -> Generates sources and Update Folders سطر الأوامر ./mvnw generate-resources

    • يجب إنشاء تكوين تشغيل يدعى PetClinicApplication لك إذا كنت تستخدم إصدارًا نهائيًا حديثًا. خلاف ذلك ، قم بتشغيل التطبيق بالنقر بزر الماوس الأيمن على الفئة الرئيسية PetClinicApplication واختيار Run 'PetClinicApplication' .

  4. انتقل إلى petclinic

    تفضل بزيارة http: // localhost: 8080 في متصفحك.

تبحث عن شيء على وجه الخصوص؟

تكوين الحذاء الربيعي ملفات فئة أو جافا
الطبقة الرئيسية petclinicapplication
خصائص ملفات application.properties
التخزين المؤقت تكوين cacheconfiguration

فروع وشوكات الربيع المثيرة للاهتمام

إن الفرع الربيعي "الرئيسي" الرئيسي في الربيع GitHub Org هو التنفيذ "الكنسي" استنادًا إلى الحذاء الربيعي والثني. هناك عدد غير قليل من الشوكات في github org spring-petclinic. إذا كنت مهتمًا باستخدام مكدس تقني مختلف لتنفيذ عيادة الحيوانات الأليفة ، فيرجى الانضمام إلى المجتمع هناك.

التفاعل مع مشاريع أخرى مفتوحة المصدر

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

اسم مشكلة
Spring JDBC: تبسيط استخدام nameparameterjdbctemplate SPR-10256 و SPR-10257
التحقق من صحة الفاصوليا / صحة السبات: تبسيط تبعيات Maven والتوافق الخلفي HV-790 و HV-792
بيانات الربيع: توفير المزيد من المرونة عند العمل مع استعلامات JPQL DataJPA-292

المساهمة

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

لطلبات السحب ، تتوفر تفضيلات المحرر في تكوين المحرر لسهولة الاستخدام في محرري النص المشترك. اقرأ المزيد وقم بتنزيل الإضافات على https://editorconfig.org. إذا لم تكن قد قمت بذلك من قبل ، فيرجى ملء اتفاقية ترخيص المساهم وتقديمها.

رخصة

يتم إصدار تطبيق عينة الربيع petclinic ضمن الإصدار 2.0 من ترخيص Apache.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل