Agent定义与版本

描述Agent能力、prompt、工具和策略的不可变配置。

Agent定义是一份能力配置，运行实例是它的一次使用。定义可以包含prompt模块、模型路由、工具schema、停止策略和适用领域；部署则把获准版本发布到某个环境或租户。把二者分开，才能在同一时间服务旧任务、新任务和灰度实验，而不靠一个可变名称解释结果。

版本不仅是一个字符串。应保存定义正文与依赖hash、owner、变更理由、评测报告、批准状态和回滚目标。工具接口、检索配置或memory政策变化也可能改变能力，即使prompt没改。公开框架提供不同程度的配置和注册能力，企业仍需定义自己的发布合同，不能默认框架替你冻结了全部依赖。

已有Run绑定开始时的配置快照；需要中途变更时记录明确边界和原因。紧急安全策略可以立即缩减能力，但应使相关Run重新核验，不能把旧批准当长期通行证。模型厂商未提供固定snapshot时，要记录可复现性的限制，并持续运行哨兵任务。

金融与法律Agent可以共享一个基类，却使用不同领域规则和工具范围。不要把所有变化塞进全局system prompt，再同时影响教育与投研。验证应能从任一产物找回对应Agent定义、模型与工具版本，并比较灰度和基线。配置回滚也要检查数据schema和已发生副作用；把指针改回旧版本，不能撤回已经发出的消息。

定义还可以声明适用任务和停止边界。例如某版本只支持公开财报比较，不支持交易执行；新增下单工具时，不是普通文案更新，而是能力合同变化。即使配置文件只有几行差异，也要重新评测授权、回执和失败处理。版本号的大小不能代替对行为变化的判断。

版本目录还应允许停用存在缺陷的能力，并说明对新任务和在途任务分别怎样生效。

实践重点：部署指向获准版本；执行记录精确配置与工具schema，不靠名字识别。

验证抓手：重放旧任务时能定位对应定义和依赖版本。

常见误区：运行中静默修改所有Agent的规则，导致结果无法归因。

OpenAI：Agent运行时选择；OpenCode：session_v2与消息表源码。