10分钟上手 Open WebUI 自定义模型不改一行代码打造专属助手【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui团队里的 AI 助手总爱答非所问想让客服、研发各有一套统一话术的模型不用重新训练。Open WebUI 的自定义模型功能让你基于一个现成的基础模型配上系统提示词和采样参数再圈定谁能看见它10 分钟就把通用大模型改成有边界、有角色、有权限的专属助手。 快速上手先跑起来看到效果Docker 部署最快一条命令拉起来docker run -d -p 3000:8080 \ --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main验证服务是否就绪curl http://localhost:3000/api/version返回版本号就说明服务正常。打开http://localhost:3000用管理员登录。注意自定义模型要挂在一个基础模型上首次启动后请先确认 Ollama 或其他模型源已被 Open WebUI 发现管理面板里能看到模型列表即可。核心流程5 步创建你的第一个自定义模型1. 打开模型创建页面左侧导航点工作区→模型再点右上角创建模型。此时会进入模型表单页路由是/workspace/models/create。2. 选基础模型起一个模型 ID基础模型下拉框里是所有可用上游模型Ollama 本地模型、OpenAI 兼容 API 模型都在里面选一个你已经能正常对话的。模型 ID是全站唯一标识用于 API 调用长度不超过 256 个字符不能和任何现有模型或基础模型重名。比如填my-assistant。3. 填显示名称与系统提示词名称是给人看的名字例如企业知识库助手。系统提示词是真正塑造模型的地方写清角色、回答范围、兜底话术例如你是一位专业的客服助手。 只回答与公司产品相关的问题。 遇到不确定的内容直接回答无法确定。4. 调整采样参数在参数区域修改 temperature、top_p 等。常用推荐值见下表不确定的可以先留默认。5. 设置访问范围保存在访问控制中选择私有、公开或指定用户组点保存。此时页面会提示模型创建成功并返回列表模型列表里应能看到你新建的模型。表单字段对应后端的ModelFormid / base_model_id / name / params / meta / access_grants想深入了解实现可以看 backend/open_webui/routers/models.py 和 backend/open_webui/models/models.py。关键参数一张表看懂参数作用推荐值 / 说明模型 IDAPI 调用时的唯一标识与基础模型区分开不超 256 字符基础模型真正处理请求的上游模型选已同步、可正常对话的模型系统提示词定义角色、回答边界、兜底话术角色 范围 兜底三句起步temperature输出随机性0.7 偏稳定1.0 偏多样top_p核采样阈值0.9 ~ 1.0访问控制谁能看见、使用该模型默认私有团队内再开放is_active启用/停用开关默认启用停用可保留配置用起来两种方式验证模型真的生效方式一直接对话。在聊天页顶部模型下拉里选中新模型问一句你是谁能回答哪些问题。回复应明显带上系统提示词里的角色和边界而不是通用大模型口吻。方式二API 调用。在管理→设置→用户里拿到 API Keycurl http://localhost:3000/api/chat/completions \ -H Authorization: Bearer 你的API Key \ -H Content-Type: application/json \ -d {model:my-assistant,messages:[{role:user,content:介绍一下你自己}]}请求返回正常内容说明模型 ID、参数、权限整条链路都通了。⚠️ 避坑指南1. 保存时报Model ID already exists现象提示 ID 已被占用。原因ID 与现有模型或基础模型冲突。解决换一个 ID非管理员账号还要求必须填写基础模型留空也会报权限错误。2. 点创建直接提示无权限现象普通用户打开创建页保存失败。原因创建模型需要 admin 角色或workspace.models权限。解决在管理面板给对应用户组授予该权限或让管理员代建。3. 聊天下拉框里看不到新模型现象列表页有、聊天页没有。原因基础模型还没同步进来或模型被停用了。解决在模型页触发同步或检查该模型的启用开关。4. 系统提示词不生效现象回复口吻和创建前没区别。原因提示词没写进系统提示字段或保存后改了基础模型配置被覆盖。解决重新编辑模型确认提示词保存在系统提示输入框里再保存一次。进阶再往深走一步挂上知识库模型表单里可以关联文档与知识库meta.knowledge字段让模型基于你的资料回答检索实现在 backend/open_webui/retrieval/。批量迁移模型页支持导出/导入配置方便把同一套自定义模型搬到其他 Open WebUI 实例。自定义模型的价值就是把复用基础模型 提示词与参数约束 权限边界这三件事做成了 10 分钟的操作。后续功能变化可以跟踪 CHANGELOG.md排查问题先看 TROUBLESHOOTING.md。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
10分钟上手 Open WebUI 自定义模型：不改一行代码打造专属助手
10分钟上手 Open WebUI 自定义模型不改一行代码打造专属助手【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui团队里的 AI 助手总爱答非所问想让客服、研发各有一套统一话术的模型不用重新训练。Open WebUI 的自定义模型功能让你基于一个现成的基础模型配上系统提示词和采样参数再圈定谁能看见它10 分钟就把通用大模型改成有边界、有角色、有权限的专属助手。 快速上手先跑起来看到效果Docker 部署最快一条命令拉起来docker run -d -p 3000:8080 \ --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main验证服务是否就绪curl http://localhost:3000/api/version返回版本号就说明服务正常。打开http://localhost:3000用管理员登录。注意自定义模型要挂在一个基础模型上首次启动后请先确认 Ollama 或其他模型源已被 Open WebUI 发现管理面板里能看到模型列表即可。核心流程5 步创建你的第一个自定义模型1. 打开模型创建页面左侧导航点工作区→模型再点右上角创建模型。此时会进入模型表单页路由是/workspace/models/create。2. 选基础模型起一个模型 ID基础模型下拉框里是所有可用上游模型Ollama 本地模型、OpenAI 兼容 API 模型都在里面选一个你已经能正常对话的。模型 ID是全站唯一标识用于 API 调用长度不超过 256 个字符不能和任何现有模型或基础模型重名。比如填my-assistant。3. 填显示名称与系统提示词名称是给人看的名字例如企业知识库助手。系统提示词是真正塑造模型的地方写清角色、回答范围、兜底话术例如你是一位专业的客服助手。 只回答与公司产品相关的问题。 遇到不确定的内容直接回答无法确定。4. 调整采样参数在参数区域修改 temperature、top_p 等。常用推荐值见下表不确定的可以先留默认。5. 设置访问范围保存在访问控制中选择私有、公开或指定用户组点保存。此时页面会提示模型创建成功并返回列表模型列表里应能看到你新建的模型。表单字段对应后端的ModelFormid / base_model_id / name / params / meta / access_grants想深入了解实现可以看 backend/open_webui/routers/models.py 和 backend/open_webui/models/models.py。关键参数一张表看懂参数作用推荐值 / 说明模型 IDAPI 调用时的唯一标识与基础模型区分开不超 256 字符基础模型真正处理请求的上游模型选已同步、可正常对话的模型系统提示词定义角色、回答边界、兜底话术角色 范围 兜底三句起步temperature输出随机性0.7 偏稳定1.0 偏多样top_p核采样阈值0.9 ~ 1.0访问控制谁能看见、使用该模型默认私有团队内再开放is_active启用/停用开关默认启用停用可保留配置用起来两种方式验证模型真的生效方式一直接对话。在聊天页顶部模型下拉里选中新模型问一句你是谁能回答哪些问题。回复应明显带上系统提示词里的角色和边界而不是通用大模型口吻。方式二API 调用。在管理→设置→用户里拿到 API Keycurl http://localhost:3000/api/chat/completions \ -H Authorization: Bearer 你的API Key \ -H Content-Type: application/json \ -d {model:my-assistant,messages:[{role:user,content:介绍一下你自己}]}请求返回正常内容说明模型 ID、参数、权限整条链路都通了。⚠️ 避坑指南1. 保存时报Model ID already exists现象提示 ID 已被占用。原因ID 与现有模型或基础模型冲突。解决换一个 ID非管理员账号还要求必须填写基础模型留空也会报权限错误。2. 点创建直接提示无权限现象普通用户打开创建页保存失败。原因创建模型需要 admin 角色或workspace.models权限。解决在管理面板给对应用户组授予该权限或让管理员代建。3. 聊天下拉框里看不到新模型现象列表页有、聊天页没有。原因基础模型还没同步进来或模型被停用了。解决在模型页触发同步或检查该模型的启用开关。4. 系统提示词不生效现象回复口吻和创建前没区别。原因提示词没写进系统提示字段或保存后改了基础模型配置被覆盖。解决重新编辑模型确认提示词保存在系统提示输入框里再保存一次。进阶再往深走一步挂上知识库模型表单里可以关联文档与知识库meta.knowledge字段让模型基于你的资料回答检索实现在 backend/open_webui/retrieval/。批量迁移模型页支持导出/导入配置方便把同一套自定义模型搬到其他 Open WebUI 实例。自定义模型的价值就是把复用基础模型 提示词与参数约束 权限边界这三件事做成了 10 分钟的操作。后续功能变化可以跟踪 CHANGELOG.md排查问题先看 TROUBLESHOOTING.md。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考