ghcr.io/xpert-ai/xpert-api:sha-e9f1b10a344fa53f410f3424d8348ecce530429f

English | 简体中文

Xpert Platform & Xpert Bosi

Xpert 是用于构建和管控 AI 团队的开源平台。 Xpert Bosi 是其配套桌面应用——即你的 AI 团队负责人。

[立即体验 Bosi] · [探索应用市场] · [自托管 Xpert] · [查看文档]

---

Xpert Bosi — 你的 AI 团队负责人

你设定目标，Bosi 带领团队执行。

Bosi 将 Xpert 平台的数字专家、插件与应用聚合在你的桌面端。使用 Xpert 账号登录后，即可在所属组织的权限范围内开展工作。

• 组建你的团队： 发现各类专家、申请访问权限，或基于模板与已有应用创建自定义 Assistant。
• 统一工作入口： 整合对话、文件与应用工作台视图；添加工作区插件并为每轮对话指定启用的插件。
• 将计划落地执行：使用已配置的 Assistant 操控云主机，或在 macOS 上运行本地 Shell 命令，默认所有命令都需逐次审批。

Bosi 可连接托管版或自托管的 Xpert 平台。平台负责运行 Agent 并管理共享资源，Bosi 则提供桌面端体验与授权的本地执行能力。参阅桌面端指南了解安装与构建说明。

---

Xpert Platform — 一切皆为插件

你可以构建并发布供 Bosi、Xpert Web 或自有产品使用的 AI 团队。Xpert 提供运行时、权限控制、审批流程与审计追踪能力，插件则负责交付从模型提供商、工具到完整 Agentic 应用的各类能力。

• 统一插件生命周期： 对模型、集成项、Skill、中间件、MCP 应用与业务应用进行安装、配置与迭代管理。
• Agent + 工作流： 将灵活的推理能力与确定、可审计的业务流程相结合。
• 受控执行： 通过类型化工具、语义对象、策略规则与审批流程对外暴露数据与操作。
• 可审核的工作流： 在专属工作台视图中检查、修正、审批并提交结果。

---

官方应用

前往官方应用目录发现适用于你的 AI 团队的各类应用：

• Presentation Studio
• Sites
• DOCX Editor
• Canvas
• Pencil
• draw.io
• Excalidraw
• Lucidchart

---

快速开始

使用 Bosi： 按照桌面端指南操作，登录后选择所属组织，打开「发现与添加」页面即可查找专家、应用、插件与模板。自托管用户可在连接设置中修改目标服务器地址。

部署 Xpert 平台： 需满足最低配置要求：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/ 完成平台初始化后，即可连接 Bosi 客户端。

参阅部署与升级文档获取完整指引。源码开发环境要求使用受支持的 Node.js LTS 版本，并通过 Corepack 安装仓库指定版本的 pnpm。

---

平台能力地图

---

架构说明

Xpert 是一款插件优先、模块化的 NestJS 平台。共享的 Agent + 工作流运行时 为 AI 团队提供支撑，Agentic 应用 则将领域工具、Assistant 模板、业务服务与交互式工作台视图组合为完整的应用程序。

• AI Agent 与工作流： Agent 定义会被编译为 LangGraph 状态图。模型-工具循环整合上下文、工具路由、中间件钩子与工具返回结果；工作流则支持分支、并行路径、迭代与子流。基于工具的子 Agent 委派、已发布专家与 Swarm 交接可支撑不同的协作模式。检查点会持久化状态，支持中断与人工介入；AgentInvocation 负责管控原生与外部运行时的调用。
• 插件系统： 原生 npm 插件可注册 NestJS 模块、服务提供方、配置项与生命周期钩子。扩展点覆盖模型、工具/MCP、中间件、Skill/模板、工作流、集成项、连接器、数据/RAG、执行逻辑、存储、视图与协作能力。
• 对话资源： 标准 Agent 插件包可通过 Git/ZIP 导入提供 Skill/MCP 资源。工作区授权、版本化绑定与每次运行的资源快照会管控资源的使用，且插件不会加载服务端代码。
• Agentic 应用： 应用市场贡献内容可关联工具、模板、业务服务与审核视图。声明了 appConfig 的应用可使用平台托管的预检逻辑、专属工作区、知识库、已发布的 Assistant 或角色套件，以及安装健康状态追踪能力。
• 共享运行时与 UI 契约： LangGraph / LangChain、CQRS、Bull 任务交接、检查点与中断/恢复机制构成执行层的基础支撑。工作台使用视图清单、视图提供方与 iframe 桥接机制；MCP 应用则使用关联工具的 UI 资源。
• 受控基础设施： 作用域身份、审批、审计与用量统计覆盖 API、工作进程与所有插件。PostgreSQL + pgvector、Redis 与各类存储提供方负责持久化状态。Data Xpert 是独立部署的 API/MCP 关联服务；专业版执行提供方会被明确标记。

你可打开架构图查看全分辨率版本：AI Agent 架构与源码地图 · Agent-工作流混合架构技术文章

---

生态系统

---

使用 Agent Skill 进行本地开发

为 Codex 安装以下 https://github.com/xpert-ai/xpert-skills，即可快速搭建 Xpert 开发环境并构建应用。如果只需在当前项目范围内安装，可移除 --global 参数，并将 codex 替换为其他受支持的 Agent 名称。

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

启动新的 Agent 会话后，可执行以下操作：

1. 搭建并验证 Xpert 环境

使用 $xpert-platform-local-environment 以源码混合模式在指定路径部署 Xpert，并验证其已就绪可用于插件测试。

2. 构建 Agentic 应用

使用 $xpert-agentic-app-developer 将指定项目构建、部署为独立插件并在该 Xpert 实例上完成验证。

环境部署 Skill 会启动 Docker 基础设施，从源码启动 API 与 Web UI。应用开发 Skill 覆盖工具、视图、模板与验收测试相关流程；xpert-plugin-development Skill 则负责插件的打包与部署。

---

路线图

• 新增支持项目规划、文件管理、团队协作与任务执行的项目工作区。
• 强化管控能力，包括审批流程、审计日志与基于角色的访问控制。
• 实现跨 Agent 运行、工作流、工具调用与上下文使用的深度链路追踪与效果评估。
• 为自托管部署提供监控、数据留存、运行时控制与生产级加固能力。

---

社区

• 如有 Bug 反馈或功能需求，请在 https://github.com/xpert-ai/xpert/issues 中提交。
• 提交 Pull Request 前请先阅读贡献指南，所有贡献内容请提交至 develop 分支。
• 商务咨询：***

如果你认为 Xpert 对你有帮助，欢迎为本仓库点星支持。

---

许可证

Xpert AI Platform 社区版基于 GNU Affero General Public License v3.0 许可发布。同时提供面向小微企业与企业场景的商业许可，完整许可条款请参阅 LICENSES.md。