Spring Ai Resos

🚀 開發 Spring AI ResOs 聊天機器人

本項目致力於開發一款基於 Spring AI 的 ResOs 聊天機器人，它能夠與 OpenAI、Groq Cloud 和 OpenRouter 等 AI 提供商實現集成。以下是詳細的開發指南，助您輕鬆上手。

🚀 快速開始

項目下載

從 GitHub 克隆項目倉庫：

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

依賴添加

確保以下依賴已添加到 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>

配置文件創建

創建一個 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>

應用啟動

在項目根目錄下運行以下命令啟動聊天機器人：

mvn spring-boot:run

✨ 主要特性

• 多 AI 提供商集成：支持與 OpenAI、Groq Cloud 和 OpenRouter 等 AI 提供商集成。
• 文本嵌入功能：能夠將文本轉換為向量表示，方便後續處理。
• 自定義模型支持：可集成自定義的 AI 模型，只需在 application.yml 中添加相應配置。

📦 安裝指南

項目結構

項目的模塊結構如下：

• backend：包含聊天機器人的後端邏輯，負責與 AI 提供商進行交互。
• mcp-server：最簡可行產品（MVP）服務器模塊，用於接收和處理用戶的查詢請求。
• mcp-client：最簡可行產品（MVP）客戶端模塊，用於發送請求到服務器並顯示結果。

💻 使用示例

基礎用法

訪問 Web 界面

打開瀏覽器，訪問 http://localhost:8081。

輸入查詢

在文本框中輸入您的問題或指令，例如：

• "告訴我今天的天氣如何？"
• "幫我寫一封郵件。"

獲取結果

點擊“發送”按鈕，等待幾秒鐘，即可看到 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 密鑰。

擴展功能

文本嵌入

支持將文本轉換為向量表示，便於後續處理。

自定義模型

支持集成自定義的 AI 模型，只需在 application.yml 中添加相應的配置。

👥 項目團隊

• 負責人：張三
• 開發成員：李四、王五
• 測試人員：趙六

📞 聯繫方式

如有任何問題，請聯繫 支持郵箱 或訪問 項目官網。

📷 示例截圖