StaffDeck：OpenBMB开源的企业级AI数字员工搭建与运维工具

一、StaffDeck 是什么

StaffDeck 是由 OpenBMB、面壁智能 ModelBest、清华 THUNLP、东北大学联合实验室共同推出的开源企业级数字员工构建与管理平台。

区别于通用对话大模型、普通单 Agent 框架，StaffDeck 核心定位是把企业线下业务流程、岗位权责、组织知识库、标准化作业规范（SOP）封装成可落地、可管控、可批量运营的数字员工，将通用 AI 工具升级为企业标准化数字劳动力。

项目同时提供网页管理后台与 Windows/macOS/Linux 三端桌面客户端，无需本地高性能 GPU，仅对接兼容 OpenAI 格式的大模型接口即可完整运行，面向企业运维、业务运营、数据行政、流程自动化场景落地。

二、功能特色

1. 数字员工全生命周期管理

支持自定义数字员工工号、岗位职能、权限分组、专属知识库隔离；内置数字员工市场模板，模板支持复制复用，原始模板资源受创建者权限保护；统一记录所有员工对话日志、工具调用记录、定时任务执行记录，全操作可溯源审计。

2. 状态机可视化 SOP 流程引擎

搭载自研状态机驱动业务执行内核，支持自然语言快速转换标准化业务流程，提供可视化拖拽编辑界面；支持流程版本分支管理、多任务并行切换、上下文记忆持久留存，解决传统 Agent 多步骤业务逻辑混乱、流程中断丢失上下文的痛点。

3. 分层多级知识库精准检索

采用分层索引架构，对企业文档实现文档、章节、段落、摘要四级索引，数字员工执行任务时先定位文档范围再精准溯源原文；自带检索调试面板、引用来源标注功能，大幅降低大模型幻觉对业务的干扰。

4. 自动化执行与人工干预闭环

兼容 HTTP API、MCP 工具协议、定时任务三种自动化执行模式；任务运行过程支持暂停、终止、人工接管操作；依托执行日志、用户反馈、长期记忆模块形成持续优化闭环，兼顾自动化效率与人工风险管控。

5. 多端统一交付部署

同时提供 Web 企业管理后台、跨平台桌面客户端；配套全套启停、校验、打包运维脚本，开箱即用，开发与生产环境部署流程统一。

三、技术细节

1. 技术栈构成

• 后端：Python + FastAPI，负责 Agent 运行时、知识库存储、定时任务、权限校验、API 接口服务，代码占比约 57.2%；

• 前端：TypeScript + React 企业级管理工作台，可视化流程编辑器、员工管理面板，代码占比约 38.9%；

• 辅助：Shell 运维脚本、CSS 样式、打包编译工具，剩余少量代码。

2. 运行环境依赖
   Python 3.11 及以上、Node.js 20 及以上；支持 macOS、Linux、Windows WSL 环境运行；平台本身不依赖 GPU，算力完全由外部兼容 OpenAI 规范的大模型服务提供。

3. 核心底层架构

• 状态机调度内核：管控数字员工任务流转、分支判断、步骤重试；

• 分层向量检索引擎：独立知识库存储模块，隔离不同岗位数据；

• 权限中间件：基于账号分组实现知识库、数字员工、流程模板资源隔离；

• 任务调度模块：支持 Cron 表达式定时任务、外部 API 触发任务；

• 日志持久化模块：完整记录检索、工具调用、模型推理、人工操作全链路数据。

4. 接口兼容规范
   原生兼容 OpenAI 标准接口格式，可对接本地私有化大模型、第三方商用大模型服务；对外暴露完整业务 API 与接口文档，支持企业内部系统打通。

5. 开源协议
   AGPLv3 开源协议，修改、二次分发项目代码需同步开源衍生项目代码，商用企业部署需遵守协议规范。

四、应用场景

1. 企业行政自动化
   搭建人事、行政数字员工，自动处理考勤核对、文件归档、通知下发、资料检索，配置定时任务周期性执行台账整理。

2. 业务客服标准化运营
   基于企业产品手册、售后规范搭建岗位数字员工，绑定 SOP 售后处理流程，复杂工单支持人工一键接管，对话全程留痕审计。

