项目开发相关讨论
会议时间:2025年6月5日 参与人员:说话人A(主导,负责架构与方向)、小关(前端 UI 调整)、朱晨(URL 读取与 API 接入)、说话人B(朱晨/相关开发)
一、核心议题
1. 项目结构与 LangGraph 后端集成
- 背景:当前项目从 LangChain 模板新建而来,并增加了”选择助手”等功能。
- 决策:将 LangGraph 后端代码直接写到 Web 项目内部,因为后端会调用其他数据库与工具,集成更方便。
- 聊天页面:目前作为单独项目(仅一个页面)。
- 后续可能集成进 Web 项目,作为某个 page 下的页面与文件夹结构。
- 暂时维持独立项目,前端只需保证响应式即可,方便后续放进系统侧边栏。
2. Agent 与会话 API 工作机制
- LangGraph 在 Web 项目里跑成一个独立 Server,提供与 AI 对话的 API。
- GS 端通过 LangGraph SDK 调用,会话历史记录由 Server 自动管理,前端无需自管。
- 后期再补充用户隔离与权限鉴别,目前可暂不处理。
3. UI 调整方向(小关负责)
- 输入框样式调整,包括首页的输入框形态。
- 替换 logo(找黑色版本)。
- 输入框加 action 按钮(搜索等)。
- 末尾增加”圆点”形式的设置图标,点击后弹出下拉菜单(servo/服从样式),承载更多设置项。
- 增加文件上传:支持拖拽文件到整个页面(组件默认支持)。
4. 推荐相关 Agent 优化
- 把基础 AI 功能从原项目快速复制一份过来。
- 重点是”宜品找客”逻辑:用 AI agent 完成产品推荐 + 客户搜索的全流程。
- 推荐结果要更完善:包括每个推荐里有多少个系列、每个系列多少个产品,由 agent 自检不断完善。
5. 朱晨负责的 URL 读取进展
- 仍在测试,部分网站存在解析问题。
- 主要目标:任意一个网站能直接读一次;亚马逊页面应能从读网页 API 拿到商家部分信息(不必走亚马逊专用接口)。
二、技术决策与方案细节
LangGraph + Web 项目集成
- LangGraph Server 独立运行,对外暴露 chat API。
- 工具调用结果两种渲染方案:
- 服务端处理 UI:服务端处理完后将组件信息发到前端。
- 前端处理 UI:前端根据工具调用信息直接渲染卡片(如以前的产品推荐卡片)。
- 当前未最终敲定,需要后续验证。
任务触发与 agent 调用
- 任务系统调用 agent:宜品找客 agent 既可由页面触发,也可由后台定时任务触发。
- 后台触发 agent → 找客户信息 → 集成回页面。
- 开发阶段先实现”通过聊天的方式调用”。
公网数据来源扩展
- 在原有内部库基础上,新增从公网获取部分数据。
- 全部用 agent 模式串联起来。
组件安装方式
- 走 shadcn 的方式(“安吉智行”指代 shadcn 组件安装命令)。
三、UI/交互细节
- 会话页面:基础聊天 UI,工具调用时显示调用的工具与结果,再展示 AI 回复。
- 首页:将输入框样式调整到目标形态(参考设计稿)。
- Logo:替换为黑色版本,需小关找资源。
- 发送框 action:
- 增加搜索按钮等若干 action。
- 末尾增加圆点设置图标 → 点击展开 servo 设置面板,未来扩展更多设置。
- 文件上传:发送框带上传入口;同时支持拖拽文件到整页面。
- 消息部分:默认渲染基本够用,如无需调整就保持默认;如需自定义则去 message 模块改。
- 基础组件:基础性 UI 不必改,重点改业务相关 UI。
四、后续行动与分工
| 角色 | 任务 |
|---|---|
| 说话人A | 把 agent 部分功能从旧项目快速复制到新项目;优化推荐 agent 为左右布局 |
| 小关 | 调整聊天页面 UI(输入框、logo、action、设置图标、文件上传) |
| 小关 | UI 改完直接 push,无需特别协调;不动其他既有逻辑 |
| 朱晨 | 继续测试 URL 读取,保证任意网站能读一次 |
| 朱晨 | 优先支持读网页 API 直接获取亚马逊商家部分信息;如不行再走亚马逊专用接口 |
| 团队 | 完成基础 AI 功能迁移后,攻坚”宜品找客” agent,先实现简易版本 |
五、其他要点
- 项目目标节奏:先把基础 AI 功能迁过来,再做”宜品找客”,再做与系统任务模块的深度集成。
- 当前 agent 实现都先用聊天方式驱动,逐步演进为后台任务触发。
- UI 部分小关可放心 push,说话人A 也会同步改动,不互相阻塞。
- 推荐 agent 的展示形态会从”消息内嵌卡片”演进为”独立 UI 区域”。
- 亚马逊读取重点:搜索某商品后获取页面里的”商家”部分信息,作为客户线索。
- 如有问题随时同步说话人A。
- 后续可能要把 chat 项目的页面与文件夹整体放进 Web 的某个 page 下,目前暂不做以减少改动量。
- 强调”响应式 + 可独立运行”原则,方便后续无缝接入侧边栏。