配置第一个 AI 模型
保存提供方信息，选择对话模型，并用一次简短请求检查连接。
第一次设置只需要让一个对话模型正常工作。语音、图片和视频服务可以等用到时再配置。
准备服务信息
准备模型服务的 API 密钥，以及该账号实际可用的模型名称。服务费用由提供方收取；聊天产品订阅与 API 访问权限可能不同，不能仅凭已经购买订阅判断 API 可用。
添加并选择模型
仍在首次设置中时： 在「连接 AI」选择云端服务，依次填写提供方、模型和 API 密钥，再点击「保存并测试」。按测试反馈修正后继续。
首次连接 AI：提供方、模型与密钥需要对应。图中密钥尚未填写，也未完成连接测试。
- 1选择提供方和账号实际可用的模型。
- 2填写该服务的 API 密钥。
- 3点击「保存并测试」，再检查反馈。
Test 环境 · 示例数据 · 中文界面
使用本地模型时： 切换到本地模型，先启动 Ollama、LM Studio 或自己的兼容服务。检查地址，读取可用模型后选择一个；需要工具操作时，再核对该模型确实支持工具调用。
使用本地模型时，先启动本机模型服务，再读取可用模型。
- 1切换到本地模型设置。
- 2核对服务地址，点击读取模型。
- 3仅在模型确实支持时确认工具调用能力。
Test 环境 · 示例数据 · 中文界面
已经进入主界面时： 可以随时从设置补充或修改连接：
- 点击侧栏底部的设置图标，或从个人菜单打开「设置」，进入「API」。
- 添加一个提供方，填写自己的密钥。使用自定义服务时，同时核对 API 地址和接口类型。
- 点击「保存提供方」，确认保存成功。
- 进入「模型通道」，在「对话」一行选择这个提供方和一个可用模型。
- 使用「重新探测」检查连接，再新建对话发送一句简短问题。
模型通道的更改自动保存，主要影响新建对话；已有会话保留自己的模型选择。密钥保存后不会回显明文，看到空白输入框不代表密钥丢失。
尚未添加提供方的 API 设置页。先添加服务，再为各功能选择模型。
- 1使用预设提供方入口。
- 2自定义服务需要核对地址与接口类型。
Test 环境 · 示例数据 · 中文界面
怎样确认配置成功
模型探测没有报告失败，新对话能返回正常回答。接下来再用一份资料测试问答，避免一开始就把模型连接、复杂文件处理和媒体生成混在一次测试中。
模型通道按用途分别设置。图中 test-model 是测试名称，且状态为「未探测」，不能照抄为真实模型名。
- 1为「对话」选择提供方与模型。
- 2使用「重新探测」，检查真实连接结果。
- 3核对隐私策略、内容级别与工具调用能力。
Test 环境 · 示例数据 · 中文界面
如果只需要阅读本地资料，可以先跳过 AI 配置；需要生成回答时再补齐。
连接失败时
先检查密钥、服务地址、模型名称和服务账户额度。选择另一个服务时也要重新确认模型，不要沿用上一家的模型名称。更多设置见模型与服务配置，具体报错见常见问题排查。
下一步
按照完成第一个任务，导入资料并获得一个带来源的回答。