常见问题

通用

AgenticX 是什么？

AgenticX 是一套面向生产环境、统一的 Python 多智能体应用框架，覆盖从单智能体执行引擎到复杂多智能体编排、记忆系统、工具集成以及完整 Studio UI 的全链路能力。

AgenticX 与 LangChain 或 CrewAI 有何不同？

AgenticX 从设计之初即面向生产落地：

• 一体化：同一框架涵盖智能体、工具、记忆、编排、协议（A2A/MCP）、可观测性与安全
• Studio：提供完整 Web UI 与 Desktop 应用，管理智能体、会话与群聊
• 企业就绪：内置安全层、沙箱执行、审计日志与会话隔离
• 原生多智能体：开箱即用的分身系统、群聊、Meta-Agent CEO 模式与团队管理

AgenticX 是否开源？

是的。AgenticX 采用 AGPL-3.0 许可证。

安装

需要什么 Python 版本？

Python 3.10 或更高版本。

如何安装可选功能？

1pip install "agenticx[all]"    # Everything
2pip install "agenticx[vector]" # Vector store support
3pip install "agenticx[doc]"    # Document parsing

LLM 供应商

支持哪些 LLM 供应商？

支持 15+ 家供应商，包括 OpenAI、Anthropic、Ollama（本地）、Gemini、Kimi/Moonshot、MiniMax、Ark/VolcEngine、智谱、千帆与百炼/Dashscope 等。

可以使用本地模型吗？

可以。通过 OllamaProvider 连接 Ollama 本地运行的模型：

1from agenticx.llms import OllamaProvider
2llm = OllamaProvider(model="llama3.2", base_url="http://localhost:11434")

MiniMax 是否支持图片输入？

不支持。所有 minimax-m2* 模型均不支持图片或音频输入；若向这些模型发送图片，框架会给出警告。

工具与 MCP

什么是 MCP？

Model Context Protocol 是连接 AI 智能体与工具、数据源的开源标准。AgenticX 内置 MCP Hub，可同时连接多个 MCP 服务器。

能否使用其他框架的工具？

可以。AgenticX 可导入 LangChain 工具、基于 OpenAPI 规范自动生成 toolset，或通过 Remote Tools 调用任意 HTTP 端点。

记忆

记忆存储在哪里？

默认存储在 ~/.agenticx/workspace/ 的 SQLite 中；生产环境可配置 Redis 或 PostgreSQL。

重启后记忆是否保留？

会保留。所有记忆后端（SQLite、Redis、PostgreSQL）均会在会话之间持久化数据。

Studio 与 Desktop

如何启动 Studio UI？

1agx serve --port 8000
2# Open http://localhost:8000

Desktop 应用是什么？

Machi Desktop 是基于 Electron 的应用，在 Studio UI 之上提供系统托盘、通知、多窗口等原生 OS 能力，并支持重启后会话恢复。

贡献

如何参与贡献？

请参阅 GitHub 上的 CONTRIBUTING.md。

如何报告 Bug？

在 GitHub Issues 提交 issue。