Agent Revision

角色

AgentRevision 是不可变可执行修订版，承载当前发布版本的执行画像、run policy、Agent 侧协议能力、稳定 callable 目录和 secret 引用。

核心字段

• agentRevisionId
• agentId
• orgId
• card
• protocolProfiles
• callableRefs
• executionProfile
• runPolicy
• secretRefs
• createdAt

规范要求

• AgentRevision 一旦创建 MUST 视为不可变
• run 创建时 MUST 解析到一个确定的 agentRevisionId
• protocolProfiles 只声明 Agent 侧协议能力、identity projection 和 canonical 语义映射，不声明 endpoint / transport / security 绑定
• callableRefs[] MUST 作为 Agent 可调用资源的稳定目录，允许引用 Agent、Tool 和 McpServer
• callableRefs[] 的同组织引用 MUST 解析到本组织资源；跨组织引用 MUST 通过 CallableGrant
• bindingMode=invoke 只应用于 agent 与 tool；bindingMode=inject 只应用于 mcp_server
• Agent 如需暴露 MCP，MUST 通过 callableRefs[] 中 resourceType=mcp_server 的条目引用确定的 McpServer
• 既有 run MUST NOT 因 channel 切换或 Agent 更新而漂移到其他 revision

设计说明

• callableRefs[] 统一取代只针对 MCP 的注入目录
• revision 负责声明稳定依赖目录；run 输入只负责本次启用的 alias 子集与少量追加 callable
• ephemeralTools[] 仍可在 run 输入里存在，但不属于平台注册资源目录