java fm playground

☕ Java FM Playground

Selamat datang di taman bermain Java Foundation Model (FM), sebuah kotak pasir untuk menjelajahi integrasi Java dengan Amazon Bedrock .

Penting: Aplikasi ini adalah untuk tujuan pendidikan dan tidak dimaksudkan untuk penggunaan produksi.

Ringkasan

Repositori ini mencakup aplikasi boot pegas dan frontend Next.js , keduanya dapat dieksekusi secara lokal. Di bawah ini adalah tangkapan layar aplikasi yang sedang beraksi.

Penting

• Menjalankan aplikasi ini mungkin menghasilkan biaya ke akun AWS Anda. Untuk detail lebih lanjut, lihat harga Amazon Bedrock.
• Aplikasi ini dikonfigurasi untuk dijalankan di us-east-1 dan belum diuji di setiap wilayah AWS. Untuk informasi lebih lanjut, lihat Layanan Regional AWS.
• Kami menyarankan agar Anda memberikan kode paling tidak hak istimewa, yaitu hanya izin minimum yang diperlukan oleh aplikasi. Anda dapat menemukan dokumen kebijakan IAM dengan izin yang diperlukan dalam repositori ini di resources/bedrock-access-policy.json (Kebijakan Tampilan).

Prasyarat

Pastikan Anda telah menginstal berikut:

• Java JDK 17+ (misalnya Amazon Corretto, distro gratis dari JDK)
• Apache Maven untuk server backend
• Node.js (v18.17+) untuk aplikasi frontend
• Anda harus memiliki akun AWS, dan memiliki kredensial default dan wilayah AWS yang dikonfigurasi seperti yang dijelaskan dalam alat AWS dan panduan referensi konfigurasi dan kredensial yang dibagikan SDK.
• Anda harus meminta akses ke model sebelum dapat menggunakannya. Untuk informasi lebih lanjut, lihat Model Access. Untuk menjalankan aplikasi, Anda memerlukan akses ke model berikut di us-east-1 :
  • Antropik Claude
  • AI21 Labs Jurassic-2 Mid
  • Stabilitas difusi stabil AI xl

Menjalankan aplikasi

Setelah memverifikasi prasyarat, ikuti langkah -langkah ini:

Klon Repositori

Buka terminal, arahkan ke direktori pilihan Anda, dan jalankan perintah berikut:

git clone https://github.com/build-on-aws/java-fm-playground.git

Pengaturan Backend

Di direktori java-fm-playground/backend , run:

mvn spring-boot:run

Setelah server berjalan, Anda akan melihat output berikut:

...
2023-11-13T14:19:02.862+01:00  INFO 34848 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 55500 (http) with context path ' '
2023-11-13T14:19:02.868+01:00  INFO 34848 --- [main] a.c.e.b.SpringFmPlaygroundApplication    : Started SpringFmPlaygroundApplication in 1.415 seconds (process running for 1.659)

? Backend berjalan di port 55500 secara default. Lihat di bawah untuk perubahan port.

Pengaturan Frontend

Di jendela terminal baru , navigasikan ke direktori frontend dan instal paket yang diperlukan dengan menjalankan perintah berikut:

npm install

Setelah instalasi yang berhasil, Anda dapat memulai aplikasi Frontend dengan mengeksekusi perintah berikut:

npm run dev

Saat aplikasi sedang berjalan, Anda akan melihat output berikut:

 > [email protected] dev
> next dev

   ▲ Next.js 14.0.0
   - Local:        http://localhost:3000

 ✓ Ready in 3.3s

Mengakses aplikasi

Buka http://localhost:3000 di browser web Anda untuk berinteraksi dengan aplikasi.

Menghentikan aplikasi

Untuk menghentikan aplikasi, Anda harus menghentikan proses backend dan frontend.

Menghentikan frontend

Di terminal tempat frontend berjalan, tekan Ctrl + C untuk mengakhiri proses.

Menghentikan backend

Demikian pula, di terminal backend, gunakan pintasan Ctrl + C untuk menghentikan server.

Jika Anda menghadapi masalah apa pun, Anda dapat secara paksa menghentikan proses dengan menemukan ID Proses ( PID ) dan menggunakan perintah kill pada sistem berbasis UNIX atau manajer tugas di Windows.

Menggunakan port yang berbeda

Ubah port backend di file berikut:

• backend/src/main/resources/application.yml
• frontend/app/app.config.js

Untuk menjalankan frontend pada port yang berbeda:

npm run dev -- --port NEW_PORT

Pemecahan masalah

Wilayah AWS dikodekan dalam aplikasi. Namun, jika variabel lingkungan AWS_REGION lokal Anda diatur ke wilayah yang berbeda, aplikasi mungkin gagal. Dalam hal ini, pastikan untuk unsect AWS_REGION , atau atur ke us-east-1 .

Lisensi

Perpustakaan ini dilisensikan di bawah lisensi MIT-0. Lihat file lisensi.

Keamanan

Lihat berkontribusi untuk informasi lebih lanjut.