CLI 目录

CLI 目录展示平台当前沉淀的 Agent CLI 指令。这里的 CLI 指 Agent / 大模型可读取的结构化指令接口，不是操作系统 shell，也不是外部开放 API 的另一套入口。

Agent CLI 是通用指令层。数字员工是第一类消费者，但不是唯一消费者；数字员工 CLI 只是 Agent CLI 在员工场景下的授权过滤视图。文档中的目录用于让人理解指令语义，运行时某个数字员工实际能看到哪些指令，必须由后端按员工状态、能力包授权和组织来源授权过滤。


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

这个接口返回的是数字员工视角的授权过滤结果。workspace 和 console 的手动派发会把选中的 commandKey 提交到数字员工 CLI 指令工作入口：


POST /api/v1/organizations/{orgId}/digital-employees/{employeeId}/cli/command-works

commandKey 只在这个数字员工工作入口中生效。CLI 指令不是外部应用的 capabilityKey，不能用 command key 调用开放能力执行入口。外部应用仍使用平台能力文档中的 POST /api/open/v1/organizations/{orgId}/capabilities/{capabilityKey}:execute。

首批指令

commandKey	指令名称	映射能力	执行模式	适用场景
`collect_adx_creator_data_single`	ADX 达人数据采集单条	`adx-creator-data-single`	`ASYNC_TASK`	外部应用已经拼好单条 ADX 采集提示词，需要创建一次采集任务。
`collect_adx_creator_data_batch`	ADX 达人数据采集批量	`adx-creator-data-batch`	`ASYNC_TASK`	外部应用已经拼好多条 ADX 采集提示词，需要批量串行采集。
`collect_douyin_top10_single`	单条抖音 Top10 采集	`douyin-top10-single`	`ASYNC_TASK`	单个内容对象、关键词或剧目采集。
`collect_douyin_top10_batch`	批量抖音 Top10 采集	`douyin-top10-batch`	`ASYNC_TASK`	多条内容目标批量采集。
`backfill_douyin_video_url`	回填抖音视频真实地址	`douyin-video-url-backfill`	`ASSET_WRITE`	已有 videoId 和真实播放地址，需要补齐 Top10 资产。
`collect_kuaishou_creator_info_single`	单个快手达人信息采集	`kuaishou-creator-info-single`	`ASYNC_TASK`	采集一个明确快手号。
`collect_kuaishou_creator_info_batch`	批量快手达人信息采集	`kuaishou-creator-info-batch`	`ASYNC_TASK`	一次提交多个快手达人采集目标。
`write_douyin_hot_rank_data`	写入抖音热榜数据	`douyin-hot-rank-data.write`	`ASSET_WRITE`	用户提供完整热榜数据并希望沉淀为资产。
`read_latest_douyin_hot_rank_data`	读取最新抖音热榜数据	`douyin-hot-rank-data.latest`	`ASSET_READ`	查看当前已有的最新热榜资产。
`read_douyin_hot_rank_data_by_date`	按日期读取抖音热榜数据	`douyin-hot-rank-data.by-date`	`ASSET_READ`	查看某个业务日期的热榜资产。

字段口径

运行时接口返回 ListResponse<AgentCliCommandResponse>，每条指令包含：

字段	说明
`commandKey`	稳定指令 key，供 Agent / 大脑规划选择。
`displayName`	指令展示名称。
`description`	指令说明。
`capabilityKey`	实际映射的开放能力或动作级 capability key。
`actionKey`	产品能力内部动作 key；非动作级指令为空。
`inputSchemaJson`	Agent CLI 指令 schema；未单独配置时继承能力 schema。
`promptHint`	大脑选择指令和补参数时可读的提示。
`examplesJson`	指令示例。
`executionMode`	执行模式，例如 `ASYNC_TASK`、`ASSET_READ`、`ASSET_WRITE`。

权限边界

CLI 指令不单独授权。数字员工 CLI 视图继承数字员工能力包、组织应用来源授权和员工状态校验。文档可以展示平台支持的完整 Agent CLI 指令目录，但某个员工运行时只能读取后端过滤后的子集。

未来外部 Agent 或 MCP 可以读取同一批 Agent CLI 指令的另一种授权过滤视图，但不复用数字员工身份，也不能绕过开放能力授权。