docs: 更新模型配置指南

- 新增 `gemini` 客户端类型
- 更新 Google API 的 `base_url`
- 移除 `extra_params` 对 `gemini` 客户端的无效说明
- 新增 `anti_truncation` 参数说明
- 增加多个新的模型任务配置示例
- 将文档中的 `MaiBot` 统一为 `MoFox_Bot
This commit is contained in:
minecraft1024a
2025-08-28 20:47:49 +08:00
parent add68fcf58
commit 78e78e71ba

View File

@@ -43,7 +43,7 @@ retry_interval = 10 # 重试间隔(秒)
| `name` | ✅ | 服务商名称,需要在模型配置中引用 | - | | `name` | ✅ | 服务商名称,需要在模型配置中引用 | - |
| `base_url` | ✅ | API服务的基础URL | - | | `base_url` | ✅ | API服务的基础URL | - |
| `api_key` | ✅ | API密钥请替换为实际密钥 | - | | `api_key` | ✅ | API密钥请替换为实际密钥 | - |
| `client_type` | ❌ | 客户端类型:`openai`OpenAI格式`aiohttp_gemini`(至少现在支持良好) | `openai` | | `client_type` | ❌ | 客户端类型:`openai``gemini` `aiohttp_gemini` | `openai` |
| `max_retry` | ❌ | API调用失败时的最大重试次数 | 2 | | `max_retry` | ❌ | API调用失败时的最大重试次数 | 2 |
| `timeout` | ❌ | API请求超时时间 | 30 | | `timeout` | ❌ | API请求超时时间 | 30 |
| `retry_interval` | ❌ | 重试间隔时间(秒) | 10 | | `retry_interval` | ❌ | 重试间隔时间(秒) | 10 |
@@ -72,7 +72,7 @@ client_type = "openai"
```toml ```toml
[[api_providers]] [[api_providers]]
name = "Google" name = "Google"
base_url = "https://api.google.com/v1" #在MoFox-Bot中, 使用aiohttp_gemini客户端的提供商可以自定义base_url base_url = "https://generativelanguage.googleapis.com/v1beta" # 在MoFox-Bot中, 使用aiohttp_gemini客户端的提供商可以自定义base_url
api_key = "your-google-api-key" api_key = "your-google-api-key"
client_type = "aiohttp_gemini" # 注意Gemini需要使用特殊客户端 client_type = "aiohttp_gemini" # 注意Gemini需要使用特殊客户端
``` ```
@@ -132,7 +132,6 @@ thinking = {type = "disabled"} # 禁用思考
``` ```
请注意,`extra_params` 的配置应该构成一个合法的TOML字典结构具体内容取决于API服务商的要求。 请注意,`extra_params` 的配置应该构成一个合法的TOML字典结构具体内容取决于API服务商的要求。
**请注意,对于`client_type`为`gemini`的模型,此字段无效。**
### 3.3 配置参数说明 ### 3.3 配置参数说明
| 参数 | 必填 | 说明 | | 参数 | 必填 | 说明 |
@@ -144,6 +143,7 @@ thinking = {type = "disabled"} # 禁用思考
| `price_out` | ❌ | 输出价格(元/M token用于成本统计 | | `price_out` | ❌ | 输出价格(元/M token用于成本统计 |
| `force_stream_mode` | ❌ | 是否强制使用流式输出 | | `force_stream_mode` | ❌ | 是否强制使用流式输出 |
| `extra_params` | ❌ | 额外的模型参数配置 | | `extra_params` | ❌ | 额外的模型参数配置 |
| `anti_truncation` | ❌ | 是否启用反截断功能 |
## 4. 模型任务配置 ## 4. 模型任务配置
@@ -183,7 +183,7 @@ max_tokens = 800
``` ```
### planner - 决策模型 ### planner - 决策模型
负责决定MaiBot该做什么 负责决定MoFox_Bot该做什么
```toml ```toml
[model_task_config.planner] [model_task_config.planner]
model_list = ["siliconflow-deepseek-v3"] model_list = ["siliconflow-deepseek-v3"]
@@ -192,7 +192,7 @@ max_tokens = 800
``` ```
### emotion - 情绪模型 ### emotion - 情绪模型
负责MaiBot的情绪变化 负责MoFox_Bot的情绪变化
```toml ```toml
[model_task_config.emotion] [model_task_config.emotion]
model_list = ["siliconflow-deepseek-v3"] model_list = ["siliconflow-deepseek-v3"]
@@ -261,6 +261,44 @@ temperature = 0.7
max_tokens = 800 max_tokens = 800
``` ```
### schedule_generator - 日程生成模型
```toml
[model_task_config.schedule_generator]
model_list = ["deepseek-v3"]
temperature = 0.5
max_tokens = 1024
```
### monthly_plan_generator - 月度计划生成模型
```toml
[model_task_config.monthly_plan_generator]
model_list = ["deepseek-v3"]
temperature = 0.7
max_tokens = 1024
```
### emoji_vlm - 表情包VLM模型
```toml
[model_task_config.emoji_vlm]
model_list = ["qwen-vl-max"]
max_tokens = 800
```
### anti_injection - 反注入模型
```toml
[model_task_config.anti_injection]
model_list = ["deepseek-v3"]
temperature = 0.1
max_tokens = 512
```
### utils_video - 视频分析模型
```toml
[model_task_config.utils_video]
model_list = ["qwen-vl-max"]
max_tokens = 800
```
## 5. 配置建议 ## 5. 配置建议
### 5.1 Temperature 参数选择 ### 5.1 Temperature 参数选择