AI Helpdesk：多智能体客服支持系统，含路由分派、SQL 智能体委派与逐句校验

heyemlee/ai-helpdesk

GitHub原文发布未知首次收录 2026-10-18上架 2026-10-18 07:00

ELI5：它是什么，解决什么问题

AI Helpdesk 是一个基于 FastAPI 的多智能体客服服务：路由器对问题意图进行投票，工具并发执行，三个领域专家智能体在需要时并行作答，并通过有界工具循环补查缺失信息；数据类问题经 A2A 或 HTTP 委派给独立的 SQL 智能体，由其规划、编写、执行并修复查询。系统在发送前逐句校验回答，替换无依据的价格或日期承诺，低置信度时转人工开票，并在 React 控制台中实时展示各智能体的决策过程。项目附带检索纠错循环、Redis 工作记忆、双入口部署和 OpenTelemetry 可观测方案，并提供评测记录。

# RAG # multi-agent # FastAPI 全栈 # hybrid-search # Agent 评测

核心能力与快速开始

★ 0 · Python

能做什么: 包含意图投票路由（LLM、嵌入与规则加权，覆盖 19 种意图）、按域选择专家智能体并支持并行协作与副本权重监控；在开启工具循环时，专家可通过函数调用自行检索或查询业务数据，有调用次数与超时预算。知识检索采用 pgvector 稠密与关键词稀疏检索融合、rerank 及一次纠错补查。数据问题可通过 A2A JSON-RPC 或 HTTP 委派给 ai-sql-agent，并对结果做证据与降级状态校验。每条回答经过规则化护栏检查，低置信度转人工并创建工单；提供 SSE 流式应答、轮次事件日志、Redis 工作记忆与会话摘要。
适用场景: 适合构造多专家协作的客户支持或内部服务台问答系统，尤其是问题同时涉及知识库检索与业务数据查询的场景；可用于演示与评估意图路由、A2A 智能体委派、回答护栏与人工接管流程；React 控制台的学习模式可用于观察与讲解每个智能体决策。
项目形态: 开发框架
部署方式: 未说明；README 提到 Docker Compose 编排 12 个服务、Nginx 作为唯一外部入口，以及 GitHub Actions CI，但未给出完整的安装与上线步骤说明。
主要依赖: 未说明；从技术栈看需要 Python 3.12、FastAPI、PostgreSQL 16 + pgvector、Redis 7，以及 Anthropic 或 OpenAI 模型接口；控制台使用 React 18 与 Vite 6。硬件规格与 API 费用未说明。
使用限制: 未说明。评测数据来自作者自建、虚构的企业客服场景与模拟 API，路由与端到端结果基于中文标注样本；内置意图、专家、SOP 与知识面向制造业客服，迁移到其他领域需自行改写代码。
许可证: 未说明
最近推送: 2026-10-18 06:08

核对 README 依据 ↗

资料检查：2026-10-18 07:00 · 卡片整理：2026-10-18 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证

职业应用

程序员

作为多智能体客服系统的参考实现，程序员可研究其 FastAPI 服务架构、路由投票、A2A 委派、有界工具循环、逐句校验与 OpenTelemetry 可观测方案，并参考其 pytest、A2A 契约测试和评测记录进行开发与测试。

查看内容依据

A FastAPI agent service: a router votes on each question's intent, tools run concurrently, specialist agents answer (in parallel when a question spans domains) and look up what is still missing in a bounded tool loop, and every sentence is checked before it is sent.

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

Knowledge Base RAG：面向多租户的多语言检索增强生成平台

该项目是一个生产风格的多语言 RAG 平台，覆盖混合检索（Qdrant 稠密+BM25、RRF 融合、BGE 重排序）、租户与角色授权边界、SectionAware 证据构建、请求级 support ID 与引用校验、Architecture V2 发生账本式关键值一致性校验、OpenTelemetry/Jaeger 可观测性以及可复现的离线评测与失败归因。README 提供本地运行的 Quickstart，并强调其定位为 portfolio 系统而非生产服务声明。

MediAgent：面向患者与临床团队的医疗 AI 双门户平台

MediAgent 是一个双门户医疗平台，包含患者端 PWA 与临床医生端 PWA，后端基于 FastAPI，并使用 LangGraph/ADK 智能体对聊天进行分流、从上传的医疗文档中提取结构化信息，并基于检索到的 FDA 药品说明书文本回答用药问题。功能覆盖文档上传与 OCR、带引用的信息抽取、患者助手（文本与语音，支持 en-US 与 es-MX，引用 MedlinePlus、DailyMed、RxNorm）、临床医生审核的护理计划、预约与双向消息、通知中心、SMART on FHIR 沙盒导入以及临床医生仪表盘与 Naranjo ADR 审核。

AgentOS：具备认知记忆与运行时工具锻造能力的 TypeScript 多智能体框架

AgentOS 是一个 Apache-2.0 许可的 TypeScript 开源 AI 智能体框架，核心在于让智能体具备持久化的认知记忆、运行时自主锻造工具的能力，并能支撑长时间运行的会话。它提供可选的 HEXACO 人格配置、6 种多智能体编排策略、guradrails 与语音管线，并通过统一 dispatch 接口对接 13 个 LLM 提供商（含 2 个本地 CLI）。框架内置基于神经科学机制的认知记忆（如艾宾浩斯衰减、提取诱发遗忘、重固化等 8 种机制），RAG 管线支持 7 种向量后端与 4 种检索策略，同时宣称在 LongMemEval-S 上达到 85.6%、LongMemEval-M 上达到 70.2% 的可复现成绩。

FinSight Crew：自主金融研究与算法模拟交易的多智能体系统

FinSight Crew 是一个基于 CrewAI 的三智能体系统，面向美股与印度股市，从实时行情和公司 SEC 10-K 财报（RAG 检索）出发，进行 DCF 与相对估值分析，并生成带风险管理的模拟交易信号，按调度器持续运行。全部运行在免费层：Groq 大模型、本地 Ollama 嵌入、ChromaDB 向量库、PostgreSQL 状态存储、Streamlit 交易台与 Grafana 监控。项目为课程小组作业（AAIBA PGDM-BDA），仅做模拟交易，不构成投资建议。系统包含市场数据提取、财务分析、投资组合经理三类智能体，v2 新增财报变化分析师，并通过护栏、事实校验与确定性风险引擎约束模型输出，LLM 不负责算术。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。