不同层次回答不同问题
能力有归属
Sandbox 声明云资源与网络能力;Harness 声明对话、Tools 和初始化能力;Tool adapter 参与审批能力。一个 adapter 不能替另一层授予能力。required_capabilities 只是请求条件,不是创建能力的开关。
例如 OCI recipe 可以构建,但所选 Provider 没有 oci_image,组合仍不支持。又如模型端点通过验证,不表示该 Harness 的所有 Tool calling 和 continuation 行为都已实际验证。
读懂矩阵
一条结果至少核对 Provider、Harness 版本或镜像 digest、模型端点和协议、SDK、任务范围、日期与清理结果。将 passed、failed、未执行和明确 unsupported 分开。未知结果保留 unknown;不能为了整齐把它归为成功或不存在。 历史矩阵证明当时的具体执行。当前 preflight 的verification 保持 unverified,避免把历史通过自动认证到新配置。供应商账户、端点和部署状态发生变化时,需要新的验证。
两个判断例子
例一:镜像能构建,组合仍不支持。 你在本地成功构建某个 OCI Harness 镜像,只证明构建过程产出了镜像。若所选 Sandbox adapter 未声明oci_image,Session 预检会以 sandbox_oci_image_unsupported 拒绝。私有镜像还要求 private_oci_image,以及可用的 registry Secret。增加 required_capabilities 不能补出这些能力。应选择满足需求的执行路径,重新预检,再验证实际拉取、启动和任务;不能把构建成功登记为实云通过。这是机制示例,不是对某个 Provider 当前支持状态的固定结论。
例二:模型验证成功,工具旅程仍未验证。 指定端点通过连接检查,不代表选定 Harness 能以该协议完成 Tool calling。先检查 Harness 的模型协议和 tools 声明,再检查绑定 Tool 的操作范围、授权与审批能力。实际旅程还需观察模型发出调用、Runtime / broker 处理、必要授权或审批、结果回到模型、同一 Run 继续并完成。只收到一段模型文本不能证明这条链路。协议不兼容、任务执行失败、尚未执行测试应分别记录。
supported 与 unverified 可以同时成立
组合解析结果把结构判断与实测分开。下面是说明字段关系的摘录,不是一次真实预检响应:ready: true 不意味着云配额预留、镜像已经拉取,或模型与所有 Tool 已执行成功。不兼容请求可能直接得到错误响应,而不是上述 JSON;不要假设总能在成功响应里读取拒绝原因。
为一个应用选择证据
- 列出实际需要的行为。 例如上传项目、多轮修改、审批后写入、私有预览、空闲唤醒和关闭后下载。以应用旅程为准,不因为已有测试缺某一步就删掉需求。
- 固定组合身份。 记录控制平面 revision、SDK 版本、Sandbox 连接、Harness version / digest、模型 endpoint / model ID / 协议与 Tool 配置。连接显示名不足以唯一标识一次测试。
- 排除已知结构冲突。 用 catalog、连接验证和预检回答各自的问题。遇到明确 unsupported 先处理组合,不把重复任务提交当作兼容性修复。
- 寻找范围吻合的既有记录。 在已验证组合逐项核对旅程和日期;较新的专项结果只更新其覆盖的交叉组合,不抹掉旧失败或未决操作。
- 补测缺失的关键分支。 执行所需 SDK 的独立旅程,记录结果与清理;断线、授权、审批、恢复等分支有单独断言。一次成功回答不能代替完整旅程。
为什么不能把所有 capability 名称直接合并
解析器按明确的归属规则建立能力集合,不会把每个 adapter 返回的字符串全部合并。
这些是解析器规则,不证明某次获准操作已正确执行。是否需要审批仍由具体 Tool 策略和调用决定。目录通过 Harness registry 提供;连接 adapter 与组合解析器 确立相应边界。