CE-Agent 多智能体系统流程图文档
CE-Agent 多智能体系统流程图文档
📋 文档概述
本文档详细描述了基于 LangGraph 开发的多智能体系统中各个组件的工作流程。该系统采用 主管模式（Supervisor Pattern），通过智能调度协调多个专家智能体协同工作，为用户提供专业的服务。
🏗️ 系统架构概览
核心组件
系统以“主管智能体”为核心，搭配多个领域专家智能体，各组件职责如下：
- 主管智能体（Supervisor）：系统核心调度器，负责任务分配和专家智能体调度，确保任务匹配最优专家。
- 查询改写专家：预处理用户查询，包含时间解析、意图识别、查询优化及负责人信息匹配。
- RAG专家：专注企业内部知识检索，基于内部知识库提供准确答案。
- 权限申请专家：处理商务体系平台的权限申请与审批流程，含用户确认、表单验证等环节。
- 时间专家：处理时间相关查询，如相对时间解析、时间格式转换、时间戳获取等。
- 业绩提成专家：（原文表述为“性能专家”，结合功能修正）处理员工业绩、提成、订单状态查询及工单生成。
- 搜索专家：负责网络信息检索，如网页内容获取、必应搜索、信息过滤与来源标注。
- 文本转SQL专家：处理数据查询请求，将自然语言转换为SQL并执行，专注报价类问题。
技术特点
- 基于 LangGraph 状态图框架构建，支持状态驱动的流程控制。
- 支持流式处理与长短期记忆，保障上下文连续性。
- 实现工具调用与参数自动注入（如员工ID、线程ID）。
- 支持中断机制与用户交互（如关键步骤确认、表单输入）。
- 具备完整的错误处理与异常流程恢复能力。
1. 主管工作流总体架构
📊 系统调度逻辑
主管智能体是整个系统的“中枢”，通过智能决策将用户任务分配给最合适的专家智能体，确保服务专业性与效率。
<此处有图 node_id_144>
🎯 工作流程说明
- 首轮处理规则：所有用户查询（除明确的问候/功能询问外），必须先由“查询改写专家”进行预处理。
- 专家分配逻辑：主管基于改写后的查询内容、意图标签及专家推荐列表，分配任务至对应领域专家。
- 负责人信息传递：查询改写专家会匹配并提供任务相关负责人的联系信息，最终在回复中自然融入。
2. 查询改写专家流程
🔄 查询预处理核心
查询改写专家是用户查询的“第一道关口”，负责标准化、优化查询，为后续专家处理奠定基础。
<此处有图 node_id_183>
⚙️ 核心功能
- 时间处理：将相对时间（如“昨天”“下周”）转换为具体日期（如“2025-09-14”“2025-09-23至2025-09-29”）。
- 意图识别：分析查询的业务领域（如“业绩查询”“权限申请”）与紧急程度，打上对应标签。
- 查询改写：优化查询表述，去除冗余信息、补充关键上下文，使其更符合专家处理格式。
- 负责人管理：根据查询领域匹配对应业务负责人（如“权限申请→IT运维部张工”），同步联系方式。
3. RAG专家流程
📚 企业知识库检索
RAG专家专注于企业内部知识的精准检索，不依赖外部网络，仅基于预设内部知识库响应。
<此处有图 node_id_227>
📋 处理规则
- 必须使用工具：无论查询复杂度，均需调用内部知识库检索工具，不允许“自行生成答案”。
- 问题分解能力：若用户查询包含多个子问题（如“XX产品定价+XX流程说明”），需拆分为独立检索任务。
- 格式化输出：答案需用Markdown格式呈现（如标题、列表、代码块），提升可读性。
- 信息准确性：严格保留知识库中的原始信息，不擅自修改人名、联系方式、地址、公司名称等关键内容。
4. 权限申请专家流程
🔐 权限审批完整流程
权限申请专家负责商务体系平台的权限申请全流程，确保合规性与用户交互体验。
<此处有图 node_id_271>
🔄 流程特点
- 用户确认机制：每个关键步骤（如“申请权限类型”“有效期选择”）均需用户确认，避免误操作。
- 表单验证：对用户提交的申请表单进行完整性、合法性校验（如“有效期格式错误”“必填项为空”），并返回错误提示。
- 中断机制：支持流程中断与恢复（如用户需补充材料时，可暂停流程，后续继续）。
- 审批集成：与企业内部审批系统无缝对接，自动同步申请状态（如“待审批→已通过→权限开通”）。
5. 时间专家流程
⏰ 时间处理专家
时间专家专注于各类时间相关需求，提供标准化的时间解析与转换服务。
<此处有图 node_id_315>
🛠️ 工具能力
parse_relative_time：解析相对时间表达式（如“3天前”“下个月第二个周一”），返回具体日期范围。get_current_time：获取当前系统日期与时间（支持多时区配置）。get_timestamp：将指定日期时间转换为Unix时间戳（秒级/毫秒级可选）。get_date_info：获取指定日期的详细信息（如“星期几”“是否节假日”“季度”）。
6. 业绩提成专家流程
📈 业绩提成查询专家
该专家专注于员工核心业务数据查询与工单处理，支撑业务决策与问题反馈。
<此处有图 node_id_359>
🔧 核心工具
check_sales_order：查询销售单详情（如订单金额、客户信息、发货状态）。check_order_status：查询指定订单的当前状态（如“待付款”“已发货”“已完成”）。generate_work_order_draft：根据业绩问题（如“提成计算异常”）生成工单草稿，供用户确认后提交。add_work_order：将确认后的业绩问题工单提交至企业工单系统，同步分配处理人。
7. 搜索专家流程
🔍 网络信息检索专家
搜索专家负责获取外部网络信息，为用户提供实时、准确的互联网数据支持。
<此处有图 node_id_403>
🎯 功能特点
- 网页内容获取：从用户指定URL抓取网页内容，并自动清理广告、导航栏等无关信息。
- 必应搜索集成：通过必应搜索API获取最新网络信息（如“行业动态”“实时新闻”）。
- 内容过滤：去除低质量、无关的搜索结果（如垃圾广告、非权威来源）。
- 来源标注：所有网络信息均需标注来源（如“来源：必应搜索-XX网页”“URL：https://xxx”），确保可追溯。
8. 文本转SQL专家流程
📊 数据查询专家
文本转SQL专家专注于“自然语言→SQL”的转换与执行，仅处理数据查询类需求，尤其聚焦报价相关问题。
<此处有图 node_id_447>
📋 处理规则
- 领域限制：仅回答报价类数据查询（如“XX产品2025年Q1报价”“XX客户历史报价记录”），非报价类问题需转交其他专家。
- 数据真实性：若SQL查询无结果（如“无该产品报价数据”），需委婉告知用户“暂未查询到相关信息”，不杜撰数据。
- 格式化输出：查询结果需用Markdown表格呈现（如列名“产品名称”“报价金额”“有效期”），清晰直观。
- 参数注入：自动注入上下文参数（如当前员工ID、部门ID），确保SQL查询的权限合规性（仅查询员工有权限的数据）。
🚀 技术实现要点
LangGraph 核心特性
- 状态驱动：每个智能体均定义明确的状态（如“待处理→处理中→已完成→异常”）与状态转换规则。
- 工具集成：无缝对接外部工具与API（如知识库检索工具、审批系统API、搜索API），统一调用接口。
- 参数注入：自动从上下文提取并注入必要参数（如员工ID、线程ID、查询时间），无需用户手动输入。
- 中断机制：支持流程中断（如等待用户确认、补充信息），中断后可恢复至原状态继续处理。
- 错误处理：针对工具调用失败、参数缺失、无结果等异常场景，提供重试、降级、转交其他专家等恢复策略。
系统优势
- 专业化分工：每个专家智能体专注单一领域，提升处理精度与效率。
- 智能调度：主管智能体基于意图识别与专家能力匹配，避免“错配任务”。
- 上下文传递：负责人信息、查询历史、参数等上下文在专家间无缝传递，无需用户重复输入。
- 用户体验：流式处理确保响应实时性，友好的交互提示（如确认步骤、错误说明）降低用户操作成本。
- 扩展性：新增专家智能体时，仅需遵循状态定义与工具集成规范，无需重构整体架构。
📚 使用说明
开发团队参考
- 新增专家：参考现有专家的状态定义（如“待处理→处理中→完成”）与工具集成模式，确保接口兼容。
- 工具开发：遵循系统工具参数规范（如输入输出格式、异常码定义），支持参数自动注入。
- 流程优化：基于流程图识别瓶颈环节（如“RAG检索耗时过长”），优化工具调用逻辑或增加缓存机制。
- 测试验证：覆盖所有流程分支（正常流程、异常场景、中断恢复），确保每个环节处理逻辑正确。
运维团队参考
- 监控要点：关注各专家智能体的调用频率、成功率、平均处理耗时，定位高负载或故障节点。
- 性能优化：基于流程图识别性能瓶颈（如“搜索专家网页抓取耗时高”），优化网络配置或增加资源配额。
- 故障排查：利用流程图快速定位问题环节（如“权限申请卡住→检查审批系统对接状态”），缩短排查时间。
- 容量规划：根据各专家的流程复杂度与调用量，评估服务器资源（CPU、内存、网络）需求，避免资源不足。
本文档基于 CE-Agent 项目代码生成，详细描述了多智能体系统的完整工作流程。如有疑问或需要更新，请联系开发团队。