ghcr.io/xpert-ai/xpert-webapp:sha-890d9b88c58969ca7057e9b0299583569c5228ed

英文 | 简体中文

一切皆为插件

Xpert 是一个开源 Agent 平台，其中模型、集成、工具、中间件、Skills、Assistants、Workbench 视图、MCP 应用以及完整的 Agentic 应用均共享一个受治理的插件系统。

探索插件市场 · 浏览插件源码 · 使用 Agent Skills 开发 · 自托管 Xpert · 文档

Xpert 核心提供运行时、契约、安全边界和生命周期控制。插件提供用户安装的功能和应用：从模型提供商或工具到完整的 Assistant、多 Agent 工作流或面向业务的 Agentic 应用。

查看 Xpert 实际运行效果

这是 Motion Assistant 的实时 Agent Studio 配置。一个 Agent 连接了 Skills、Web 工具、沙箱功能、重试和循环防护中间件以及操作控制。当流程需要更严格的控制时，相同的可视化模型可以将多个 Agent 与确定性 Workflow 节点组合。

为什么选择 Xpert

• 一切皆为受治理的插件 — 通过统一生命周期安装和演进模型、集成、中间件、Skills、MCP 工具和应用、Assistant 模板、远程组件、Workbench 视图以及完整的 Agentic 应用。
• Agent 与 Workflow 混合架构 — 使用 Agent 进行灵活推理，使用 Workflow 实现稳定、可检查的控制路径。
• 受治理的企业级执行 — 通过类型化工具、语义对象、策略、审批和审计跟踪公开数据和业务操作，而非向模型提供原始访问权限。
• 人工可审核的工作台 — 让工具调用打开聚焦的 UI 视图，用户可在其中检查、纠正、批准或提交结果。

官方应用

在 官方应用目录 中探索 Xpert 的第一方 Agentic 应用：

• 演示文稿工作室
• 站点
• DOCX 编辑器
• 画布
• 铅笔
• draw.io
• Excalidraw
• Lucidchart

快速开始

Docker 部署路径至少需要 2 个 CPU 核心、4 GiB 内存、Docker 和 Docker Compose。

git clone https://github.com/xpert-ai/xpert.git
cd xpert/docker
cp env.example .env
docker compose up -d

打开 http://localhost/ 并完成初始化流程。

有关部署选项、环境配置和升级，请遵循 自托管文档。对于源码开发，请使用受支持的 Node.js LTS 版本和通过 Corepack 固定的仓库 pnpm 版本。

平台地图

架构

Xpert 采用 Agent-Workflow 混合架构。Agent 决定如何解决开放式任务；Workflow 使关键路径可重复且可审核。工具、知识、数据资源和插件表面均位于明确的契约和治理边界之后。

阅读架构文章。

生态系统

使用 Agent Skills 进行本地开发

使用 https://github.com/xpert-ai/xpert-skills 中的开发技能，让受支持的编码 Agent 设置平台并针对已验证的本地 Xpert 实例构建 Agentic 应用。

安装两个主要技能及其 Codex 插件生命周期配套技能。如果仅需为当前项目安装，请移除 --global。

npx skills add xpert-ai/xpert-skills \
--skill xpert-platform-local-environment \
--agent codex \
--global

npx skills add xpert-ai/xpert-skills \
--skill xpert-agentic-app-developer \
--agent codex \
--global

npx skills add xpert-ai/xpert-skills \
--skill xpert-plugin-development \
--agent codex \
--global

必要时，将 codex 替换为 Skills CLI 支持的其他目标。如果技能未立即被发现，请在安装后启动新的 Agent 会话。

然后要求编码 Agent 按顺序运行工作流：

1. 设置并验证 Xpert

使用 $xpert-platform-local-environment 克隆或重用 处的 Xpert 检出，以源码混合模式设置，启动它，并返回插件测试就绪的环境回执。

2. 构建 Agentic 应用

使用 $xpert-agentic-app-developer 设计、实现、安全部署并验证 作为独立的 Xpert Agentic 应用插件，针对已验证的本地平台。

环境技能默认使用 Docker 管理的基础设施，API 和 Cloud UI 从源码运行。它验证检出和流程来源、服务健康状况以及所需的人工初始化是否完成。Agentic 应用技能涵盖插件架构、Agent 中间件、Workbench 和扩展视图、Assistant 模板、市场 appConfig、部署和验收。有关插件打包和部署的详细信息，请遵循其向 xpert-plugin-development 的交接。

路线图

当前路线图优先考虑：

• 用于规划、文件、团队和任务执行的项目工作区。
• 更强的治理、审批、审计和基于角色的访问控制。
• 跨 Agent 运行、工作流、工具和上下文使用的更深入跟踪和评估。
• 自托管部署的监控、保留、运行时控制和生产强化。

社区

• 在 https://github.com/xpert-ai/xpert/issues 中报告错误或请求功能。
• 提交拉取请求前，请阅读 贡献指南。贡献应针对 develop 分支。
• 商业咨询：***

如果 Xpert 对您有用，请考虑给仓库点星。

许可证

Xpert AI 平台社区版采用 GNU Affero General Public License v3.0 许可。也提供小型企业和企业商业许可证。完整条款参见 LICENSES.md。