Spring Ai Resos

🚀 Spring AI ResOs チャットボットの開発

このプロジェクトは、Spring AI をベースにした ResOs チャットボットを開発することを目的としています。OpenAI、Groq Cloud、OpenRouter などの AI プロバイダとの統合をサポートしています。以下に詳細な開発ガイドを示します。

🚀 クイックスタート

1. プロジェクトのダウンロード

GitHub からプロジェクトリポジトリをクローンします。

git clone https://github.com/your-repository/spring-ai-resos.git
cd spring-ai-resos

2. プロジェクトの依存関係

以下の依存関係が pom.xml ファイルに追加されていることを確認してください。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>com.azure.ai</groupId>
    <artifactId>azure-ai-textanalytics</artifactId>
</dependency>

3. 設定ファイル

config フォルダを作成し、以下の設定ファイルを追加します。

application.yml

server:
  port: 8081

spring:
  ai:
    openai:
      enabled: true
      api-key: sk-your-openai-api-key
    groq:
      enabled: false
      api-key: your-groq-api-key
    openrouter:
      enabled: false
      api-key: your-openrouter-api-key

logback-spring.xml

<configuration>
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <layout class="ch.qos.logback.classic.PatternLayout">
      <pattern>%d{HH:mm:ss.SSS} %level - %msg%n</pattern>
    </layout>
  </appender>

  <root level="INFO">
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

4. アプリケーションの起動

プロジェクトのルートディレクトリで以下のコマンドを実行して、チャットボットを起動します。

mvn spring-boot:run

✨ 主な機能

• 複数の AI プロバイダとの統合：OpenAI、Groq Cloud、OpenRouter などの AI プロバイダと統合可能です。
• テキスト埋め込み：テキストをベクトル表現に変換し、後続の処理を容易にします。
• カスタムモデルのサポート：application.yml で設定することで、カスタム AI モデルを統合できます。

📦 インストール

上述の「クイックスタート」セクションを参照して、プロジェクトをダウンロード、依存関係を設定、設定ファイルを追加、アプリケーションを起動してください。

💻 使用例

基本的な使用法

1. Web 界面のアクセス

ブラウザを開き、http://localhost:8081 にアクセスします。

2. クエリの入力

テキストボックスに質問や命令を入力します。例えば：

• "今日の天気はどうですか？"
• "メールを書いてください。"

3. 結果の取得

「送信」ボタンをクリックし、数秒待つと、AI プロバイダからの結果が表示されます。

高度な使用法

テキスト埋め込み

String text = "Hello, world!";
Vector embedding = textEmbeddingService.embedText(text);
System.out.println(embedding);

📚 ドキュメント

サポートされる AI プロバイダ

OpenAI

• 有効化: spring.ai.openai.enabled を true に設定します。
• 設定: application.yml に OpenAI API キーを追加します。

Groq Cloud

• 有効化: spring.ai.groq.enabled を true に設定します。
• 設定: application.yml に Groq API キーを追加します。

OpenRouter

• 有効化: spring.ai.openrouter.enabled を true に設定します。
• 設定: application.yml に OpenRouter API キーを追加します。

拡張機能

テキスト埋め込み

テキストをベクトル表現に変換することができ、後続の処理に利用できます。

カスタムモデル

application.yml で設定することで、カスタム AI モデルを統合できます。

🔧 技術詳細

本プロジェクトは Spring AI をベースに構築されており、spring-boot-starter-web を使用して Web アプリケーションを開発しています。また、azure-ai-textanalytics を利用してテキスト分析を行っています。設定ファイルで AI プロバイダの API キーを管理し、アプリケーションを起動することで、チャットボットを利用できます。

プロジェクト構造

• backend: チャットボットのバックエンドロジックを含み、AI プロバイダとのやり取りを行います。
• mcp-server: 最小限の実用的な製品（MVP）サーバーモジュールで、ユーザーのクエリリクエストを受け取り、処理します。
• mcp-client: 最小限の実用的な製品（MVP）クライアントモジュールで、サーバーにリクエストを送信し、結果を表示します。

示例截图

プロジェクトチーム

• 責任者: 张三
• 開発メンバー: 李四、王五
• テスト担当者: 赵六

連絡先

何か問題があれば、サポートメール にご連絡いただくか、プロジェクトの公式サイト をご覧ください。

以上の内容が皆さんのお役に立てれば幸いです！