当前位置:首页 > 文章列表 > 科技周边 > 人工智能 > Ollama Modelfile 如何设置系统提示和上下文长度

Ollama Modelfile 如何设置系统提示和上下文长度

来源:17golang原创 2026-09-14 21:48:44 0浏览 收藏

我第一次把本地模型交给一个自动化脚本时,最容易混淆的是两件事:模型应该“怎么回答”,以及一次请求最多能“记住多少内容”。在 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 也可能无法按预期呈现,所以一般优先沿用基础模型的模板。

Ollama Modelfile 中 FROM、SYSTEM、TEMPLATE 与 PARAMETER num_ctx 的静态关系
图1:Ollama Modelfile 的配置分层示意图,展示系统提示如何进入模板,以及上下文参数作用于运行配置。

用 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 只是新标签,可以换成项目自己的名称。每次修改 SYSTEMnum_ctx 后,都要再次执行 ollama create;只编辑文件不会自动更新已经创建的模型。

上下文长度不生效时先查哪一层

先看模型配置,再看实际加载值。ollama show --modelfile 能帮助确认你查看的是哪个模型标签;ollama psCONTEXT 列才是当前运行实例加载的上下文长度。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 并调用新模型名。

Ollama 上下文长度的配置来源、服务加载与 ollama ps CONTEXT 观察字段关系
图2:上下文长度检查示意图,区分 Modelfile、服务环境和客户端边界,并把最终观察点落到 ollama ps 的 CONTEXT。

一张配置速查表

目标配置位置检查重点
固定回答角色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 新模型名 查配置,再停止旧实例并用新标签启动。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go signal.NotifyContext 使用后为什么还要调用 stopGo signal.NotifyContext 使用后为什么还要调用 stop
上一篇
Go signal.NotifyContext 使用后为什么还要调用 stop
SkildArt做电商详情页模块不统一怎么办?商品主体、色彩与长图衔接排查
下一篇
SkildArt做电商详情页模块不统一怎么办?商品主体、色彩与长图衔接排查
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    26次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    130次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    60次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    22次使用
  • OpenCompass大模型评测体系详解:功能、使用指南与应用场景
    OpenCompass
    OpenCompass是上海AI实验室推出的开源大模型评测平台,提供CompassKit、CompassHub和CompassRank三大核心组件,支持LLM及多模态模型的一站式标准化评估与排行榜查询。
    81次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码