Skip to content

产品信息架构

产品信息架构

总体对象层级

Workspace
├── Members / Roles
├── Projects
│ ├── Knowledge Bases
│ ├── Studies
│ │ ├── Study Config
│ │ ├── Agent Config
│ │ ├── Interaction Tools
│ │ ├── Output Schema
│ │ ├── Published Links
│ │ ├── Sessions
│ │ │ ├── Transcript Turns
│ │ │ ├── Tool Calls
│ │ │ ├── Extracted Fields
│ │ │ └── Evidence
│ │ └── Study Results
│ └── Reports
└── Integrations

顶层导航建议

1. Home / Dashboard

展示:

  • 最近项目;
  • 正在运行的 studies;
  • 新 session 数;
  • 需要 review 的 extraction;
  • completion rate;
  • 最近洞察。

2. Projects

项目是主题级容器,例如:

  • AI 用户调研平台需求验证;
  • B2B 客户流失研究;
  • 新 onboarding 流程测试。

项目包含:

  • 项目目标;
  • 项目知识库;
  • 多个 study;
  • 统一标签和 participant metadata;
  • 项目级 report。

3. Studies

Study 是一次具体研究,例如:

  • 第一轮 customer discovery;
  • 价格敏感度访谈;
  • 概念 A/B 测试;
  • 流失用户访谈。

Study 包含:

  • research brief;
  • interview guide;
  • agent policy;
  • enabled tools;
  • output schema;
  • published link;
  • sessions;
  • results。

4. Knowledge Bases

支持:

  • 文件上传;
  • 文本片段;
  • URL;
  • Notion/Google Docs 同步;
  • 产品说明;
  • 研究背景;
  • 术语表;
  • 用户分群定义。

每个 KB 应有:

  • scope:workspace/project/study;
  • version;
  • embedding model;
  • retrieval settings;
  • citation policy。

5. Templates

模板类型:

  • customer discovery;
  • concept test;
  • feature prioritization;
  • churn interview;
  • onboarding feedback;
  • NPS follow-up;
  • win/loss interview。

模板应包含:

  • 默认 research goals;
  • 默认 guide;
  • 默认 output schema;
  • 默认 UI tools;
  • 默认 evaluation rubric。

6. Tool Registry

工具类型:

  • interaction tools:渲染用户交互组件;
  • retrieval tools:检索知识库;
  • extraction tools:结构化抽取;
  • export tools:导出 Notion/CSV/Slack;
  • analysis tools:cross-session synthesis;
  • governance tools:consent、PII redaction、review。

7. Results / Insights

视图:

  • session list;
  • structured table;
  • field coverage;
  • evidence viewer;
  • themes;
  • quotes;
  • export。

Project 页面结构

Project Overview
├── Research Brief
├── Studies
├── Knowledge Base
├── Participants / Segments
├── Insights
├── Exports
└── Settings

Study 页面结构

Study Builder
├── Brief
├── Guide
├── Agent
├── Tools
├── Output Schema
├── Publish
└── Preview
Study Runtime
├── Sessions
├── Live Monitor
├── Extractions
├── Evidence
├── Synthesis
└── Export

Session 页面结构

Session Detail
├── Participant Metadata
├── Conversation Transcript
├── Tool Calls
├── Extracted Fields
├── Evidence Links
├── Agent Decisions
├── Quality Score
└── Review / Correction

关键原则

  1. 研究对象和运行时对象分离:Project/Study/Config 不应和 Session runtime 混在一起。
  2. 每个配置对象都要版本化:Agent config、output schema、KB、guide。
  3. 每个 runtime 结果都要指向配置版本,保证可复现。
  4. 前端 UI 组件不应硬编码在 Agent prompt 中,而应通过 tool-call 协议传递。
  5. 所有 insight 必须能追溯到 evidence。