StaffDeck 使用指南

一、平台介绍

主体背景：由清华 THUNLP + 面壁智能 OpenBMB 联合开源的企业数字员工 Agent 操作系统。

官方网站：https://staffdeck.openbmb.cn

核心定位

把 AI 封装成带岗位、工号、权限、SOP（标准作业程序）、绩效的标准化数字员工，旨在解决通用大模型存在的“无流程、无溯源、不可控”问题。

基础信息

• 开源协议：AGPLv3
• 代码开放度：源码全开放
• 部署方式：支持网页云端预览、桌面客户端、Docker 私有化本地部署
• 底层兼容：所有 OpenAI 标准接口大模型（如 MiniCPM、通义千问、DeepSeek 等）
• 系统集成：原生打通企业 OA/ERP/CRM，基于 MCP 协议

二、核心主要功能

1. 🏢 数字员工岗位管理

• 人员属性配置：给 AI 分配工号、岗位、权限及职责边界。
• 独立台账与审计：拥有独立工作台账，支持操作留痕及全链路审计。
• 内置模板：提供 5 套现成岗位模板（财务报销、人事助理、法务顾问、IT 运维、行政管家）。

2. 🔄 可视化 SOP 状态机编排

• 零代码流程配置：业务人员通过自然语言一句话生成业务流程，或拖拽进行可视化编辑。
• 高级流程控制：支持分支判断条件、断点续跑机制、异常自动拦截处理。
• 替代提示词工程：复杂逻辑无需编写长 Prompt，直接转化为可执行的业务流。

3. 📚 OKF 结构化企业知识库

• 分层检索：文档按层级进行精准检索与匹配。
• 强制溯源机制：回答内容必须标注原文章节出处，确保信息可信度。
• 知识管理：区分硬性制度（高权重）/参考案例；支持知识分桶、检索调试及全链路日志追踪。

4. 🔗 企业系统集成 (MCP)

• 协议对接：基于 MCP 协议无缝对接内部 OA、CRM、表单系统。
• 自动作业能力：数字员工可自动填写表格、发起审批流、调取业务数据。
• 即时通讯入口：支持飞书/企业微信等 IM 工具的对话接口接入，实现移动端触达。

5. 📊 运行监控与迭代闭环

• 全链路 Trace 日志：记录每一次调用细节，便于排查问题。
• 绩效统计：提供对话质量及任务完成率的统计数据。
• 自我进化机制：自动沉淀错误案例用于优化数字员工判断规则；支持批量导出审计记录合规归档。

6. 🖥️ 多端部署载体

提供多种运行环境以适应不同场景需求：

• 网页控制台：可视化操作界面（无需安装）。
• 桌面客户端：Windows/macOS 原生应用体验。
• Docker 包：一键私有化容器镜像。
• Python SDK：便于二次开发及嵌入自有业务系统接口。

三、适用人群分析

✅ 适配人群

1. 企业 IT/数字化负责人：搭建内部标准化 AI 数字员工，满足金融、央国企、医疗等领域的数据不出域合规要求。
2. 业务主管（财务/人事/法务）：实现自动化重复咨询、审批流转及合规核查工作。
3. AI 开发者/算法工程师：快速搭建可落地的企业 Agent，复用 SOP/知识库工程框架。
4. 中小企业 & 创业团队：低成本替代重复人工客服咨询，分流工单压力。
5. 高校 NLP 实验室：适合进行企业级 Agent 架构研究及行业 POC（概念验证）开发。

❌ 不适配人群

• 纯个人日常聊天者：平台侧重流程化与企业管理场景，非轻量笔记或闲聊工具。
• 仅需求开箱即用 SaaS 用户：无付费托管云订阅服务，需具备一定的本地部署能力或愿意购买线下实施服务。

四、免费 & 付费情况详解

💰 1. 免费资源（永久无限制）

以下功能与服务均对开源社区及自行搭建者完全开放：

