• 人工智能
• AI Agent
• Agent 编排
• 后端
• 前端
• 任务调度
• 认证鉴权

AgentSpace 是一个让「人类 + Agent」组成同一团队的 agent-native 协作工作空间。这篇文章面向新手，带你从零开始在 AgentSpace 中创建你的第一个数字员工（Digital Employee），完整走通岗位设定、Owner 归属、执行引擎绑定与技能分配，让你的 Agent 从"个人聊天机器人"变成可管理、可审批、可复用的组织资产。

1. 为什么用"数字员工"而不是聊天机器人

大多数 Agent 产品都是个人工具：强大的 Agent 藏在某个人的终端里，团队看不见、管不了。AgentSpace 把真实职场的组织结构带进协作空间：

• 🧑‍💼 每个 Agent 都有岗位（Role）、Owner 和责任边界
• 🤝 人类和 Agent 在同一个 workspace 的频道、任务、文档中协作
• 🔐 敏感动作由权限、审批和审计轨迹治理，Owner 保留 100% 控制权

所以"创建数字员工"在 AgentSpace 里更接近"招聘一位员工"：先定岗位，再定责任人，最后分配技能。

2. 快速准备：启动 AgentSpace 工作区

如果你还没搭好环境，按官方文档两步启动本地工作空间：

git clone https://gitcode.com/gh_mirrors/ag/AgentSpace cd AgentSpace npm run setup cp .env.example .env docker compose -f deploy/postgres/docker-compose.yml up -d npm run db:pg:init npm run dev:web

然后浏览器打开http://127.0.0.1:1455，进入你的 workspace。部署方式与完整说明见 README_ZH.md。

💡 如果你使用托管版（Platform），直接进入产品页面即可，跳过本节。

3. 第一步：在 Agents 页面创建你的第一个数字员工

进入 workspace 侧边栏的Agents模块（源码入口：agents-page-client.tsx），点击右上角的新建 Agent，会打开创建弹窗（create-agent-modal.tsx）。弹窗提供两种创建方式：

方式 A：从模板创建（推荐新手）

AgentSpace 内置了一个"Agent 模板市场"，按金融 / 产品 / 设计三个分类提供开箱即用的岗位模板：

模板预设在 packages/domain/src/agent-templates.ts 中定义。选择模板后：

1. 岗位名称、摘要、Instructions（角色与规则）自动填充，你可以直接修改；
2. 预置技能自动绑定：系统会把 workspace 里已有的匹配技能挂到 Agent 上，模板页面会显示"已准备 x/y 个预置技能"，无需手动导入。

方式 B：空白自定义

适合你已经有明确岗位设计的情况：手动填写以下四个字段即可——

• Name：Agent 的唯一名称，如Deep Research Agent（同一 workspace 内不能重名）
• 备注名（Display name）：展示用名字，如Repo Builder
• Description：一句话摘要
• Instructions：每次任务执行前都会注入给 Agent 的角色与规则，是塑造岗位行为的核心字段

选择执行引擎（Execution Engine）

创建表单底部需要你选择一个执行引擎——即真正运行 Agent 任务的 runtime（如 Claude Code、Codex、OpenClaw、Hermes 等，由 AgentRouter 统一调度）。

⚠️这里是新手最容易卡住的地方：普通成员如果没有被管理员分配过执行引擎，创建会直接报错请先选择管理员分配给你的执行引擎。。此时请先到"执行引擎"列表里等管理员授权，或请管理员在 Settings 中为你分配 runtime。

4. 第二步：理解岗位、Owner 与调用权限

创建提交后，核心逻辑在 actions.ts 的 createWorkspaceAgentAction 中执行，它决定了你的数字员工"归谁管"：

Owner 规则一图看懂

对应源码在 employees.ts 的 createEmployeeSync：普通成员创建时ownerUserId会写入创建者，且channelMemberAccess自动置为disabled。

Owner 能做什么

成为 Owner 后，你可以进入该 Agent 的简历详情页（agent-detail.tsx），在六个页签里完成全部管理动作：

• Instructions：随时修改角色与规则，"每次执行都会注入这段 instructions"
• Skills：分配 / 移除技能（见下一节）
• Knowledge：绑定 workspace 知识库页面
• 文档权限：查看该 Agent 可读 / 可编辑的文档数量
• Workspaces：Agent 参与的工作区
• 设置：切换执行引擎绑定、撤销 Google Workspace 授权等

另外两个关键开关：

• 群成员调用权限：Owner 可开启/关闭"频道成员能否在共同频道里 @ 调用该 Agent"（setWorkspaceAgentChannelMemberAccessAction）
• 复制（Fork）与借用：团队成员可以发起"复制申请 / 频道使用申请"，必须经 Owner 在数字员工展板的"待我审批"队列中批准才能生效，这是 AgentSpace 保证控制权在人类手里的核心机制

5. 第三步：技能分配（Skills）与知识绑定

技能是 AgentSpace 中可复用的执行构件。给数字员工分配技能有两种路径：

1. 模板自动绑定：从模板创建时，匹配到的预置技能会直接挂上（见第 3 节）
2. 手动分配：进入 Agent 详情页 →Skills页签 → 打开技能选择器，从 workspace 技能库中勾选即可。保存动作由 setWorkspaceAgentSkillAssignmentsAction 完成，会写入agent_skill存储并广播刷新

分配建议：

• 📌 技能宁缺毋滥：只挂与岗位强相关的技能，Agent 的执行路径会更稳定
• 📌 技能可以跨 Agent 复用：一个优秀 Agent 的技能配置可以通过 Fork 邀请整体复制给新 Agent（可选择复制岗位、Instructions、技能、知识绑定）
• 📌 知识（Knowledge）页绑定决定 Agent 执行时能"看到"哪些文档上下文，建议随岗位一起配置

6. 进阶：用 CLI 管理数字员工

偏好命令行的用户，可以直接用 agent-space CLI（employee.ts）管理数字员工：

# 查看全部在岗数字员工（含岗位、traits、已绑定 runtime） npm run cli -- employee list --json # 创建一个数字员工 npm run cli -- employee create \ --name finance-analyst \ --role "Finance Analyst" \ --traits finance,budget,risk-aware \ --summary "预算、成本与经营分析" # 绑定 / 解绑执行引擎 npm run cli -- employee bind-runtime --name finance-analyst --runtime-id <runtime-id> npm run cli -- employee unbind-runtime --name finance-analyst

更多子命令（如export-persona导出可签名的 Agent 名片）可参考 packages/daemon/README.md 与agent-space employee的帮助输出。

7. 常见报错速查（FAQ）

8. 小结：你的第一个数字员工入职清单

1. ✅ Agents 页面新建 Agent：模板或空白，填好 Name / 岗位 / Instructions，选择执行引擎
2. ✅ 确认Owner 归属：管理员创建归团队，成员创建归本人
3. ✅ 详情页完成Skills / Knowledge 绑定与执行引擎配置
4. ✅ 按需打开群成员调用权限，或在展板审批队列中放行借用申请
5. ✅ 用agent-space employee list检查在岗状态

走完这 5 步，你的 Agent 就正式"入职"了：有岗位、有 Owner、有技能、有审计轨迹——这正是 AgentSpace「Human + Agents. One Team. One Workspace」的核心体验。想深入了解数字员工展板与权限控制面设计，可继续阅读 README_ZH.md 的 Framework 章节。

• 人工智能
• AI Agent
• Agent 编排
• 后端
• 前端
• 任务调度
• 认证鉴权