Skip to content
AgentSurvey

PRD 总览

AgentSurvey PRD · 总览

本目录是 AgentSurvey 的产品需求文档（PRD），分模块组织。技术选型见 技术选型决策 ADR，落地节奏见 交付计划。

1. 产品目标

AgentSurvey 是开源 agentic 用户调研平台：研究人员配置研究目标、知识库、输出结构与工具能力；AI Agent 在访谈中自主追问、按需渲染交互组件、抽取结构化结果，并把每个结论链接回原始对话证据。

核心差异化 = 可信、可审计、带证据链的结构化研究输出（而非又一个聊天机器人或传统问卷）。

2. 角色

角色说明主要场景
researcher（研究人员）创建项目 / study、配置 Agent 与输出、查看与修正结果Admin 端全流程
participant（受访者）通过公开链接参与 AI 访谈Interview 端
admin / developer配置模型 provider、工具、查看 agent decision log平台配置与运维

3. 范围

  • MVP（P0）：完成「创建 study → 配置 → 发布 → 受访者 AI 访谈（含交互组件）→ 结构化抽取 + evidence → 结果查看 / 修正 / 导出」的最小闭环。
  • 后续（P1+）：知识库 / RAG、模型与工具高级配置、跨 session insight、团队权限、更多题型。
  • 非目标（MVP 不做）：复杂多团队权限、participant panel、视频访谈、可视化 workflow builder、自动 PPT、SSO、焦点小组、高级统计。详见 MVP 计划。

4. 模块地图

#模块优先级PRD
01Auth & WorkspaceP001_auth_workspace
02Projects & StudiesP002_projects_studies
03Study BuilderP003_study_builder
04Interview RuntimeP004_interview_runtime
05Interaction ComponentsP005_interaction_components
06Extraction & EvidenceP006_extraction_evidence
07Results & ReviewP007_results_review
08Knowledge BaseP108_knowledge_base
09Model & Tool ConfigP109_model_tool_config
10Non-functional—10_nonfunctional

5. 全局优先级

  • P0（MVP 必须）：模块 01–07。这是闭环的最小集合。
  • P1（重要增强）：模块 08–09。
  • 非功能：模块 10（性能、安全隐私、可观测、i18n、a11y、可重放）贯穿全程。

6. PRD 编写规范（统一模板）

每个模块 PRD 按以下结构编写，确保可追溯、可验收：

---
title: <模块中文名>
description: <一句话>
---


# <模块名>


## 1. 目标 & 范围
## 2. 用户故事        （按角色:researcher / participant / admin,"作为…我希望…以便…")
## 3. 功能需求         （FR-<模块号>-<序号>,每条带优先级 P0/P1 + 简述 + 验收要点）
## 4. 关键流程         （引用 user_flows / interactive_ui_protocol,可用文字流程图）
## 5. 数据             （涉及实体/字段,引用 data_model.md 表名）
## 6. 接口             （涉及 REST / AG-UI 事件,引用 api_contracts.md）
## 7. 验收标准         （可测试,逐条编号）
## 8. 边界 & 非目标
## 9. 依赖 & 风险

约定：

  • FR 编号格式 FR-<NN>-<n>，如 FR-04-3（模块 04 第 3 条）。
  • 交叉引用其他模块用文件名，如「见 02_projects_studies」。
  • 验收标准必须可测试（避免「体验好」这类弱标准）。
  • 中文撰写，技术术语与标识符保留原文。

7. 术语表

术语定义
Workspace顶层租户容器,隔离数据与成员
Project同一研究主题下多个 study 的容器
Study一次具体研究任务(含 brief / objectives / output schema / 工具 / KB 配置)
Study Versionstudy 配置的版本快照;session 绑定具体 version
Session一次受访者访谈的运行实例
Objective研究目标;harness 据此决定追问与覆盖
Coverage某 objective 的覆盖状态(未开始/进行中/已覆盖…)
InteractionAgent 通过 render_interaction 渲染的交互组件(单选/多选/Likert/排序…)
Tool Call / ResultAgent 工具调用及其结构化结果,持久化入 transcript
Extracted Field按 output schema 抽取的结构化字段(带 confidence/status)
Evidence字段值回链的原始证据(quote / tool selection,带 strength)
Insight跨 session 的派生结论
HarnessAgent 运行时(LangGraph 显式状态机),驱动 ask/probe/render/extract/conclude
AG-UIagent ↔ 前端的事件协议(HTTP/SSE)

8. MVP 验收总纲

闭环验收(详见 MVP 计划 的 Functional / Technical / UX Acceptance):

  1. 可创建多 project / study,各自独立 objectives / output schema / enabled tools。
  2. 发布链接后匿名受访者可完成一次 session。
  3. Agent 至少能调用 4 种交互组件(single / multiple choice、Likert、ranking)。
  4. Session 结束生成结构化字段;每个 required 字段至少一条 evidence 或标记 needs_review。
  5. 研究人员可人工修正字段并导出 JSON / CSV。
  6. 技术:runtime 不依赖全局单例、config 版本化、tool call/result 可持久化、transcript 可重放、provider 可替换、extraction 可重跑。

9. 关联文档