---
title: 配置模型
description: 接入 OpenAI、Anthropic、Gemini、OpenRouter、Ollama,以及本地 GGUF 离线模型;角色怎么设、AI 怎么用它们;应用在哪些地方会调用你的模型。
section: guide
order: 40
updated: 2026-11-09
---
# 配置模型
## 角色
角色是给一类工作指定的模型。在「设置 › AI 设置 › 角色」里,给每个角色从你接入的模型里选一个。
内置四个角色,不能删除,可以不设模型。每个角色下面有一行浅灰色的英文说明,写着它用来做什么。这行说明是固定的,不翻译:AI 读的就是这一行(见下文)。
| 角色 | 设置里的说明 | 建议选的模型 |
| --- | --- | --- |
| 对话(`chat`) | Everyday conversation and tasks; what a sub-agent gets when no role fits better. | 你平时用的模型。没有单独选模型的地方都用它 |
| 识图(`vision`) | Reading images: screenshots, photos, scanned pages. | 能看图的模型 |
| 深度思考(`deep`) | The strongest model, for hard thinking and output that must be good: planning, analysis, generating a whole HTML page or a long report. | 你能用的最强的模型 |
| 本地(`local`) | A model on this computer, so nothing leaves it: for sensitive content such as emails, personal data, passwords or private documents. | 在这台电脑上运行的模型,比如 Ollama 里的模型,或下载到本机的 GGUF 模型 |
也可以自己加角色:在列表下面填角色名和一句说明,点 **+**,再给它选模型——选好模型才算建好。说明是必填的:AI 靠这句话判断什么时候用这个角色。说明以后可以直接在列表里改;自己加的角色可以删除。
### AI 怎么用角色
- 一个 agent 可以把一部分工作交给子 agent。交出去的时候,它看得到每个**已经设了模型**的角色和那行说明,可以按任务选一个角色,子 agent 就用这个角色的模型;不选,子 agent 和交出工作的 agent 用同一个模型。没设模型的角色不会出现在它的选择里。
- 所以建议四个内置角色都设上模型:「本地」选一个本机的模型,「深度思考」选最强的模型,「识图」选一个能看图的模型。
- 交不交、交给哪个角色,是 AI 按说明自己判断的,不是强制规则。而且交出去之前,交出工作的 agent 自己的模型已经读过它手上的内容。想让某类内容只交给本机的模型,最可靠的做法是让处理它的 agent 本身就用「本地」角色(在「设置 › AI 设置 › Agent」里选)。
- 子 agent 用哪个模型,在它被创建时就定下来了。之后在设置里改某个角色的模型,只影响之后创建的子 agent。
### 自己给子 agent 换角色
- **对话里**:点输入框右边的「专家和工具」按钮,「专家」一栏列出这个对话的子 agent,每个下面有一个「模型」下拉框,可以选一个角色,也可以选一个具体的模型。改动从它的下一步开始生效。
- **项目里**:项目顶栏的「Agent」面板列出现在正在为这个项目工作的东西:项目助手的子 agent,以及项目的对话启动的 gem 的 agent 和 SOP。agent 旁边有一个下拉框。子 agent 的改动从它的下一步开始生效;gem 的 agent 改的是它所有运行都用的设置,和「设置 › AI 设置 › Agent」里是同一个设置。
### 给各个 agent 选模型
「设置 › AI 设置 › Agent」里可以给每个 agent 单独选一个角色或一个模型,从上到下依次是:
- **项目**:项目里的助手。
- **对话**:侧边栏「对话」里的助手。
- **Gem Studio**:Gem Studio 里的助手。
- **后台任务**:给对话起标题、总结长对话、描述知识库里的文件夹。
- 再往下是你装的 gem 的 agent。
没选的,都用「对话」角色。
## 哪些功能会调用你的模型
你在「设置 › AI 设置」里接入的模型,不只在你发消息时被调用。下面列出应用里所有会向模型发请求的地方:什么时候调用、用哪个模型、发过去什么内容。没有列在这里的功能不调用模型。
文中的「`chat` 角色」,就是「设置 › AI 设置 › 角色」里的「对话」角色。
### 你发起的
| 功能 | 什么时候调用 | 用哪个模型 | 发给模型什么 |
| --- | --- | --- | --- |
| 对话 | 每次你发消息,或你设的定时任务触发时。一次回复里,助手每用一次工具就多调用一次 | 「Agent › 对话」里选的模型;没选就是 `chat` 角色 | 系统提示词、可用工具的说明、这个对话的内容,以及当前时间、附件文件名这类背景信息 |
| 项目里的对话 | 你在项目的助手面板里发消息时。一次回复里,助手每用一次工具就多调用一次 | 「Agent › 项目」里选的模型;没选就是 `chat` 角色 | 同对话,另加项目的背景信息:项目名、项目可用账号的名字(不含密钥)、有哪些表、上次回复以来表里哪些行有改动 |
| 子 agent | 对话或项目里的助手把一部分任务交给子 agent 时 | 交出任务时指定了角色,就是这个角色的模型;没指定,和交出任务的 agent 相同。见[角色](#角色) | 同上,范围是子任务自己的对话 |
| Gem 的 agent | 对话里用到某个 gem 的 agent,或 gem 的流程(SOP)运行到 agent 这一步时 | 「Agent」里为这个 agent 选的模型;没选就是 `chat` 角色 | 同对话,系统提示词换成这个 gem 自己的 |
| Gem Studio 助手 | 你在 Gem Studio 里和助手对话时 | 「Agent › Gem Studio」里选的模型;没选就是 `chat` 角色 | 同对话,另加它读取的草稿文件 |
一个对话用哪个模型,在它创建时就定下来了。之后改设置只影响新建的对话。
### 应用在后台自动做的
| 功能 | 什么时候调用 | 用哪个模型 | 发给模型什么 |
| --- | --- | --- | --- |
| 生成对话标题 | 新对话的第一条消息。6 个字符以内的消息直接当标题,不调用模型 | 「Agent › 后台任务」里选的模型;没选就是 `chat` 角色 | 只有这第一条消息的文字 |
| 总结长对话 | 对话的大小超过「设置 › 系统 › 自动压缩对话」时,在助手下一次回复之前。默认 10 万 token,设为 0 关闭 | 「Agent › 后台任务」里选的模型;没选就是 `chat` 角色 | 这个对话里较早的部分:你和助手的消息(太长的只留开头和结尾);工具调用只留工具名、缩短后的参数和结果。最近 10 条消息不在其中 |
| 知识库 collection 的一句话描述 | 知识库里某个顶层 collection 的子文件夹或文件名有变化之后。每个 collection 最多每 30 分钟一次 | 「Agent › 后台任务」里选的模型;没选就是 `chat` 角色 | 这个 collection 的目录结构和文件名。不包含文档内容 |
| 读出扫描件和图片里的文字 | 往知识库导入扫描版 PDF 或图片时,不会先问你。PDF 里没有文字的页面每页调用一次,每个文件最多读前 500 页(超出的页不读,导入结果里会提示);单独选中或拖进来的图片每张调用一次。导入整个文件夹时,里面的图片不读 | `vision` 角色(界面上叫「识图」);没设就是 `chat` 角色 | 这些页面或图片本身(转成灰度、缩小)。读出的文字存进你的知识库 |
| Gem 自己发起的调用 | 你安装的 gem 在它的工具或流程里调用模型时。只有安装时被授予 `llm` 权限的 gem 才能这样做 | `chat` 角色 | 由这个 gem 决定。它能读到什么,取决于你授予它的其他权限 |
这一类调用同样按你的模型服务商的价格计费,用量计入「统计」页。它们用掉的 token 不计入「每次运行的 token 上限」。读扫描件是按页调用的,一份几十页的扫描件,费用会明显高于上表的其他几项。
起标题、总结长对话、描述知识库,这三项读到的是你的消息和文件名,内容会发给「后台任务」所用模型的服务商。在「Agent › 后台任务」里给它选一个在这台电脑上运行的小模型(比如「本地」角色),这些内容就不会离开你的电脑。
读图片里的文字时,模型必须能看图。如果用的模型不能看图(比如只支持文字的模型、本地 GGUF 模型),这份文件会导入失败,导入结果里写着原因——到「设置 › AI 设置 › 角色」给「识图」选一个能看图的模型,再导入一次即可。同一个文件用同一个模型读过之后,再次导入不会重新读;应用更新到新版本后的第一次导入除外。
### 长对话总结是怎么回事
对话很长时,全部内容会超出模型一次能处理的长度。超过你设置的大小后,应用会请「后台任务」的模型(没选就是 `chat` 角色)把较早的部分写成一份总结。此后发给模型的是「这份总结 + 最近的消息原文」,不再是全部历史。
- 聊天记录不受影响。所有消息都还在;记录里会出现一条「已总结较早的消息」的分隔线,点开可以看到总结的内容。
- 总结之后,助手对较早内容的细节只知道总结里写下的那些。需要它用到某个早先的细节时,直接再告诉它一次。
- 对话继续变长,会再总结一次。新的总结是在上一份的基础上写的。
- 这个大小要设得比你所用模型的上下文长度小。应用目前不知道各个模型的上下文长度,不会替你调整。
- 如果总结没写成(比如模型服务暂时不可用),这次回复照常进行,用的是完整的历史。
### 不调用你的模型的
- 知识库的检索和向量索引,用的是随应用安装的本地 embedding 模型。它在你的电脑上运行,内容不发给任何服务。
- 导入网页:网页由应用自己的浏览器在后台打开、取出正文,不经过模型。网页里的图片不读。
- 「深度思考」「本地」和你自己加的角色,只在你把某个 agent 指向它们、或者 agent 把子任务交给它们时才会被用到;「识图」除此之外,还用来读扫描件和图片里的文字(见上表)。
## 给 gem 选模型
gem 装好以后会打开它的页面,在「设置 › AI 模型」里给它的每个 agent 选模型:下拉框里先是你的角色(选角色,就跟着你在「角色」里给这个角色配的模型走),再是你加过的所有模型。没选时用 `chat` 角色。「设置 › AI 设置 › Agent」里改的是同一个设置。还没有添加任何模型时,不显示这一项。
有的 gem 要求模型除了文字以外,还能看图片、听音频、看视频,或者生成图片、音频、视频。你在 gem 的页面上或在「Agent」里给它的 agent 选模型时,Notochord 会拿选中的模型对照一份常见模型的能力列表:
- 对得上,什么都不显示。
- 列表说这个模型不会,或者列表里没有这个模型(比如你自己给模型起的名字),或者选的角色还没有配模型,会在下拉框下面显示一行提示。你自己确认:模型其实会就不用管;不会就换一个。
- 提示不会阻止安装,也不会阻止使用。