81 lines
4.6 KiB
Markdown
81 lines
4.6 KiB
Markdown
# 箴言助手 Chat Assistant 产品页设计文档
|
|
|
|
## 1. 产品命名与定位
|
|
|
|
- 中文名：箴言助手
|
|
- 英文名：Chat Assistant
|
|
- 产品定位：连接企业数据、领域知识、业务工具与表达策略，为垂直行业提供有依据、可落地、可追溯的智能建议。
|
|
- 演示场景：保险顾问服务与保障建议。
|
|
- 扩展方式：用新的业务数据、知识资源、技能、工具、意图、表达模板和治理策略替换保险资源包，复用对话、编排、权限、观测与审计底座。
|
|
|
|
## 2. 当前项目能力总结
|
|
|
|
以下总结以 `D:\workspace\bankchat` 当前代码、README 和设计文档为依据。产品页只表达代码中已经存在的能力边界，不把路线图能力包装成现状。
|
|
|
|
### 2.1 对话与上下文
|
|
|
|
- 新建、保存和查询会话，按会话加载最近历史消息，并支持较早上下文摘要。
|
|
- 通过 SSE 流式输出回答、工具调用与模型原生 thinking 状态；模型不支持 thinking 时明确降级，不影响正式回答。
|
|
- 支持在输入中显式选择已发布技能及产品、活动、权益对象，并将控制信息与用户正文分开存储。
|
|
- 支持用户档案和表达风格偏好，风格只调整语言表达，不覆盖事实、合规规则和工具结果。
|
|
|
|
### 2.2 业务事实与建议
|
|
|
|
- 保险演示场景复用客户与客户画像、产品、活动、权益查询能力，并以保障建议方式呈现。
|
|
- Agent 可把会话问题、历史上下文、业务查询结果与合规表达资源组合为建议。
|
|
- 快捷动作采用白名单和确定性工具预执行，数据库管理工具元数据，运行体仍由代码控制。
|
|
|
|
### 2.3 可配置的行业资源体系
|
|
|
|
- 意图、技能、工具、方案、表达模板、内容、字典与策略均具有独立资源模型。
|
|
- 资源支持启用、发布、版本历史和回退，并可在解决方案总览中查看关系。
|
|
- 行业扩展不依赖改造聊天外壳，核心工作是建立新的数据对象、行业技能、业务工具与表达策略。
|
|
|
|
### 2.4 数据接入与治理
|
|
|
|
- 数据源支持配置、连通性测试、启停与历史记录。
|
|
- 数据范围支持同步、预览、发布与停用，运行时通过受控目录查询。
|
|
- 字段元数据、敏感字段保护和查询审计形成数据访问边界。
|
|
|
|
### 2.5 模型与运行配置
|
|
|
|
- 使用 OpenAI-compatible API，可配置不同厂商的 Base URL、模型和调用参数。
|
|
- 模型配置支持连通性测试、激活、历史版本与回退，敏感凭据由后端加密存储和脱敏展示。
|
|
|
|
### 2.6 分析、追踪与审计
|
|
|
|
- 会话效果分析包括概要、时序、意图、工具和会话记录。
|
|
- Trace 记录资源选择、工具调用、模型节点、状态与耗时，支持问题回放。
|
|
- 管理操作进入追加式审计事件，并提供查询、详情、选项与完整性校验能力。
|
|
|
|
### 2.7 身份与权限
|
|
|
|
- 浏览器统一通过 Java 网关访问，Python Agent API 仅承载编排与流式生成。
|
|
- 支持 Roncarve IAM OIDC Authorization Code + PKCE 登录与显式应用准入。
|
|
- 外部身份按 `(issuer, subject)` 绑定，不按邮箱自动合并；系统管理员、管理员和普通用户职责分离。
|
|
|
|
## 3. 产品页信息架构
|
|
|
|
1. Hero：用“让行业经验，成为每一次决策的底气”建立核心价值，并展示真实产品对话界面。
|
|
2. 六大能力：企业数据、领域知识、智能建议、来源追溯、行业扩展、安全合规。
|
|
3. 行业扩展：以保险为演示示例，交互切换制造、零售和专业服务场景。
|
|
4. 落地路径：连接、理解、建议、追溯。
|
|
5. 安全可信：统一身份、数据范围与审计观测。
|
|
6. 转化区：邮件预约产品演示。
|
|
|
|
## 4. 视觉方向
|
|
|
|
- 参考“荣刻驭境”的品牌层级、导航比例、大标题力度和企业级质感。
|
|
- 与荣刻驭境的深色粒子主题区分，采用白色与浅灰蓝基底、荣刻蓝主色和克制薄荷绿辅助色。
|
|
- 首屏使用选定方案 1 的真实产品工作台视觉；正文使用清晰分隔、充足留白和少量表面层级，不堆叠卡片。
|
|
- 桌面端以左右分栏为主；移动端改为单列，能力与流程按阅读顺序展开。
|
|
- 中英文共享同一信息架构，并持久化语言偏好。
|
|
|
|
## 5. 实现范围
|
|
|
|
- 新增 `/products/chat-assistant/` 多页应用入口。
|
|
- 新增响应式 React 产品页、行业场景交互、移动导航和中英文切换。
|
|
- 首页产品菜单增加“箴言助手”入口。
|
|
- 更新 Vite 多页构建、Nginx 规范路径和站点地图。
|
|
- 通过现有 Docker Compose 在 `127.0.0.1:8081` 提供本地预览。
|