I built an AI front-desk multi-agent orchestration

# Receptics：基于LangGraph的AI前台多代理系统演示 **TL;DR：** 开发者ranger0004演示了一个名为Receptics的AI前台系统，该系统使用Python的LangGraph框架构建，通过一个编排器代理协调知识库代理和预订代理，实现7x24小时自动化客户服务与预约功能。 ## 项目概述与核心架构 Receptics是一个AI前台系统，旨在为企业提供全天候（包括凌晨三点）的在线客户服务。其核心是一个基于**LangGraph**（一个用于构建智能体的Python框架，可视为LangChain的子模块）实现的多智能体协作系统。 系统包含三个主要代理角色： 1. **编排器代理（Orchestrator Agent）**：作为中央调度器，负责接收请求并决定调用哪个子代理。 2. **知识库代理（Knowledge Base Agent）**：负责根据企业上传的文档回答常见问题（FAQ）。 3. **预订代理（Booking Agent）**：负责处理时段预约等预订请求。 ## LangGraph中的代理编排流程 在LangGraph中，代理被定义为“节点”。演示者详细说明了工作流程： 1. **路由决策**：编排器代理调用一个“工具调用节点”，该节点根据用户请求的内容，将任务路由到相应的子代理（知识库或预订代理）。 2. **代理执行与状态更新**：子代理接收任务，进行计算，并将结果输出到一个“工具节点”。随后，工作流会返回检查是否还需要调用其他代理。 3. **迭代与完成**：如果需要，编排器会再次调用其他代理。所有代理完成工作后，结果返回编排器。编排器决定流程是否结束。 4. **结构化输出与状态管理**：代理使用**instructor**库（或类似pydantic的库）输出JSON格式的结构化数据。这些结果被存储在LangGraph的全局“状态”中。随着每个代理完成其任务，代表该代理的字段会从状态中移除。当状态中不再有剩余代理字段时，标志着所有子任务完成。 ## 主要功能与界面 ### 企业仪表盘 企业用户注册并登录后，会看到一个仪表盘界面。在该界面中： * 企业可以导入包含其业务相关材料的文档，用于知识库代理的回答。 * 企业可以配置、测试并与自己的AI代理交互。 * 企业可以将配置好的代理发布，系统会生成一个唯一的URL。企业可以将此URL直接发送给客户，或（计划）将其嵌入自己的网站，使客户能直接通过AI解决常见问题或进行预约。 ### 客户端界面 通过生成的URL，客户可以访问一个独立的对话界面，与发布后的AI代理进行交互，咨询问题或预约时段。 ## 系统评估与测试 演示者为编排器节点创建了**60种评估场景**，用于测试系统是否在不同查询下能够调用正确的代理。这些场景包括： * 是否正确调用了知识库代理。 * 是否正确调用了预订代理。 * 在无需调用其他代理时，编排器是否能自行给出答案。 * 如何处理无关紧要的问题。 目前，这些评估主要针对编排器节点的行为。 ## 开发状态与当前演示 项目仍处于活跃开发阶段（“每天都在构建”），演示者强调前端代码是手动编写而非使用代码生成器。 * **已实现功能**：演示了登录、仪表盘交互、文档导入、代理发布、URL生成、客户端对话，以及一个成功的会议预约流程（尽管时间显示存在bug）。 * **待修复问题**： * 一个已知的前端错误，导致未发布状态下的交互返回“内部错误”。 * 预订代理在解析时间时出现了逻辑错误（预约了13:00-15:00却显示为18:00-20:00），演示者表示已通过**LangSmith**进行日志追踪，正排查前端逻辑问题。 * 预订表单中不应向最终用户暴露电子邮件字段，需要优化。 ## 源代码关键组件分析 演示者展示了后端代码结构，主要组件包括： * **代理工作流主类**：作为入口，集成了所有LLM客户端、代理定义、图的设置等。 * **编排器节点**：实现核心路由逻辑。 * **工具调用节点**：实际执行对子代理的调用。 * **RAG管道**：为知识库代理提供检索工具，基于导入的文档工作。 * **代理工具集**：例如，为预订代理提供获取和更新房间数据的工具。 * **认证与会话管理**：使用Supabase处理，端点检查会话状态并返回访问令牌、刷新令牌和企业用户信息（如企业ID、邮箱）。 ## 结论 Receptics展示了利用LangGraph构建复杂多代理AI应用的潜力。系统虽在开发中，但已具备核心的代理协作、文档集成、评估测试和用户交互框架，为自动化前台业务流程提供了一个可扩展的解决方案。 Source: [I built an AI front-desk multi-agent orchestration](https://www.youtube.com/watch?v=WkthJS-O92c)