Tool

角色

Tool 是稳定可治理的能力身份对象，可被 AgentRevision.callableRefs[] 以 bindingMode=invoke 引用，也可作为 Run.resourceType=tool 的执行目标直接运行。

输入/输出 schema、执行模式、运行画像和鉴权策略定义在不可变 ToolRevision 上。

核心字段

• toolId
• orgId
• name
• description
• defaultReleaseChannelId
• latestRevisionId
• enabled
• metadata

规范要求

• Tool MUST 有稳定身份，不随 revision 切换而漂移
• Tool 作为 direct run target 时，CreateRun.input MUST 使用 tool-run 输入形状，而不是复用 agent message 输入
• Agent 通过平台注册目录调用 Tool 时，平台 SHOULD 创建独立 tool 子 run，而不是把调用事实隐藏在 runtime 私有内存中
• Tool 的同步、异步、流式执行语义 MUST 在 ToolRevision.executionMode 中显式声明
• Tool 的鉴权与运行期 session / run 鉴权 MUST 分离表达

设计说明

• Tool 负责 catalog 身份与治理入口
• ToolRevision 负责真实可执行契约
• ReleaseChannel 负责 direct run 或 Agent callable resolution 解析到哪个 revision
• Tool 可独立存在，也可被 McpServerRevision.toolCatalog[] 以引用方式纳入某个 MCP server 的暴露目录