mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
56 lines
2.5 KiB
Markdown
56 lines
2.5 KiB
Markdown
---
|
||
id: system-setting.ai-model.howto
|
||
title: AI 模型配置
|
||
type: howto
|
||
feature: system-setting
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 配置 AI
|
||
- 配置模型
|
||
- 接入 OpenAI
|
||
- 接入 Claude
|
||
- 接入豆包
|
||
- AI 接入
|
||
- 添加 AI 供应商
|
||
- AI 模型设置
|
||
- 接入大模型
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 应用商店（应用市场）已安装并启用 ai 插件
|
||
negative:
|
||
- 配置入口不在「系统设置」菜单，而在「AI 助手」应用内的设置面板（仅管理员可见）
|
||
- v1.4.35 起旧接口 setting__ai 已废弃，AI 模型配置全部迁移到 AI 助手应用的设置面板
|
||
- 不安装 ai 插件，「AI 助手」应用不出现
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# AI 模型配置
|
||
|
||
## 现状
|
||
DooTask 的 AI 能力由独立的 **ai 插件**（`dootask-ai`）提供。系统设置里历史上有过「AI 设置」接口（`setting__ai`），从 v1.4.35 起已废弃，仅保留路由占位。
|
||
|
||
实际的模型供应商、API Key、Base URL 等配置在 **「AI 助手」应用内的设置面板**（仅管理员可见），保存走 `api/system/setting/aibot` 接口。
|
||
|
||
## 入口
|
||
桌面端：左侧栏「应用」→「AI 助手」应用 → 点某个 AI 机器人（供应商）卡片上的设置按钮，打开该供应商的设置面板。需安装 ai 插件且当前用户是系统管理员。
|
||
|
||
## 操作步骤
|
||
1. 管理员在应用商店安装并启用 ai 插件（生成 `dootask-ai` 容器）
|
||
2. 打开「AI 助手」应用，选择要配置的供应商（ChatGPT/OpenAI、Claude、DeepSeek、Gemini、Grok、Ollama、智谱、通义千问、文心一言等）
|
||
3. 在设置面板填写：API Key、模型列表（一行一个模型名，可点「使用默认模型列表」一键填入）、默认模型、Base URL（可选）、代理（可选）、Temperature、默认提示词
|
||
4. 保存后该供应商的模型立即可在 AI 对话中选用，并可被 [[system-setting.ai-bot.howto]] 的「AI 机器人」使用
|
||
|
||
## 与其他模块的关系
|
||
- 提供模型给 [[system-setting.ai-bot.howto]] 的默认模型选择
|
||
- 「AI 整理汇报」、AI 助手浮窗等都依赖此处配置
|
||
- 客户端调用走 `/ai/*` 路由，由插件容器处理
|
||
|
||
## 不支持
|
||
- DooTask 主程序不内置任何模型，必须依赖 ai 插件
|
||
- 配置入口不在「系统设置」菜单（v1.4.35 起旧入口废弃），在「AI 助手」应用内
|
||
- 普通成员打开设置面板会提示仅管理员可操作
|
||
- 不支持自动测试模型是否可用，需要保存后到对话窗口实际试用
|