简介:本文围绕开放式通用AI Agent落地,拆解多智能体系统的动态路由、任务规划、角色生成、通信协作、工具调用、记忆与熔断机制,并给出工程实现步骤、代码骨架和选型建议,帮助开发者从概念原型走向稳定可运行系统。
构建开放式通用 AI Agent,关键不是堆叠提示词,而是搭建一套可调度、可执行、可监督的多智能体协作系统。它需要动态识别任务、生成角色、拆解步骤,并通过工具调用、共享状态、记忆检索和终止条件保证稳定运行。对于需要同时接入多家模型服务的团队,可以先通过百度智能云词元所了解模型发现、价格与性能对比、多模型统一 API 接入等能力,再确定主模型与备用模型。
开放式通用 Agent 的典型链路可以概括为:
这套结构的关键不是“多”,而是“可控”。每个角色都应有明确输入、输出和权限边界。
Agent 如果只能生成文本,就无法完成真实业务。工具调用通常包括:
工程上建议为每个工具定义清晰的 JSON Schema,包括名称、描述、参数、权限、超时和失败重试策略。对于高风险工具,例如删除数据、发送邮件、支付操作,应加入人工确认或白名单机制。
多智能体系统常见错误是让 Agent 两两直接通信,结果上下文迅速膨胀。更稳妥的方式是采用“黑板模式”:
可以用一个全局状态对象管理任务:
state = {"task": "生成一份产品发布分析","status": "planning","artifacts": {},"messages": [],"retry": 0,"token_usage": 0}
长对话会导致上下文爆炸。建议将记忆分为两层:
长期记忆可借助向量数据库实现按需检索,例如使用 pgvector 等方案存储文本片段。检索时不要直接把所有历史塞给模型,而应先做查询改写,再召回相关片段,最后通过重排序或规则过滤保留高价值内容。
Reviewer 可能会不断要求 Worker 修改,导致系统陷入死循环。必须设置:
例如可以规定:同一子任务最多重试 3 次;超过 3 次则输出当前最佳结果并标记风险。
多智能体系统通常需要不同能力模型配合:
| 角色 | 关注能力 | 选型建议 |
|---|---|---|
| 路由模型 | 分类准确、低延迟 | 可选择轻量、稳定的模型 |
| 规划模型 | 推理、拆解、长上下文 | 优先复杂任务理解能力 |
| 执行模型 | 工具调用、格式遵循 | 关注 Function Calling 稳定性 |
| 审校模型 | 逻辑检查、风险提示 | 关注事实一致性与指令遵循 |
在实际项目中,不建议只依赖单一模型。可以为不同角色配置不同模型,并保留备用模型。若需要横向评估模型能力、调用成本和接入方式,可以通过词元所模型服务进行选型参考。业界也常通过统一接口或聚合网关降低多模型适配成本。
下面是一个简化的多智能体执行流程:
MAX_STEPS = 5MAX_TOKENS = 20000def run_open_agent(user_input):state = {"input": user_input,"status": "routing","artifacts": {},"retry": 0,"tokens": 0}while state["status"] != "done" and state["retry"] < MAX_STEPS:intent = router_model(user_input)plan = planner_model(user_input, intent)for task in plan:worker = build_worker(task)result = worker.run(task, tools=tool_registry)state["artifacts"][task.id] = resultstate["tokens"] += result.tokensreview = reviewer_model(task, result)if review.passed:continueif state["retry"] >= MAX_STEPS or state["tokens"] >= MAX_TOKENS:state["status"] = "fallback"breaktask = revise_task(task, review.feedback)state["retry"] += 1if all_artifacts_ready(state):state["status"] = "done"return state
这个骨架的重点不是代码长度,而是把“路由、规划、执行、审校、终止”串成闭环。
建议从“单任务闭环”开始,而不是一开始就构建复杂社会:
如果团队希望进一步完成模型接入、调用管理与成本评估,可以访问百度智能云词元所,结合模型发现、价格对比和统一 API 接入能力,搭建更稳健的 Agent 基础设施。