深入产品的关键能力。每章一个核心概念,读完你能讲清楚"它为什么好用"。
3月前我接手一个老 Agent 项目,模型 ID 写死在代码里。换一次模型,我得改代码、测试、重部署,半天没了。我越想越不对。
04.1 我见过最蠢的耦合
之前有个项目,模型 ID 写死在业务代码里。换模型要改代码、测试、重新部署。一次切换,半天没了。
标叔的结论:模型选择是产品策略,不该是工程事件。
04.2 它是怎么解耦的
Makers 底层接了 AI 网关。代码里只留统一的接入方式。用哪个模型、哪家厂商、哪个版本,都在网关侧配。
看两个自动注入的环境变量:
# 网关地址,所有模型调用都走这里
AI_GATEWAY_BASE_URL=https://ai-gateway.edgeone.link/v1
# 平台自动生成的密钥,创建项目时已注入
AI_GATEWAY_API_KEY=sk-xxx
这两个是平台在创建项目时自动注入的,你不用管。模型名你自己在代码或环境变量里指定(很多模板读 AI_GATEWAY_MODEL)。
内置模型用 @makers/ 前缀,比如 @makers/hy3-preview、@makers/deepseek-v4-flash。换模型就改这一个值,业务代码一行都不用动。
04.3 实战:从默认模型切到 DeepSeek
鱼皮做"AI 投资人 Agent"时,默认模型效果一般。他切到 DeepSeek,只做了两件事:
第一步:去控制台「模型与密钥」页,绑定你自己的 DeepSeek API Key。
预期结果:DeepSeek 出现在可选厂商里。
注意
平台不提供厂商密钥。内置模型免 Key,但要用 DeepSeek、OpenAI 这类厂商模型,得自己备 Key 并绑定。详情见 §19。
第二步:把 model 改成厂商写法,重新部署。
# 内置免 Key,开箱即用
AI_GATEWAY_MODEL=@makers/deepseek-v4-flash
# 绑定 DeepSeek Key 后,用厂商写法
AI_GATEWAY_MODEL=deepseek/deepseek-v4-pro
预期结果:对话质量明显变好,代码零改动。
重点看
整个过程零代码改动。业务代码始终稳定,模型能力跟着平台走。这就是网关的价值。
04.4 适合谁来切
产品早期追效果,用强模型。量上来追成本,切轻量模型。新模型上线想灰度,加一个环境变量的事。
换模型这件事,不该惊动你的代码。下一章讲对话记忆。