Appearance
数字员工
创建、配置、发布和管理本租户可用的数字员工——基于大模型的 AI 助手，可以挂在通讯录里、加入群聊、绑定运行环境处理业务。每个数字员工像一位虚拟同事：有名字、职位、可见范围、说明书、调用权限。
进入路径
左侧菜单 数字员工 → 数字员工
概念速览
| 概念 | 一句话 |
|---|---|
| 数字员工 | 一个由本租户配置 / 平台托管的 AI Agent，员工可以在客户端和它对话或拉它进群。 |
| 状态 | 草稿（创建未发布，仅自己可见）/ 已发布（客户端可用）/ 灰度（部分用户可见，做小范围验证）。 |
| 可见范围 | 谁能用到这个数字员工：全租户 / 指定部门 / 仅创建者。 |
| 主模型 | 数字员工底层用的大模型，决定对话能力 / 速度 / 成本。 |
| 运行环境 | 数字员工实际运行所在的基础设施（平台托管 or 外部接入），发布前必须绑定。 |
| 职位 | 数字员工在通讯录里的「title」（如「客服」「数据分析师」），和人类员工共用 职位 字典。 |
| 标签 | 卡片上的短标签（如「企业官方」「测试版」），用来快速识别。 |
| 进入通讯录 | 开关，决定数字员工是否出现在客户端通讯录里。 |
| 可被拉群 | 开关，决定员工能否把数字员工拉进群聊。 |
页面一览
截图占位:数字员工列表 —
> 顶部 toolbar：总数 + **+ 新建数字员工**。主体是**卡片式网格**（每行 3 个）：每张卡片有头像 + 名字 + 编号 + 状态徽章 + 简介 / 职位 + 一排标签（可见范围 / 来源 / 主模型 / 进通讯录 / 可拉群 / 自定义 badges）+ 行末操作按钮（草稿→发布；已发布→下架）。点卡片本体进详情页。 tenant-agents-list.png操作步骤
1. 新建数字员工
- 右上 + 新建数字员工 → 抽屉打开。
- 填三段字段：
- 基础信息：名称（必填）/ 主模型（如 GPT-4o mini）/ 员工简介（说明职责、能力边界、适用场景）。
- 通讯录与范围：
- 职位（通讯录主显示）
- 展示标签（逗号分隔，如「企业官方, 测试版」）
- 可见范围（全租户 / 指定部门 / 仅创建者）
- 部门（仅「指定部门」时填）
- 是否进通讯录、是否允许被拉群（两个开关）
- 运行环境：从下拉里选已经启用的环境；可暂不绑定，发布前再补。下拉里没有想要的环境时，点 + 新建自定义运行环境 跳到 智能体托管环境 创建。
- 点 创建 → 进入 草稿状态。
- 关闭抽屉自动回到列表，可继续编辑详情或直接发布。
2. 编辑详情
点列表卡片本体 → 进入数字员工详情页。详情页里可改更全的字段（说明书、温度、上下文窗口、技能绑定等）。本页只展示卡片级信息，详细配置在详情页内进行。
3. 发布
- 草稿状态卡片右下角 发布 按钮 → 数字员工进入「已发布」状态。
- 发布前必须满足：已绑定可用运行环境。没绑会发布失败，去详情页或新建对话框补绑。
- 发布后客户端立即可用（取决于「可见范围」对应的员工范围）。
4. 下架
- 已发布 / 灰度状态卡片右下角 下架 按钮 → 弹简单确认。
- 下架后客户端立即不可用，但数字员工本身保留（变回草稿）；想恢复重新发布即可。
- 适合：发现 bug 临时撤回 / 功能验证完毕 / 永久退役（下架后再删除）。
5. 切可见范围
在详情页改「可见范围」字段：
| 范围 | 谁能看到和用到 |
|---|---|
| 全租户 | 本租户所有员工 |
| 指定部门 | 仅所选部门的员工（可一次选多个） |
| 仅创建者 | 只有创建该数字员工的人可见（适合个人测试） |
状态机
[ 草稿 ] --(发布)--> [ 已发布 ] --(下架)--> [ 草稿 ]
│
└---(灰度上线)--> [ 灰度 ] --(发布)--> [ 已发布 ]
--(下架)--> [ 草稿 ]字段约束
- 名称：1-64 字符，非空。
- 运行环境：发布前必须绑定可用环境；草稿状态可空。
- 可见范围：默认「全租户」；选「指定部门」时必须选一个或多个部门。
- 主模型：从平台开放的白名单里选，租户不能自己加。
- 进入通讯录 / 可被拉群：两个独立开关，互不耦合（如可以「在通讯录可见但不允许被拉群」）。
相关菜单
- 数字员工运行的基础设施：智能体托管环境
- 数字员工挂的职位字典：职位
- 给员工 / 数字员工配通讯录字段可见性：通讯录配置
- 让数字员工能调用应用的授权：应用栏配置
- 开发者参考（接入协议 / 模型白名单）：开发者文档
常见问题
Q：「创建数字员工」为什么不是一个独立菜单？ A：创建是列表页内的主操作，右上角按钮就能开抽屉；独立放菜单反而绕一道。点击列表页右上 + 新建数字员工 即可，效果等同。
Q：发布失败提示「没有可用运行环境」？ A：进 智能体托管环境 启用一个平台环境，或新增一个接入方 Agent Runtime，连通性测试通过后回来再发布。
Q：下架后已经发出去的对话历史会丢吗？ A：不会。下架仅让数字员工新会话不可用，老会话记录保留，员工的客户端历史完整。
Q：能把数字员工从一个部门移到另一个？ A：能。详情页改「可见范围」对应的部门即可，立即生效。
Q：草稿状态的数字员工只有我能看到？ A：是。草稿对租户内其他人完全不可见，便于自己慢慢调；调好了再发布给团队。
Q：「灰度」和「已发布」业务差异？ A：灰度通常按用户分桶（如 10% 流量），用于上线前最后一轮验证。具体灰度策略由平台 / 业务实现决定，本页只显示状态徽章。