• 网页预览端：访问 staffdeck.openbmb.cn，支持全部可视化编排、岗位模板加载、知识库构建功能的试用。
• GitHub 完整源码：地址为 https://github.com/OpenBMB/StaffDeck，商用可自由修改部署，无席位或流量限制。
• 客户端工具包：桌面安装程序及 Docker 镜像均免费下载使用。
• 配套资源：内置行业 SOP 模板、调试工具、SDK 文档等技术资料无任何收费门槛。

💎 2. 付费服务（线下定制）

平台无线上 SaaS 订阅套餐，无公开网页定价页面。付费主要面向企业级定制化需求：

• 私有化部署实施：提供驻场技术人员进行环境搭建与调试。
• 行业专属开发：针对特定业务逻辑的 AI 数字员工深度定制（需签订合同）。
• 高级技术支持：7×24 小时企业级售后、专属大模型微调服务。
• 旧系统对接：协助解决老旧 ERP/OA 无 API 接口的定制化连接方案。

💡 获取报价方式：请访问官网底部商务联系入口，直接对接 OpenBMB 商务合作团队询价（非标准产品定价）。

五、快速使用步骤指南

🟢 方式一：网页在线试用（无需安装）

1. 注册登录：访问 https://staffdeck.openbmb.cn，通过邮箱进行账号注册与登录。
2. 配置模型：填写任意 OpenAI 兼容模型的 API 地址 + Key（推荐 MiniCPM、通义千问等国内或开源模型）。
3. 创建员工：点击“新建数字员工”，选择预置岗位模板（如财务）或从零自定义。
4. 构建知识库：上传企业内部制度文档，系统将自动解析并建立 OKF 知识索引。
5. 编排流程：进入可视化编辑器，拖拽节点编辑 SOP 逻辑，发布后直接输入问题进行测试。
6. 查看日志：在控制台运行监控面板中，调整规则与优化判断路径。

🟡 方式二：本地私有化部署（数据完全离线）

1. 获取镜像/源码：从 GitHub Release 下载最新 Docker Compose 文件或拉取源码仓库。
2. 一键启动：在服务器执行 docker compose up -d，自动拉起服务集群。
3. 配置内网模型：本地部署 Qwen、Llama 或调用私有 API Key。
4. 访问控制台：在内网浏览器输入 IP 端口访问 Web 管理后台，确保核心数据不出域。

🔵 方式三：二次开发集成

• 若需深度定制功能，可查阅 Python SDK 文档，通过 REST API 接口将 Agent 能力嵌入到现有业务系统流程中（如钉钉、企业微信机器人）。

六、注意事项与避坑点

1. 模型依赖限制

• ⚠️ 注意：平台仅作为 Agent 调度层，不内置大模型。必须自备外部 API Key 或本地模型服务，无 Key=无法运行。

1. 开源协议约束

• 🔒 AGPLv3：若修改代码并对外提供网络服务（公网），必须公开源码；纯内部私有化部署则无需遵守公开义务。请务必注意合规风险。

1. 网页预览性能局限

• 🏠 生产建议：在线网页端仅适合测试与配置，企业生产环境务必使用 Docker 本地私部署，云端预览不适合承载正式业务流量以防数据泄露或限流。

1. 网络访问问题

• 🌐 现状说明：国内直连官网及 GitHub 仓库通常正常；若调用境外模型 API（如 GPT-3.5），需解决超时与合规墙，优先推荐国产本地部署模型。

1. 集成对接门槛

• 🔗 现实困难：对接 ERP/OA 需要业务系统开放标准 API；老旧无接口系统通常需要定制开发中间件，无法通过“一键连接器”完成。

1. 云托管服务现状

• ☁️ 服务模式：平台不提供按年/按月付费的云端托管订阅服务（SaaS），只能自行部署或采购线下实施服务支持，请提前做好运维准备。

1. 数据备份策略

• 💾 安全建议：网页预览端数据存储于 OpenBMB 测试服务器，严禁上传涉密/核心业务文档；生产环境请定期导出知识库文件进行本地冷备。

1. 版本差异说明

• 🔄 更新机制：Preview 线上版迭代较快，功能可能与 GitHub Release 源码包存在细微差异。生产部署请以 GitHub 稳定版本为准。