SIA model_canonical_name 是什么？换模型后必须同步更新，否则配置会“静默出错“

SIA model_canonical_name 是什么换模型后必须同步更新否则配置会静默出错【免费下载链接】siaSIA is a Self Improving AI framework to autonomously improve the performance of any AI system (Model / Agent) on a benchmark task.项目地址: https://gitcode.com/GitHub_Trending/sia4/siaSIASelf-Improving AI是一个自我改进 AI 框架能自主提升任意 AI 系统模型 / Agent在基准任务上的表现。它的配置由声明式 JSON 的profile驱动其中model是网关使用的路由 ID而model_canonical_name是模型厂商的官方 ID——后者专门用于 SDK 查询提示缓存、上下文窗口和计价能力。很多新手在 SIA 配置中换模型后忘记同步更新这个字段导致缓存失效、窗口误判、成本统计失真。本文用一张表讲清两者的区别并给出同步更新的完整检查清单。先认识 SIAmodel 与 model_canonical_name 各管什么SIA 通过Meta Agent元智能体、Task Agent目标任务智能体、Feedback Agent反馈智能体三类角色协同一轮一轮地自我进化而这两个字段只出现在meta agent profile元智能体配置里例如官方自带的 sia/defaults/profiles/openrouter-meta.json字段例子谁来用作用modelanthropic/claude-haiku-4.5网关如 OpenRouter路由 ID决定请求发往哪个模型必须带厂商命名空间model_canonical_nameclaude-haiku-4-5Agent SDK 能力表官方 ID查询提示缓存、上下文窗口、成本计价一句话记忆model决定请求发给谁model_canonical_name决定按谁的规格享受能力。字段定义见 sia/profiles.py官方解释见 docs/configuration.md。为什么两者会不一样走网关时模型 ID 和厂商官方 ID 往往是两套命名通过 OpenRouter 调用 Anthropic 的 Claude路由 ID 是anthropic/claude-haiku-4.5斜杠 点号而 SDK 的能力查询表缓存开关、上下文长度、单价按厂商的连字符形式claude-haiku-4-5索引。如果只填model不填model_canonical_nameSDK 拿路由 ID 去查能力表会查不到——缓存默默关闭、上下文窗口检测不到。换模型后不同步更新会发生什么这是新手最容易踩的坑。官方文档写得很直白Change it whenever you changemodel见 docs/configuration.md。留下过期值等于把上一个模型的能力规格套在新模型身上三个后果提示缓存失效长循环里 Meta Agent 每轮都重发整个前缀token 消耗显著上升上下文窗口误判新模型的真实窗口检测不到可能提前截断或留白成本统计失真SIA 按model_canonical_name查厂商原生定价而非网关加价价过期 ID 会套错单价。更隐蔽的是SIA 的 sia/agent_impls/openhands.py 里有一道防呆校验如果安装的 SDK 太旧、忽略了该字段SIA 会主动打警告——因为这种静默降级比直接报错更难发现。而 Meta Agent 恰恰是每轮迭代都要反复调用 LLM的角色缓存与成本的正确性直接影响整次运行的开销。实操指南换模型时的三步同步法把官方 OpenRouter profile 复制到./profiles/按下面三步改完整 schema 见 docs/configuration.md改model换成目标模型的路由 ID保留厂商命名空间如openai/gpt-oss-120b同步model_canonical_name改成该模型厂商自己的 ID如gpt-oss-120b——能力表和价格都按这个查如果不确定该填什么干脆删掉该字段是可选的删掉后 SIA 以null加载行为见 tests/test_profiles.py宁可降级也不要填错。⚠️ 提醒换到不支持缓存的模型如openai/gpt-oss-120b时即使 ID 全对缓存本来也不会生效——这是按模型、而非按网关门控的见 docs/configuration.md。常见错误对照表❌ 错误做法✅ 正确做法只改modelmodel_canonical_name沿用旧值两者一起改或删掉 canonical 字段把网关路由 IDanthropic/claude-...填进 canonical 字段canonical 只填厂商官方 IDclaude-haiku-4-5在target profile里加该字段该字段只属于meta agent profiletarget 配置不需要见 sia/defaults/profiles/kimi-nebius-target.json总结model_canonical_name是 SIA meta profile 中的可选字段只用于 SDK 查询提示缓存、上下文窗口与成本计价model是网关路由 ID两者命名体系不同走网关时尤其容易不一致铁律换model必改model_canonical_name——填错不如删掉权威解释与示例docs/configuration.md实现链路sia/profiles.py 与 sia/agent_impls/base.py。【免费下载链接】siaSIA is a Self Improving AI framework to autonomously improve the performance of any AI system (Model / Agent) on a benchmark task.项目地址: https://gitcode.com/GitHub_Trending/sia4/sia创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考