主题
Agent
角色
Agent 是稳定的产品身份对象,承载 catalog/card、可见名称、默认发布入口与治理元数据。
可执行配置、协议能力和 secret 引用不直接挂在 Agent 本体上,而是挂在不可变 AgentRevision 上。
核心字段
agentIdorgIdcarddefaultReleaseChannelIdlatestRevisionIdenabledtagsmetadata
规范要求
- Agent
MUST归属于单一orgId enabled=false的 AgentMUST NOT接受新 run- Agent
MUST NOT直接承载会影响既有 run 冻结语义的可变执行配置 - Agent 的 northbound 暴露
MUST通过ReleaseChannel、AgentRevision与ProtocolBinding组合完成 - Agent
cardSHOULD作为稳定产品身份;revision 只允许做与当前发布版本一致的补充投影
设计说明
Agent负责“这是什么能力”AgentRevision负责“这次发布具体跑什么、支持什么协议能力”ReleaseChannel负责“新 run 解析到哪个 revision”ProtocolBinding负责“某个 revision 在哪里、用什么 transport 和安全方案对外暴露”