项目开发相关讨论

会议时间: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。
  • 工具调用结果两种渲染方案:
    1. 服务端处理 UI:服务端处理完后将组件信息发到前端。
    2. 前端处理 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 下,目前暂不做以减少改动量。
  • 强调”响应式 + 可独立运行”原则,方便后续无缝接入侧边栏。