Skip to Content
数字员工 CLI 文档概览

数字员工 CLI 文档

数字员工 CLI 是 Agent CLI 在数字员工场景下的授权过滤视图。这里的 CLI 指 Agent / 大模型可读取的结构化指令接口，不是操作系统 shell，也不是外部应用 API 的另一套副本。

平台级指令清单见 CLI 目录。本章节只说明数字员工如何读取授权后的 CLI 视图、如何把指令映射到 work 派发链路，以及如何沉淀工作记录和审计。

接入视角

层级用途
产品能力包面向开放文档、应用市场和授权聚合，例如 douyin-hot-rank-data。
Action产品能力内部真实不同的业务动作，例如写入、读取最新、按日期读取。
CLI 指令面向 Agent / 数字员工大脑选择和补参数，例如读取最新抖音热榜数据。
任务控制面向工作详情和后台治理，例如刷新异步任务、取消任务、查看产物。

数字员工工作台和 console 后台的手动派发入口已经使用授权过滤后的 CLI 指令视图。操作者选择 commandKey，后端再把指令映射回现有 capabilityKey、action 和 work 执行链路。任务查询、取消和当前任务查看不进入 CLI 指令目录，而是作为工作详情中的控制能力。

授权过滤视图

数字员工运行时读取的不是完整平台目录，而是后端过滤后的员工视图：

GET /api/v1/organizations/{orgId}/digital-employees/{employeeId}/cli/commands

这个视图必须同时满足：

条件说明
员工状态数字员工必须是可工作的 ACTIVE 状态。
能力包授权员工能力包中必须授权了指令映射的能力或可展开到该动作的产品能力。
组织来源授权当前组织必须仍有可执行该能力的应用来源授权。
指令状态Agent CLI 指令自身必须是启用状态。

能力包授权

平台管理员在 console 审核数字员工后，为数字员工配置能力包。第一版仍以 capability key 授权，后端会做兼容展开：

授权 key数字员工可见 CLI 指令
产品能力包 key该产品包下已经整理好的动作或直接能力会映射为 CLI 指令。

单独授权某个动作只开放映射到该动作的 CLI 指令，不会反向扩大到同一产品包下的其他动作。

派发工作

团队用户在 front 的数字员工工作台或 console 后台选择一个 ACTIVE 数字员工，填写工作标题、目标并选择 CLI 指令。UI 提交的是 commandKey，不是让用户手写或选择底层 capabilityKey。后端会自动选择组织内已授权应用完成真实开放能力执行，派发者不需要理解 API Key 或应用 ID。

POST /api/v1/organizations/{orgId}/digital-employees/{employeeId}/cli/command-works
{
  "title": "派发一项已授权工作",
  "objective": "说明这次工作要读取、提交或处理什么业务结果",
  "commandKey": "<从授权过滤视图选择的 CLI 指令 key>",
  "input": {
    "业务字段": "只填写当前动作需要的输入"
  }
}

CLI 指令派发入口只负责把 commandKey 翻译成已授权的 capabilityKey 或 action，再复用既有 digital_employee_work、digital_employee_work_step、runner、task、artifact 和 audit 链路。旧的 capability-key 派发接口只作为兼容或内部路径保留，不再作为 workspace / console 手动派发的首选入口。

抖音热榜数据

douyin-hot-rank-data 在外部应用文档中仍然是一个产品能力包。它内部有 write、latest、by-date 三个真实 action；Agent CLI 目录会把这些 action 映射为更适合大脑选择的指令。

查看 抖音热榜数据 CLI 指令。

异步任务型能力

异步能力要区分提交动作和任务控制。以 douyin-top10-single 为例，数字员工派发时选择的是“提交 Top10 单条采集任务”；查询任务、取消任务和当前运行任务属于工作详情里的控制操作，不作为可派发动作进入下拉列表。

后续如果需要更友好的大脑表达，应优先增加 Agent CLI 指令，而不是为了命名好懂强行拆提交型 action。外部应用原有的开放能力执行、任务查询和取消接口保持不变。

审计与记录

数字员工工作会沉淀 digital_employee_work 和 digital_employee_work_step，真实能力调用继续复用开放能力执行审计。console 能从能力审计中区分调用主体是外部应用还是数字员工，并能通过工作记录回看输入、结果、失败原因和关联审计 ID。

Last updated on
CLI 目录抖音热榜数据