gongzhiyong
2a6a709f58
Add a complete docs skeleton for onboarding and integration, including orchestration-plan contract, acceptance matrix, OAuth flow, architecture maps, and milestone status tracking to support Agnet-facing delivery work. Made-with: Cursor
2.2 KiB
2.2 KiB
Agnet 集成验收矩阵
本文用于把集成设计从“建议”变成“可执行验收项”。
1. 验收范围
- 编排控制面（部署/停止/查询）
- 租户隔离与权限
- SK 快照只读边界
- 事件流（运行态 + 子 agent 输出）
- 回调签名与重试
2. 用例矩阵（最小集）
| ID | 类别 | 场景 | 前置条件 | 期望结果 |
|---|---|---|---|---|
| A01 | Happy path | agile_min 一键部署成功 |
模板可用、成员与模型已授权 | 返回 deployment_id，实例进入 pending→running |
| A02 | Happy path | waterfall_min 一键部署成功 |
同 A01 | 返回 deployment_id，角色实例齐全 |
| A03 | 授权 | 成员指定未授权模型 | 组织模型白名单不包含该模型 | 拒绝，MODEL_NOT_ALLOWED |
| A04 | 多租户 | Tenant A 访问 Tenant B 部署 | 两租户均有数据 | 返回 403 或 404（不泄漏存在性） |
| A05 | SK 边界 | 子 agent 绑定越权路径 | sk_sources 路径超白名单 |
拒绝，SK_SOURCE_UNRESOLVABLE 或 FORBIDDEN_CROSS_TENANT |
| A06 | 预算 | 模型提案预算超限 | 策略设定 max budget | 拒绝，BUDGET_EXCEEDED |
| A07 | 幂等 | 同 intent_id 重复提交 |
首次已 accepted | 第二次返回冲突或幂等复用，DEPLOYMENT_CONFLICT |
| A08 | 回调安全 | callback 签名错误 | 模拟篡改签名 | 拒绝处理并记审计 |
| A09 | 事件流 | SSE 断线后续传 | 已产生事件、支持 Last-Event-ID |
重连后补齐丢失窗口事件 |
| A10 | 子输出流 | 会话订阅 sub_agent.output |
会话内子 agent 正在运行 | 客户端收到 output_delta 流式事件 |
3. 验收字段（每条事件必须）
event_idschema_versiontenant_idproject_iddeployment_idcorrelation_idoccurred_at
4. 验收结论模板
| 项目 | 结果 | 备注 |
|---|---|---|
| 通过数 / 总数 | ||
| 阻断问题 | ||
| 风险接受项 | ||
| 下一轮回归时间 |
5. 执行建议
- 每次版本上线前至少执行 A01/A02/A04/A05/A08/A09
- 每次策略变更后追加 A03/A06 回归
- 验收输出应关联
request_id与correlation_id，便于排障