3. 数据运维、报表自动生成
   对接业务数据库、第三方 API，设定定时任务自动抓取业务数据，按固定流程生成汇总报表并推送至企业内部工具。

4. 内部知识库问答助手
   上传公司制度、技术文档、业务操作手册，搭建专属岗位数字员工，员工可快速检索规范，替代零散本地文档查询。

5. 中小企业流程标准化落地
   复用平台内置行业模板，快速搭建销售、仓储、财务简易数字员工，无需从零开发 Agent 业务逻辑。

五、使用方法

1. 源码本地部署流程

1. 克隆 GitHub 仓库代码至本地设备；

2. 分别初始化 Python 后端虚拟环境、安装前端 Node 依赖包；

3. 复制项目内置配置模板文件，填入大模型接口地址、API 密钥、模型名称等核心参数；

4. 执行项目内置启动脚本，默认占用 5173 端口，同时运行 Web 后台与接口服务；

5. 访问 localhost:5173 进入管理界面，初始管理员账号 admin/admin，正式使用必须修改默认密码；

6. 访问 /api/health 健康检测接口，校验服务运行状态。

2. 数字员工标准使用流程

1. 创建数字员工：设定岗位名称、权限分组、可访问知识库范围；

2. 配置工作能力：复用市场模板或手动搭建知识库、工具集、SOP 业务流程；

3. 发起对话/定时任务：手动对话测试或配置 Cron 定时自动执行业务；

4. 观测任务运行：查看检索记录、工具调用、模型输出完整执行日志；

5. 人工干预优化：异常任务暂停、人工接手处理，提交反馈迭代数字员工能力。

3. 桌面客户端使用

下载对应系统安装包，完成安装后填写后端服务地址与账号密码，本地客户端与 Web 后台数据实时同步，支持离线查看历史任务日志。

六、竞品对比

选取主流开源企业 Agent 平台 AutoGPT、Dify、StaffDeck 进行维度对比：

七、常见问题解答

Q：部署 StaffDeck 是否需要高性能 GPU？

A：不需要。StaffDeck 本身仅作为调度、管理、检索平台，不运行大模型推理，算力完全依靠外部 OpenAI 格式大模型服务，本地普通电脑、云服务器均可部署。

Q：数字员工市场内的模板可以直接修改商用吗？

A：仅支持复制模板生成独立副本，原始模板所有权归创建者，无法直接编辑原始模板，复制后的副本可自由修改用于企业业务。

Q：部署后AI无法正常回复消息该如何排查？

A：优先检查配置文件内大模型接口地址、密钥、模型名称是否填写正确；其次查看项目本地运行日志，定位网络连接、检索模块、调度模块报错信息；最后校验服务器防火墙是否放行5173端口。

Q：项目开源协议AGPLv3对企业商用有什么约束？

A：企业仅内部部署使用无强制开源要求；若对项目源码修改后对外提供服务、二次分发部署包，必须同步公开修改后的完整源代码。

Q：定时任务执行失败是什么原因？

A：常见诱因包含服务未常驻后台、服务器时区配置错误、任务依赖的API密钥过期、流程SOP存在逻辑断点，可通过任务执行日志定位具体故障节点。

Q：该平台能否直接用于金融、医疗、法律核心决策业务？

A：不建议直接用于强监管行业核心决策场景，大模型存在幻觉风险，所有高风险业务操作必须配置人工审核流程与权限审批机制。

八、相关链接

• GitHub仓库地址：https://github.com/OpenBMB/StaffDeck

九、总结

StaffDeck 是一款面向企业业务落地的开源数字员工管理平台，依托状态机流程引擎、分层知识库、完整权限管控与自动化调度能力，解决传统通用AI框架缺少标准化业务流程、企业数据权限混乱、任务无法长期稳定自动运行的行业痛点，多端部署模式适配开发、办公、生产多种使用环境，兼容主流大模型接口，无需高额算力硬件投入，适合各类企业搭建标准化岗位数字劳动力，兼顾易用性、可审计性与业务落地实用性。