Ollama Modelfile 如何设置系统提示和上下文长度
来源:17golang原创
时间:2026-09-14 21:48:44 403浏览 收藏
我第一次把本地模型交给一个自动化脚本时,最容易混淆的是两件事:模型应该“怎么回答”,以及一次请求最多能“记住多少内容”。在 Ollama 的 Modelfile 里,前者由 SYSTEM 负责,后者通常由 PARAMETER num_ctx 负责。把两项写进同一个自定义模型,再用自定义模型名调用,配置才不会只停留在当前会话。
官方地址:https://ollama.com/ Modelfile 文档:https://docs.ollama.com/modelfile
最小写法是:用SYSTEM固化系统提示,用PARAMETER num_ctx 8192固化上下文窗口;修改后必须重新执行ollama create,调用时也要使用新模型名。若ollama ps显示的上下文仍不对,再检查服务默认值、环境变量和客户端请求。
SYSTEM是行为约束,不等于用户每次输入的 prompt。num_ctx是 token 上下文容量,数值越大通常越占用显存或内存。- 改完 Modelfile 只保存文件还不够,要创建新模型并检查实际加载的
CONTEXT。
SYSTEM 和 PARAMETER 为什么要分开写
SYSTEM 写的是模型在对话中应遵守的长期指令,例如回答语言、角色范围和输出格式;PARAMETER 写的是运行参数。num_ctx 决定模型生成下一个 token 时可用的上下文窗口,和“让模型更聪明”不是一回事。
TEMPLATE 则是另一层:它定义完整提示的拼接格式,常见变量包括 {{ .System }}、{{ .Prompt }} 和 {{ .Response }}。如果模板没有把 .System 放进去,单独写 SYSTEM 也可能无法按预期呈现,所以一般优先沿用基础模型的模板。

用 Modelfile 固化一个可复用模型
在一个空目录保存名为 Modelfile 的文件。下面的示例只改变系统提示、上下文和温度,基础模型仍由 FROM 指定:
FROM llama3.2 # 固化回答角色和输出边界,避免每次请求重复发送同一段说明 SYSTEM """你是一名中文 Go 工程助手。 回答先给结论,再给最小可运行示例;不确定时明确说明假设。""" # 设置上下文窗口,单位是 token;按本机显存和输入长度选择 PARAMETER num_ctx 8192 # 降低随机性,让排错类回答更稳定 PARAMETER temperature 0.2
保存后创建模型并运行:
# 根据当前目录的 Modelfile 创建可复用的模型标签 ollama create go-helper -f ./Modelfile # 后续对话使用自定义标签,不要又切回基础模型 llama3.2 ollama run go-helper
这里的 go-helper 只是新标签,可以换成项目自己的名称。每次修改 SYSTEM 或 num_ctx 后,都要再次执行 ollama create;只编辑文件不会自动更新已经创建的模型。
上下文长度不生效时先查哪一层
先看模型配置,再看实际加载值。ollama show --modelfile 能帮助确认你查看的是哪个模型标签;ollama ps 的 CONTEXT 列才是当前运行实例加载的上下文长度。Ollama 文档还说明,默认上下文会按显存档位变化,增大上下文会提高内存需求。
# 查看自定义模型对应的 Modelfile 配置 ollama show --modelfile go-helper # 查看正在运行的实例、处理器分配和实际 CONTEXT ollama ps
如果服务层无法通过应用设置调整,也可以在启动服务时指定环境变量:
# 服务级上下文会影响该服务加载模型时的默认容量 OLLAMA_CONTEXT_LENGTH=64000 ollama serve
这不是让所有场景都盲目改成 64000。大窗口会增加内存压力,应该先按任务选择 4096、8192 或更大的值,再观察是否出现 CPU offload、加载失败或响应变慢。若使用 OpenAI 兼容接口,官方说明该接口本身没有设置上下文长度的字段,应该创建带有 num_ctx 的 Modelfile 并调用新模型名。

一张配置速查表
| 目标 | 配置位置 | 检查重点 |
|---|---|---|
| 固定回答角色 | SYSTEM | 模板是否使用 {{ .System }} |
| 固定上下文容量 | PARAMETER num_ctx | 创建后使用新模型名 |
| 调整服务默认值 | OLLAMA_CONTEXT_LENGTH | 服务重启后查看 CONTEXT |
| 确认实际加载结果 | ollama ps | 同时看 PROCESSOR 是否发生 offload |
常见问题
只写 SYSTEM,不写 TEMPLATE,可以吗?
通常可以,因为基础模型已有模板;但自定义 TEMPLATE 时必须保留模型所需的消息格式,并确认其中使用了 .System。
把 num_ctx 调大,回答一定更好吗?
不一定。它只扩大可用上下文,还会增加内存需求;如果任务本身输入很短,增大窗口可能只带来更高的资源成本。
为什么改完 Modelfile 后 ollama ps 还是旧值?
最常见原因是没有重新 ollama create,或者运行时仍调用基础模型。先用 ollama show --modelfile 新模型名 查配置,再停止旧实例并用新标签启动。
-
216 收藏
-
120 收藏
-
457 收藏
-
449 收藏
-
383 收藏
-
科技周边 · 人工智能 | 7小时前 | 人工智能 · openai api · 工程实践 · 批处理 · OpenAI Batch API custom_id 批量请求结果映射 JSONL 结果回配105 收藏
-
146 收藏
-
科技周边 · 人工智能 | 10小时前 | openai · json schema · Structured Outputs · OpenAI Nullable Schema JSON Schema Structured Outputs281 收藏
-
科技周边 · 人工智能 | 11小时前 | 人工智能 · openai api · 检索增强生成 · 文件搜索 · OpenAI Attributes 元数据过滤 Responses API File Search vector store426 收藏
-
科技周边 · 人工智能 | 12小时前 | 异步任务 · 人工智能 · openai api · 接口开发 · 轮询 后台任务 background true OpenAI Responses API response_id314 收藏
-
345 收藏
-
115 收藏
-
171 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习