ADX 达人数据单条

adx-creator-data-single 用于创建单次 ADX 达人数据采集任务。调用方需要在外部应用内完成提示词组装，FunClaw 只接收 prompt 并原样转发到 session-hub。

能力信息

字段	值
能力 Key	`adx-creator-data-single`
能力名称	ADX 达人数据单条
能力类型	`workflow_execute`
开放状态	可通过统一开放能力执行入口调用

底层执行复用平台任务、共享远端队列、session-hub creator-data task、结果抓取、资产写入和任务状态追踪能力。对外返回和查询使用平台任务 ID，session-hub 任务 ID 属于内部实现细节。

开始任务


POST /api/open/v1/organizations/{orgId}/capabilities/adx-creator-data-single:execute
Authorization: Bearer <sk-organization-application-api-key>
Content-Type: application/json

请求体


{
  "applicationId": "organization-application-id",
  "input": {
    "prompt": "外部应用已经拼好的 ADX 提示词"
  }
}

字段说明：

字段	必填	说明
`applicationId`	否	调用方团队应用 ID。传入时必须和 API Key 绑定的应用一致；不传时平台会使用 API Key 绑定的应用。
`input.prompt`	是	外部应用已组装好的 ADX 采集提示词。FunClaw 不再进行服务端提示词拼接，仅将 `prompt` 原样转发到 session-hub。Top10 看板自动生成的 prompt 会要求 Worker 抓取 30 条素材（`fetch_material_top.py --limit 30`）并 mirror 全部行；结果页默认展示 10 条，拉黑后从储备池补位。

开始任务成功表示平台已接收请求，并创建平台任务、底层执行和资产写入链路。


{
  "capabilityKey": "adx-creator-data-single",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "taskId": "platform-task-id",
    "status": "RUNNING",
    "request": {
      "prompt": "外部应用已经拼好的 ADX 提示词"
    },
    "result": null,
    "error": null,
    "artifacts": [],
    "createdAt": "2026-06-16T09:00:00Z",
    "updatedAt": "2026-06-16T09:00:01Z"
  }
}

顶层 message/code 表示本次开放能力入口调用成功；data.status 表示异步任务状态。

Agent CLI 映射

Agent CLI 目录中，collect_adx_creator_data_single 会映射到本开放能力 adx-creator-data-single。CLI 指令用于 Agent / 数字员工大脑选择和补参数，不改变外部应用的开放 API 契约。

CLI 指令不是外部应用的 capabilityKey；外部应用仍调用本页的 adx-creator-data-single:execute。完整指令目录见 CLI 目录。

查询当前运行任务

adx-creator-data-single、adx-creator-data-batch、douyin-top10-single、douyin-top10-batch、kuaishou-creator-info-single 和 kuaishou-creator-info-batch 共享底层 douyin-top10 远端资源队列。队列容量由平台配置决定；所有 slot 都被占满时，新的 ADX、抖音 Top10 或快手达人信息创建请求会返回 409。


GET /api/open/v1/organizations/{orgId}/capabilities/adx-creator-data-single/current-task
Authorization: Bearer <sk-organization-application-api-key>


{
  "capabilityKey": "adx-creator-data-single",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "running": true,
    "queueKey": "douyin-top10",
    "ownerCapabilityKey": "adx-creator-data-batch",
    "taskId": "platform-task-id",
    "executionId": "platform-execution-id",
    "status": "RUNNING",
    "acquiredAt": "2026-06-16T09:00:00Z",
    "activeCount": 2,
    "capacity": 2,
    "owners": []
  }
}

查询任务


GET /api/open/v1/organizations/{orgId}/capabilities/adx-creator-data-single/tasks/{taskId}
Authorization: Bearer <sk-organization-application-api-key>

taskId 使用开始任务返回的 data.taskId，即平台任务 ID。

成功后：


{
  "capabilityKey": "adx-creator-data-single",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "taskId": "platform-task-id",
    "status": "SUCCEEDED",
    "request": {
      "prompt": "外部应用已经拼好的 ADX 提示词"
    },
    "result": {
      "merge_update_event": {
        "event_time": "2026-06-16T09:02:00Z",
        "event_timezone": "Asia/Shanghai",
        "record_count": 10
      },
      "douyin_top_videos": []
    },
    "error": null,
    "artifacts": [
      {
        "id": "artifact-id",
        "taskId": "platform-task-id",
        "artifactType": "DOCUMENT",
        "title": "ADX 达人数据 - 结果 1",
        "mimeType": "application/json",
        "downloadUrl": "/api/open/v1/organizations/{orgId}/artifacts/artifact-id/download"
      }
    ],
    "createdAt": "2026-06-16T09:00:00Z",
    "updatedAt": "2026-06-16T09:02:00Z"
  }
}

data.result 是 session-hub 返回的实际 JSON 数据；data.artifacts[].downloadUrl 是结果文件下载入口。失败后 data.status 为 FAILED，data.error 会携带底层失败信息。

取消任务

运行中的单条任务可以使用平台任务 ID 取消：


POST /api/open/v1/organizations/{orgId}/capabilities/adx-creator-data-single/tasks/{taskId}:cancel
Authorization: Bearer <sk-organization-application-api-key>

取消成功：


{
  "capabilityKey": "adx-creator-data-single",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "taskId": "platform-task-id",
    "status": "CANCELLED",
    "request": {
      "prompt": "外部应用已经拼好的 ADX 提示词"
    },
    "result": null,
    "error": {
      "code": "OPEN_CAPABILITY_CANCELLED_BY_USER",
      "message": "cancelled by open capability caller"
    },
    "artifacts": []
  }
}

已处于 SUCCEEDED 或 FAILED 的终态任务不可取消，会返回 409。已取消任务重复调用取消接口时，会返回当前已取消状态。

常见错误

HTTP 状态	场景
`400`	缺少 `input.prompt`，或 `prompt` 为空。
`401`	未提供 `Authorization: Bearer <sk-...>`。
`403`	API Key 不属于当前组织、未绑定该应用，或应用未获得本能力授权。
`404`	能力不存在、未启用，或查询的任务不属于当前 API Key 绑定应用。
`409`	共享 `douyin-top10` 远端队列已满。
`501`	能力存在但后端 executor 尚未注册。

ADX 达人数据 单条