1.立项原因：玩具外贸业务员每天要在 B2B 平台里来回切换多个页面：找产品、找工厂、加选样车、发询价、做报价单、维护客户和客户网站。操作繁琐，新人上手慢，报价计算也容易出错。项目想让业务员用一句中文就完成这些操作，不用记菜单和流程。
2.业务背景：服务对象是汕头澄海玩具产业带的外贸采购与贸易公司。平台上有上万款玩具产品和大量工厂数据，业务员需要对接海外买家，完成从选品、询价到报价的全过程。AI 助手接入平台已有的产品、工厂、活动、客户、网站、选样车、询价、报价、找样九个业务域接口，还整合了 AI 生图生视频和 Excel 报价表提取，成为业务员的一站式工作入口。
1. 智能找货：可以按关键词、类目、展厅、认证、价格区间、装箱量、现货、视频、热度等条件找产品，结果以卡片展示，勾选后可以批量询价、加选样车或生成报价单。
2. 找工厂：按主营、验厂证书、能否开票、是否参展等条件检索工厂，查看联系人、地址和资质。
3. 智能报价：按指定产品或选样车生成报价单，按报价公式算出报出价。支持用一句话调整，比如加运费、加点、换算外币、删掉某款，确认后存入系统，还能导出。
4. 询价 / 找样：发布前弹出表单逐款核对，发布后可以查看供应商的回复并重新询价。
5. 客户管理：新建或修改客户，查看客户名下的网站、选样清单和报价单，给客户一键建站。
6. 选样车管理，查看平台活动。
7. AI 素材：生成产品图片、视频和营销文案。
8. Excel 助手：上传报价表后自动提取成结构化数据。
9. 外贸资讯：联网查行业新规和展会信息。
前端是对话加结果面板的布局，顶部航线按「找货→找厂→选样→询价→报价→客户」展示业务进度。
我独立负责整个项目，包括架构设计、后端开发、前端页面、对接后端接口和测试。
技术栈：Python 3.12 + FastAPI + LangGraph 1.2 + PostgreSQL，前端用原生 HTML/JS，Docker 部署。
架构：主 Agent（Supervisor）只负责理解意图和调度。业务能力拆成只读、写入、交接三类工具，报价是一张独立的多节点子图。每个业务域通过适配层（Port 协议，分 Real / Fake 两套实现）对接后端 REST，一个开关就能在真实接口和本地样本数据之间切换。
亮点与难点：
1. 写操作执行前用 LangGraph interrupt 弹出确认卡片，人工确认后才继续。会话状态存在 Postgres checkpoint 里，服务崩溃后能恢复，重复提交也不会重复执行。
2. 多租户隔离：所有会话统一经过一个鉴权入口，身份只从运行时上下文取，不让模型通过参数伪造。越权访问一律返回 404，并用 AST 静态检查接入 CI 来保证这条规则。
3. 为了让国产大模型准确选工具，控制工具数量，并建立路由回归评测集，验收标准是误选率为 0、通过率不低于 90%。
4. SSE 流式输出，配合运行轨迹落库（节点、工具出入参、token、耗时）和调试台，方便排查问题。
评论