33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
# Brief: single-react-aci-tool-contracts
|
||
|
||
## 背景
|
||
|
||
旧 RAG 和日志 Tool 暴露检索/基础设施细节与不一致状态，MySQL Tool 尚无 Agent-facing 类型。Harness 实现前需要先冻结三类最小 ACI 契约。
|
||
|
||
## 目标
|
||
|
||
- 冻结 RAG、日志、MySQL 的 Request/Result JSON Schema。
|
||
- 统一 `evidence_status`，并保持其与 invocation lifecycle 独立。
|
||
- 统一使用框架 `tool_call_id`，禁止模型传入或 Harness 生成第二套 ID。
|
||
- 冻结简短 Tool 名称/描述和 Mock 日志来源边界。
|
||
- 用三个独立契约测试锁定行为。
|
||
|
||
## 范围
|
||
|
||
- 新增 `com.superbiz.agent.harness.tool.contract` 值对象、枚举和描述常量。
|
||
- 复用阶段 0 的 `InvocationStatus` 与 `EvidenceStatus`。
|
||
- 验证 JSON、不可变集合、描述泄漏和新旧边界。
|
||
|
||
## 非目标
|
||
|
||
- 不切换旧 RAG/日志运行方法或 Chat/AIOps 注册。
|
||
- 不实现投影、Redis store、真实日志适配器或 MySQL 执行。
|
||
- 不修改 Controller/SSE 或公开协议。
|
||
|
||
## 元数据
|
||
|
||
- 分档：standard
|
||
- 接口影响：L2 前置内部契约；当前运行行为无变化
|
||
- 关联 Issue：ISS-014 阶段 1
|
||
- 关联 OpenSpec：`openspec/changes/single-react-aci-tool-contracts`
|