Skip to Content
数字员工 CLI 文档快手达人信息

快手达人信息 CLI 指令

kuaishou-creator-info-single 和 kuaishou-creator-info-batch 是“达人情报数字员工”的首批任务型能力。Agent CLI 目录会把它们映射为单条采集和批量采集两条结构化指令；数字员工运行时只能看到授权过滤后的子集。实际开放能力执行、任务创建、队列占用、终态刷新、任务/资产归属和审计仍复用 FunClaw 现有开放能力底座。

适用场景

| 场景 | CLI 指令 | 映射能力 | | --- | --- | | 只需要采集一个快手达人近期作品和主页信息。 | collect_kuaishou_creator_info_single | kuaishou-creator-info-single | | 需要一次提交多个快手号，并让系统按远端限制串行处理。 | collect_kuaishou_creator_info_batch | kuaishou-creator-info-batch |

当前单条和批量已经是两个清晰的产品化开放能力，第一版不再拆新的动作级 key。后续如果需要“查询历史结果”“读取达人资产”“复用上次任务”等不同业务动作，再按动作级能力规范补动作；如果只是为了大脑更好选择和补参数，优先新增 CLI 指令。

派发表单

workspace 和 console v1 都会根据能力的 inputSchemaJson 生成参数表单。v2 轻量大脑会先选择 CLI 指令，再映射到对应能力。派发者不需要手写 capability key，也不需要理解应用 ID 或 API Key。

表单项建议写法
工作标题用一句话说明目标，例如“采集快手达人 ks_creator_001”。
目标写清楚要采集哪些达人、结果用于什么分析。
CLI 指令 / 能力单个达人对应 collect_kuaishou_creator_info_single，多个达人对应 collect_kuaishou_creator_info_batch。
输入参数单条填写 kuaishouId；批量填写 items 数组。

单条采集

{
  "title": "采集快手达人 ks_creator_001",
  "objective": "获取该达人近期作品和主页信息，用于达人情报分析",
  "capabilityKey": "kuaishou-creator-info-single",
  "input": {
    "kuaishouId": "ks_creator_001"
  }
}
字段必填说明
kuaishouId是要采集的快手达人快手号。

批量采集

{
  "title": "批量采集快手达人",
  "objective": "采集多个达人近期作品和主页信息，用于达人池初筛",
  "capabilityKey": "kuaishou-creator-info-batch",
  "input": {
    "items": [
      {
        "kuaishouId": "ks_creator_001"
      }
    ]
  }
}
字段必填说明
items是达人列表，至少 1 条，当前建议一次不超过 100 条。
items[].kuaishouId是要采集的快手达人快手号。
items[].externalItemId否外部系统对账时才需要填写；数字员工派发通常不用填。

队列与结果

快手达人能力属于异步任务型能力。派发成功后，数字员工 work 会先进入 QUEUED，runner 领取后进入 RUNNING。如果共享远端队列被 douyin-top10-single、douyin-top10-batch、kuaishou-creator-info-single 或 kuaishou-creator-info-batch 占用，work 会进入 WAITING_FOR_QUEUE，系统会继续重试，用户也可以在工作详情里取消。

结果会沉淀到：

  • 数字员工工作记录：查看 work、step、响应摘要、失败原因和能力执行审计 ID。
  • 任务列表：查看平台 task 状态，归属显示为数字员工。
  • 资产列表：远端返回可写入产物时，会生成数字员工归属的资产。
  • console 能力审计：按 DIGITAL_EMPLOYEE 主体查看真实能力调用。

常见失败

错误码含义处理方式
QUEUE_BUSY共享远端队列正在被其他任务占用。等待系统重试，或取消后稍后重新派发。
CREATOR_DATA_MISSING_ARTIFACT远端任务已经返回终态，但没有提供 FunClaw 可写入资产的产物地址。按远端产物回传问题排查；如果 work、task 和审计已经写入，数字员工派发链路通常没有问题。
参数缺失或格式错误缺少 kuaishouId 或 items 结构不符合要求。按表单提示或本文示例修正后重新派发。

CREATOR_DATA_MISSING_ARTIFACT 当前按远端产物问题处理，不作为数字员工 v1 平台主闭环阻塞项。front 和 console 会展示该失败原因，避免用户误判为“任务没有派发过去”。

审计口径

数字员工调用会写入能力执行审计主体 DIGITAL_EMPLOYEE，并关联 digitalEmployeeId、workId 和 stepId。applicationId 仍作为来源授权和执行兼容上下文保留，但任务和资产的业务归属应显示为 数字员工-{数字员工名称}。

Last updated on
抖音热榜数据