客服与业务办理 AI 助手
支持知识问答、业务查询、退款申请与转人工，退款执行须经人工确认。
01 / 03
项目介绍
这是一套面向多租户 SaaS 客服与运营场景的全栈 Agent 系统。Next.js 界面通过同源 BFF 维护服务端身份上下文，FastAPI 建立可信身份并执行共享额度控制，Qwen 只负责结构化路由、资料生成和只读 Tool 参数生成。LangGraph 将请求限制在知识问答、本人业务查询、退款草稿和转人工四条路径，PostgreSQL 分别保存业务数据、向量、Checkpoint、草稿、执行与审计证据。退款执行需经过身份、对象范围、参数、人工确认和幂等检查，并通过请求级 Trace 与安全错误边界补齐运行控制和故障定位。
- 分类
- AI 项目 · Agent
- 角色
- AI Agent 与全栈应用工程
技术栈
项目特点
我的职责
完成 Next.js 响应式交互界面与同源 BFF，由服务端注入演示凭证并将结构化请求转发至 FastAPI，浏览器不保存密钥，也不决定写操作结果。
使用结构化输出将请求限制在 knowledge、business、refund 与 handoff 四种路由，未注册目标无法进入工作流。
建立可信身份上下文，在查询阶段执行 Tenant、Owner 与角色范围，通过固定 Tool Registry、严格参数校验和用户明确业务编号一致性检查控制模型能力。
以 LangGraph 编排退款草稿、人工暂停和批准/拒绝恢复，使用 PostgreSQL Checkpoint 保存跨请求状态；恢复时重新认证，并以稳定幂等键和数据库唯一约束保护单次执行。
为四条分支建立统一 API、共享 AI 请求额度、允许字段 Trace 与安全错误边界，并补充越权、注入、重复执行、跨请求恢复和故障脱敏测试。
关键亮点
知识分支不获得 Tool Schema，检索内容即使包含恶意指令也只能作为不可信资料参与回答，不能跨越到写操作。
业务查询只开放固定只读工具；即使模型参数格式正确且对象可访问，只要与用户本次明确提出的业务编号不一致，也会在数据库查询前拒绝。
Checkpoint 只负责保存 Graph 状态与恢复位置，退款草稿、执行记录和审计事件分别记录业务事实，模型回答和流程状态不能替代实际业务证据。
退款流程在人工确认处显式暂停，未经批准不执行退款；批准后以幂等执行与审计事件处理重复请求，拒绝后不能改为批准。
请求级 Trace 只记录 Route、阶段、状态、Tool、耗时、Token 与估算成本等允许字段；数据库原子额度控制限制共享用量，两者都不替代认证或业务证据。
成果
完成了 Next.js 产品界面、同源 BFF、FastAPI API 与四条受控分支的端到端闭环。退款流程通过 PostgreSQL Checkpoint 跨请求持久化恢复，并以草稿、执行记录和审计事件证明确认前不执行退款、批准后幂等执行、拒绝后不可反转；转人工以实际 Ticket 为结果依据。共享额度、请求级 Trace 和安全错误边界补齐了运行控制与问题定位能力。整体工作流按照生产环境的身份边界、写入控制、状态恢复与审计要求设计，为接入真实客服与运营业务、持续扩展工具和完善认证体系提供稳定基础。