AgoraIO-Extensions / AgoraIO-Extensions/agent-infra
docs(platform): align M1 API observability Eval and audit requirements
- Linguagem predominante
- TypeScript
- Estrelas
- 0
- Forks
- 0
- Merge médio
- 8h 51min
- PRs com merge (30d)
- 99
Descrição
## Problem
当前平台 PRD 仍将 Agent API 和 Eval 列为 Roadmap,审计页面不作为首发必需,且角色、任务和 Connection 表述未覆盖已完成的 M1 范围决策。需要先形成一份完整、可评审的产品需求修订,供工程文档和实施契约消费。
决策依据:[M1 范围地图](https://github.com/AgoraIO-Extensions/agent-infra/issues/464)及 [最终衔接结论](https://github.com/AgoraIO-Extensions/agent-infra/issues/470#issuecomment-5646568047)。
## Scope
- 仅修改 `docs/prd/PRD-agent-platform-M1.md`,将已确认的用户/应用 API、运行任务、全链路可观测、Eval 和审计要求写为正式产品行为与验收标准。
- 明确 API 免审批但鉴权、授权并审计;保留 Web 创建申请与审批的渠道边界,不新增未确认的执行超时参数、优先级、定时任务或多 Agent 编排。
- 明确独立 Connection MCP/API 直连、各自授权与数据权威、真实执行关联审计;删除平台 PRD 中与该最终边界相反的代理、Grant 副本或 Connection 状态投影职责。
- 保留其余已确认 M1 能力及 Roadmap 范围,使用简洁中文与产品术语,不加入调研过程、代码接口或工程实现参数。
- 在本票/PR 中记录 Connection PRD、工程 Spec、Runtime/Connection HLD 与交付计划的具体后续同步点和现有负责入口,不将其写进产品 PRD。Connection 文档及新 DAG 仍由既有独立对齐任务负责,Runtime Spec/HLD 的并行模型改动不由本票覆盖。
- 交付产品 PRD 的独立评审稿;跨文档一致性完成前 PR 保持 Draft,不据此宣称工程契约已一致、实现已完成或发布已授权。
## Acceptance criteria
- [ ] **AC-1:** PRD 定义用户/应用独立身份、Owner 与创建主体、初始显式授权、API 凭证范围及失效、任务按主体隔离;API 免审批并审计。
- [ ] **AC-2:** PRD 覆盖创建/启动 Agent、异步任务、有界受理、会话连续性、状态/结果查询、幂等、取消及真实恢复结果,并明确 API 与 Web 的交互边界。
- [ ] **AC-3:** PRD 将任务详情和运行可观测、固定评测集对比、规则/人工/模型评分、失败样本分析及主动反馈纳入 M1,定义评测内容的独立授权与隔离。
- [ ] **AC-4:** PRD 将审计 API 和基础管理页面列为 M1 必需,覆盖治理/执行/外部操作,定义角色查询权限及独立 Connection 直连与审计关联;无平台代理或 Connection 数据投影职责残留。
- [ ] **AC-5:** 上线验收可逐项对应已确认决策,其他 M1/ Roadmap 能力未被扩张或删减;后续跨文档同步点在 Issue/PR 中具名映射到现有对齐入口,未宣称已同步。
- [ ] **AC-6:** 完成仓库规定的完整验证与独立 Standards/Spec 评审,保留真实结果和限制,检查相对链接及 `git diff --check`。
## Validation
- 逐项对照 API 身份、任务、可观测、Eval、审计及最终 Connection 边界决策,人工检查产品术语、角色权限、数据范围和验收完整性。
- 搜索 Agent API/Eval Roadmap 残留、审计非首发条款、Platform 代理/Connection 投影表述,并检查相关文档链接。
- 按 AGENTS.md 执行 frozen install、check、check-types、test、build、smoke、docker:build、Markdown lint/link、workflow policy、actionlint 与 diff check。
- 由独立 Standards 和 Spec reviewer 检查本票的完整 diff。PR 保持 Draft;跨文档衔接分别引用 Connection 文档对齐、Runtime 当前任务及完整 M1 汇合入口。
## Blocked by
None
Guia de contribuição
Nenhum guia de contribuição indexado para este repositório
Avaliação
Esta issue ainda não foi avaliada.