跳到主要内容

Gitee AI 魔力方舟大模型对接

前置条件
  • 已部署微语系统
  • 已申请 Gitee AI 魔力方舟 API Key（申请地址：https://gitee.com/）

配置说明​

Docker部署配置参数​

# Gitee AI 魔力方舟 API 配置
SPRING_AI_GITEE_BASE_URL: https://api.gitee.com     # Gitee AI 魔力方舟 API 基础地址
SPRING_AI_GITEE_API_KEY: 'sk-xxx'                     # 替换为你的 Gitee AI 魔力方舟 API Key
SPRING_AI_GITEE_CHAT_ENABLED: true                    # 启用 Gitee AI 魔力方舟对话功能

# 模型配置
SPRING_AI_GITEE_CHAT_OPTIONS_MODEL: qwen              # 模型名称，如 qwen、moonshot 等
SPRING_AI_GITEE_CHAT_OPTIONS_TEMPERATURE: 0.7         # 温度参数，控制输出的随机性，范围 0-1
SPRING_AI_GITEE_EMBEDDING_ENABLED: true               # 启用 Gitee AI 魔力方舟文本嵌入功能

源码部署配置参数​

# Gitee AI 魔力方舟 API 配置
spring.ai.gitee.base-url=https://api.gitee.com      # Gitee AI 魔力方舟 API 基础地址
spring.ai.gitee.api-key=sk-xxx                        # 替换为你的 Gitee AI 魔力方舟 API Key
spring.ai.gitee.chat.enabled=true                     # 启用 Gitee AI 魔力方舟对话功能

# 模型配置
spring.ai.gitee.chat.options.model=qwen               # 模型名称，如 qwen、moonshot 等
spring.ai.gitee.chat.options.temperature=0.7          # 温度参数，控制输出的随机性，范围 0-1

配置步骤​

1. 获取 API Key​

  1. 访问 Gitee AI 魔力方舟开发者平台：https://ai.gitee.com/
  2. 注册并登录账号
  3. 在控制台创建 API Key
  4. 保存生成的 API Key

2. 修改配置文件​

配置说明
  • 将配置文件中的 sk-xxx 替换为你获取的 API Key
  • 根据实际需求调整 temperature 参数
  • 如果不需要文本嵌入功能，可以将 SPRING_AI_GITEE_EMBEDDING_ENABLED 设置为 false

3. 管理后台配置​

  1. 登录微语管理后台
  2. 进入 AI 模型配置页面
  3. 选择 Gitee AI 魔力方舟作为默认模型
  4. 保存配置

provider provider-choose

4. 获取聊天代码​

  1. 在管理后台找到"获取聊天代码"选项
  2. 复制生成的代码
  3. 将代码集成到你的网站中

provider-code

效果展示​

配置完成后，你可以在网站中看到如下效果：

provider-chat

常见问题​

  1. API Key 无效

    • 检查 API Key 是否正确复制
    • 确认 API Key 是否已激活
    • 验证 API Key 的权限设置

  2. 对话响应慢

    • 检查网络连接
    • 确认服务器配置是否满足要求
    • 可以适当调整 temperature 参数

  3. 文本嵌入功能异常

    • 确认 SPRING_AI_GITEE_EMBEDDING_ENABLED 设置为 true
    • 检查 API Key 是否支持文本嵌入功能

  4. 模型选择问题

    • Gitee AI 魔力方舟支持多种模型，请根据实际需求选择合适的模型
    • 不同模型的能力和响应速度可能存在差异

相关资源​