3步打造你的第一个StaffDeck数字员工：从岗位定义到发送第一条消息的实操指南
【免费下载链接】StaffDeck企业级数字员工平台项目地址: https://gitcode.com/OpenBMB/StaffDeck
StaffDeck 是 OpenBMB 开源的企业级数字员工平台，它像管理真人员工一样帮你构建、培养和管理 AI 数字员工。本文将用最短路径带你完成 StaffDeck 数字员工教程：定义岗位、配置能力、发送第一条消息，10 分钟内让第一位数字员工正式"上岗"。
开始之前：5分钟完成环境准备
如果你还没有安装 StaffDeck，只需 4 步：
克隆仓库（需要 Python 3.11+ 与 Node.js 20+）：
git clone https://gitcode.com/OpenBMB/StaffDeck cd StaffDeck安装依赖：创建虚拟环境后执行
pip install -e "backend[dev]"和npm --prefix frontend-enterprise ci；配置模型：将
backend/.env.example复制为backend/.env，填入任意OpenAI 兼容模型的地址与 API Key——这是数字员工的"大脑"；启动服务：macOS/Linux 运行
scripts/dev_up.sh --detach，Windows PowerShell 运行.\scripts\dev_up.ps1 --detach，然后在浏览器打开http://127.0.0.1:5173用默认账号admin / admin登录。
详细步骤可参考 README.zh.md 中的"快速开始"章节。
第1步：定义数字员工的岗位档案
登录后进入"我的数字员工"页面，点击创建。每个数字员工都像真人员工一样拥有完整档案：
在员工档案编辑页（源码见 EmployeeProfileEditor.tsx）中，填写这些信息：
| 字段 | 填写建议 |
|---|---|
| 数字员工姓名 | 例如"客服小知" |
| 岗位 | 例如"客服"、"研发"，相当于员工工牌 |
| 岗位描述 | 一句话概括岗位边界、服务风格和执行重点 |
| 岗位执行约束 | 对话中的角色人设、回复风格和执行边界（核心字段） |
| 工作风格 / 工作方式 | 勾选"目标明确""证据优先""必要时转人工"等标签 |
💡新手技巧：不必追求完美。先写 2~3 句清晰的岗位执行约束，比如"你是一名售后客服，只回答订单与物流问题，涉及退款先引导人工审核"，后续随时可以迭代优化。
第2步：给数字员工配置核心能力
光有岗位还不行，数字员工需要"懂什么、会做什么"。打开员工详情页，你会看到工作记录、资料、技能、SOP、定时任务等工作台模块：
按员工类型选择 1~2 类能力即可起步：
- 📚知识库：上传产品文档、FAQ，数字员工回答时会附上来源引用；
- 🧩技能与 SOP：把"查订单→核对→回复"这类固定流程写成 SOP，数字员工按状态机准确执行；
- 🔌工具：接入 HTTP API 或 MCP，让它能执行真实业务操作。
你也可以从数字员工广场复制现成岗位模板（如财务、法务、人事），快速获得一套预配置的能力：
第3步：发送第一条消息，见证数字员工上岗
回到员工页面点击"去对话"，在输入框写下你的第一个问题，例如"帮我查一下昨天北京到上海的航班"。发送后，数字员工会流式返回回答，同时展开一份执行记录——你可以看到它判断意图、检索资料、调用技能的完整过程：
这正是 StaffDeck 与其他 AI 聊天的最大区别：每次回答都可追溯。如果回答不满意，点开执行记录定位是哪一步出了问题（检索没命中？约束没写清？），再回到档案或知识库修正，形成"对话→观测→迭代"的闭环。
常见问题速查
- 页面能打开但员工不回答：检查
backend/.env中的模型地址、API Key 与网络，再查看.dev/logs/app.log定位具体报错； - 广场资源为什么不能编辑：广场资源是可复用模板，你可以复制或绑定到自己员工名下，原件由创建者保护；
- 没有 GPU 能用吗：可以。StaffDeck 调用 OpenAI 兼容接口，GPU 要求由你使用的模型服务决定。
写在最后
现在，你的第一位 StaffDeck 数字员工已经上岗了。接下来可以：
- 给它加一条定时任务，让它每天自动生成晨报；
- 通过渠道接入把员工挂到微信或企业微信，直接对外服务；
- 用数字员工开放 API v1 把员工能力嵌入你自己的业务系统。
从一条岗位定义到第一条消息，你完成的是数字员工生命周期管理的第一步——接下来，它会随着记忆、反馈与对话日志持续成长。祝你的第一位数字员工工作顺利！🎉
【免费下载链接】StaffDeck企业级数字员工平台项目地址: https://gitcode.com/OpenBMB/StaffDeck
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
