ghcr.io/xpert-ai/xpert-webapp:sha-334a56744a7a053be24be68dfdff4d7be39dafa4

English | 简体中文

Xpert Platform 与 Xpert Bosi

Xpert 是用于构建和治理 AI 团队的开源平台。 Xpert Bosi 是其桌面端应用——你的 AI 团队负责人。

快速上手 Bosi · 探索应用市场 · 自托管 Xpert · 查看文档

Xpert Bosi — 你的 AI 团队负责人

你设定目标，Bosi 领导团队完成任务。

Bosi 将 Xpert 的数字专家、插件和应用整合到你的桌面端。你可以使用 Xpert 账号登录，并在所属组织的权限范围内开展工作。

• 组建你的 AI 团队： 发现各类 AI 专家、申请权限，或是基于模板和应用创建自定义 Assistants。
• 一站式工作： 整合对话、文件与应用工作台视图；添加工作区插件并为每轮对话指定启用的插件。
• 将计划落地执行：使用已配置的 Assistants 操控云计算机，或是在 macOS 上运行本地 Shell 命令，默认每一条命令执行前都需要人工审批。

Bosi 既可以连接云端托管的 Xpert 服务，也可以连接自托管的 Xpert 实例。平台负责运行 Agents 并管理共享资源；Bosi 则提供桌面端使用体验与经过授权的本地执行能力。相关安装与构建说明请参考桌面端指南。

Xpert Platform — 一切皆为插件

你可以构建并发布适用于 Bosi、Xpert Web 或自有产品的 AI 团队。Xpert 提供运行时、权限管控、审批流与审计追踪能力；插件则提供从模型提供商、工具到完整智能体应用的各类能力。

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

官方应用

你可以在官方应用目录中找到适用于你的 AI 团队的各类应用：

• 演示文稿工作室
• 站点生成器
• DOCX 编辑器
• 画布
• 绘图笔
• 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 平台。共享的智能体 + 工作流运行时为 AI 团队提供算力支撑，而智能体应用则将领域工具、Assistant 模板、业务服务与交互式工作台视图整合为完整可用的应用。

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

你可以打开架构图查看高清版本：AI 智能体架构与源码地图 · 智能体-工作流混合架构技术文章

生态系统

使用智能体技能进行本地开发

为 Codex 安装以下 https://github.com/xpert-ai/xpert-skills 即可快速搭建 Xpert 开发环境并构建应用。如果仅需要在当前项目生效，可移除命令中的 --global 参数；也可以将 codex 替换为其他受支持的智能体。

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 xpert-skills \
--skill xpert-plugin-development \
--agent codex \
--global

启动新的智能体会话后，你可以按以下步骤操作：

1. 搭建并验证 Xpert 环境

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

2. 构建智能体应用

使用 $xpert-agentic-app-developer 构建、部署并验证指定路径的应用作为独立插件运行在当前 Xpert 实例上。

环境搭建技能会启动 Docker 基础设施，运行源码编译的 API 与 Web UI 服务。应用开发技能覆盖工具、视图、模板与验收测试全流程；xpert-plugin-development 技能则负责插件打包与部署流程。

路线图

• 新增项目工作区，支持规划、文件管理、团队协作与任务执行能力。
• 增强治理、审批、审计与基于角色的访问控制能力。
• 深化全链路追踪与评估，覆盖智能体运行、工作流、工具调用与上下文使用环节。
• 为自托管部署提供监控、数据留存、运行时管控与生产级加固能力。

社区

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

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

许可证

Xpert AI 平台社区版采用 GNU Affero General Public License v3.0 许可。同时也提供面向小型企业与企业用户的商业许可，完整条款请参考 LICENSES.md。