AgoraIO-Extensions / AgoraIO-Extensions/agent-infra

docs(platform): align M1 API observability Eval and audit requirements

Aberta
#474 0 comentários 0 reações 1 responsável Reivindicada por @LichKing-2234 Ver no GitHub
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.

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.