用 AgenticX 核心框架构建带工具、记忆、知识与多智能体协作的生产级 Agent 运行时

方案简介

AgenticX 提供统一、可扩展、生产就绪的 Agent 技术栈。本配方聚焦其核心框架层：基于 12-Factor Agents 方法论的 Agent 执行引擎，配合可嵌入的 ReActAgent SDK 原语、统一工具系统（含 MCP Hub 多服务器聚合）、分层记忆系统（Mem0 深度集成）以及知识库与检索体系（GraphRAG、混合检索）。开发者可以直接用 Python SDK 和 agx CLI 构建智能体，支持多轮对话、并行工具执行、自修复与溢出恢复，适合需要在生产环境编排多智能体、接入多种大模型提供商（OpenAI、Anthropic、Ollama、Gemini 等 15+）的团队。

亮点与能力

• 基于 12-Factor Agents 方法论的 Agent 执行引擎，含 Meta-Agent CEO 调度器与 think-act 循环
• 可嵌入 ReActAgent SDK 原语，类型化 AgentEvent 流与并行工具执行，零 Studio/CLI 耦合
• 统一 Offload 协议，将大工具结果移出活跃历史，按需取回
• 图编排引擎 + Flow 装饰器系统，支持条件路由与并行执行
• 分层记忆（core / episodic / semantic）与 Mem0 深度集成、混合搜索、记忆衰减
• 15+ LLM 提供商，带响应缓存与故障转移路由
• A2A 智能体间协议与 MCP 资源访问协议
• Pydantic 输出解析、自动修复与护栏

组成与分工

• Python SDK / AgenticX Core：核心运行时，提供 ReAct 循环、编排、工具、记忆与知识库能力
• MCP Hub：多服务器聚合，并可在沙箱内运行 MCP 服务器的网关
• Mem0：深度集成的记忆引擎，支撑分层记忆与混合检索
• OpenAI / Anthropic / Ollama 等：LLM 提供商适配，支持缓存与故障转移
• Pydantic：任务输出校验、自动修复与护栏
• FastAPI：Studio Server 的 REST API + SSE 后端，串接会话、消息、头像、群聊等
• GraphRAG / BM25：知识库图谱构建与混合检索（向量 + BM25）

使用与配置要点

通过 agx CLI 可使用以下子命令进行日常开发与运维：serve、studio、gateway、feishu、loop、project、agent、workflow、deploy、monitor、docs、mineru、sandbox、skills、hooks、config、cc-bridge、memory-graph、generate、tools。ReActAgent 通过 ainvoke/astream 异步调用，支持可选注入 loop-detector / compactor / offloader。

注意事项与常见问题

安全通告：LiteLLM (PyPI) 的恶意版本 litellm 1.82.7 和 1.82.8 已从 PyPI 移除，它们可能窃取 API 密钥。如果安装过这两个版本，应卸载、轮换可能泄露的凭据，并升级到上游列为安全的版本（如 1.82.9+）。可用 pip show litellm 检查环境。

优缺点

• ✓ 15+ LLM 提供商可切换
• ✓ 零 Studio/CLI 耦合，可嵌入
• ✕ 企业网关不含完整 Agent Runti
• ✕ ['']

出处

本方案挖掘自开源项目 DemonDamon/AgenticX，方案内容与实施命令均来自其 README 原文。