java fm playground

hava java fm遊び場

Java Foundation Model（FM）Playground、 Amazon BedrockとのJava統合を探索するためのサンドボックスへようこそ。

重要：このアプリケーションは、教育目的であり、生産の使用を目的としていません。

概要

このリポジトリには、スプリングブートアプリケーションとnext.jsフロントエンドが含まれ、どちらもローカルで実行可能です。以下は、動作中のアプリのスクリーンショットです。

重要

• このアプリケーションを実行すると、AWSアカウントに料金がかかる場合があります。詳細については、Amazon Bedrock Pricingを参照してください。
• このアプリはus-east-1で実行されるように構成されており、すべてのAWS地域でテストされていません。詳細については、AWSリージョナルサービスを参照してください。
• コードの最小特権、つまりアプリケーションで必要な最小許可のみを付与することをお勧めします。 resources/bedrock-access-policy.json （ディスプレイポリシー）のこのリポジトリに必要な権限を備えたIAMポリシードキュメントを見つけることができます。

前提条件

次のインストールを確認してください。

• Java JDK 17+（例：Amazon Correetto、JDKの無料ディストリビューション）
• バックエンドサーバー用のApache Maven
• フロントエンドアプリケーション用のnode.js（v18.17+）
• AWSアカウントを持っている必要があり、AWSツールとSDKS共有構成と資格情報リファレンスガイドで説明されているように、デフォルトの資格情報とAWS領域を構成する必要があります。
• モデルを使用する前に、モデルへのアクセスを要求する必要があります。詳細については、モデルアクセスを参照してください。アプリを実行するには、 us-east-1で次のモデルにアクセスする必要があります。
  • 人類のクロード
  • AI21 LABS JURASSIC-2 MID
  • 安定性AI安定拡散XL

アプリケーションの実行

前提条件を確認した後、次の手順に従ってください。

リポジトリをクローンします

端末を開き、選択したディレクトリに移動し、次のコマンドを実行します。

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

バックエンドのセットアップ

java-fm-playground/backendディレクトリで、実行してください。

mvn spring-boot:run

サーバーが実行されると、次の出力が表示されます。

...
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)

？バックエンドは、デフォルトでポート55500で実行されます。ポートの変更については、以下を参照してください。

フロントエンドのセットアップ

新しいターミナルウィンドウで、 frontendディレクトリに移動し、次のコマンドを実行して必要なパッケージをインストールします。

npm install

インストールが成功した後、次のコマンドを実行して、FrontEndアプリケーションを開始できます。

npm run dev

アプリケーションが実行されているとき、次の出力が表示されます。

 > [email protected] dev
> next dev

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

 ✓ Ready in 3.3s

アプリケーションへのアクセス

http://localhost:3000開き、アプリケーションと対話します。

アプリケーションの停止

アプリケーションを停止するには、バックエンドプロセスとフロントエンドプロセスの両方を停止する必要があります。

フロントエンドを停止します

フロントエンドが実行されている端子で、 Ctrl + Cを押してプロセスを終了します。

バックエンドを停止します

同様に、バックエンド端子では、 Ctrl + Cショートカットを使用してサーバーを停止します。

問題が発生した場合は、プロセスID（ PID ）を見つけて、UNIXベースのシステムまたはWindowsのタスクマネージャーでkillコマンドを使用することにより、プロセスを強制的に終了できます。

さまざまなポートを使用します

次のファイルのバックエンドポートを変更します。

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

別のポートでフロントエンドを実行するには：

npm run dev -- --port NEW_PORT

トラブルシューティング

AWS地域はアプリケーションでハードコーディングされています。ただし、ローカルAWS_REGION環境変数が別の地域に設定されている場合、アプリケーションが失敗する可能性があります。この場合、 AWS_REGIONを設定するか、 us-east-1に設定してください。

ライセンス

このライブラリは、MIT-0ライセンスに基づいてライセンスされています。ライセンスファイルを参照してください。

安全

詳細については、貢献を参照してください。