Skip to content

Agent

角色

Agent 是稳定的产品身份对象,承载 catalog/card、可见名称、默认发布入口与治理元数据。

可执行配置、协议能力和 secret 引用不直接挂在 Agent 本体上,而是挂在不可变 AgentRevision 上。

核心字段

  • agentId
  • orgId
  • card
  • defaultReleaseChannelId
  • latestRevisionId
  • enabled
  • tags
  • metadata

规范要求

  • Agent MUST 归属于单一 orgId
  • enabled=false 的 Agent MUST NOT 接受新 run
  • Agent MUST NOT 直接承载会影响既有 run 冻结语义的可变执行配置
  • Agent 的 northbound 暴露 MUST 通过 ReleaseChannelAgentRevisionProtocolBinding 组合完成
  • Agent card SHOULD 作为稳定产品身份;revision 只允许做与当前发布版本一致的补充投影

设计说明

  • Agent 负责“这是什么能力”
  • AgentRevision 负责“这次发布具体跑什么、支持什么协议能力”
  • ReleaseChannel 负责“新 run 解析到哪个 revision”
  • ProtocolBinding 负责“某个 revision 在哪里、用什么 transport 和安全方案对外暴露”

白皮书与规范内容以仓库真源为准。