---
document_id: agent.workflows
schema_version: 2
parent_document_id: agent.guide
section: workflows
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Agent Task Migration / Agent 任务迁移

Use the high-level Agent task workflow while keeping fine-grained Data APIs available to developers. / 面向 Agent 使用高层任务流程，同时为开发者保留完整细粒度 Data API。

## Agent social workflow / Agent 社媒任务流程

- Use this path only when authenticated `discover` lists a published and authorized social `operation_id` for the current region. Static examples do not grant access; availability and production readiness come from the current discovery response.
  仅当认证后的 `discover` 列出当前区域已发布且有权使用的社媒 `operation_id` 时走此路径。静态示例不授予权限，也不代表来源路线或生产验收已完成。
- Use the discovered input schema with `run` and a stable `idempotency_key`. A covering server-side BudgetGrant enters `queued`; otherwise `run` returns `awaiting_approval` and a bound, with no execution, reservation, or charge. After approval, retry the same operation, input, and key.
  按发现的入参 schema 调用 `run`，使用稳定的 `idempotency_key`。服务端 BudgetGrant 覆盖时进入 `queued`；否则返回 `awaiting_approval` 与费用上界，审批前不外呼、不预留、不收费。获批后用原 operation、入参和键重试。
- For controlled programmatic submissions, use `wait_seconds=0`. When `run` returns a task reference, read status and results with `task` after `poll_after_seconds`; saved results are free to read. Use `cancel` for work not yet executed; never automatically replay an unknown execution outcome.
  程序化受控提交可用 `wait_seconds=0`。`run` 返回任务引用时，按 `poll_after_seconds` 用 `task` 读取状态和结果；已保存结果免费读回。用 `cancel` 取消未执行部分；执行结果未知时不得自动重采。
- For supported social searches, request one platform at a time; the default is three pages with details off. Request details only when supported and explicitly approved. Historical dataset queries keep their existing Data API path.
  对已支持的社媒搜索，一次只请求一个平台；默认三页且不补详情。只有能力支持并明确获批时才请求详情。历史数据集查询继续走既有 Data API 路径。

## New data APIs and Agent examples / 新版数据 API 与 Agent 示例

- Find a platform and business capability in the Dashboard catalog. New and Existing labels distinguish entrypoints; Existing does not mean retired. API access shows programmatic requests, while Agent tools provides a copyable instruction for the same capability and the selected MCP or CLI connection. / 先在能力目录中找到平台和业务能力。“新版 / 原有”用于区分调用入口，“原有”不代表已下线。API 接入提供程序请求，Agent 工具提供同一能力在所选 MCP 或 CLI 接入方式下可复制的指令。
- For example, ask your Agent: Find Amazon coffee machines and read reviews for a selected product; confirm scope and cost first. Or: Find public Xiaohongshu notes about coffee and read comments for a selected note. The Agent must discover the available operations and current schemas before using the copied request example. / 例如，向 Agent 提问：“帮我搜索 Amazon 咖啡机，再查看一个选定商品的评论，先确认范围与费用。”或“帮我查找小红书上关于咖啡的公开笔记，再查看一篇选定笔记的评论。”Agent 应先发现当前可用能力及参数定义，再按复制的调用示例执行。
- An operation ID such as social.xhs.note.search is the stable business identifier. Native HTTP uses resource paths such as POST /v1/native/social/xhs/notes/search; use the published method and path instead of constructing a URL from the ID. Dotted operation-ID URLs are not registered and return 404; they are not part of the directory. MCP run and POST /v1/agent/run use an operation field; they are dispatchers, not separate capabilities named run. Use only the transport published for that operation. / social.xhs.note.search 这样的 operation ID 是稳定的业务标识。Native HTTP 使用 POST /v1/native/social/xhs/notes/search 这样的资源路径，请按目录发布的 method 和 path 调用，不要根据 ID 拼接 URL。点号 operation ID URL 不再注册，直接返回 404，也不属于能力目录。MCP 的 run 和 POST /v1/agent/run 通过 operation 字段选择业务能力，run 本身不是一个新的数据能力。只使用该项能力实际发布的调用方式。
- Bearer-authenticated GET /v1/native?format=markdown and API access publish current schemas, parameter/default/limit notes and examples. Synthetic examples do not establish live availability or prices. Replace sample inputs, set a budget and a new Idempotency-Key. / 用 Bearer 认证 GET /v1/native?format=markdown 或 API 接入读取当前 schema、参数/默认值/限制与示例。离线示例不代表线上可用或实际价格；替换示例输入，设置预算与新的 Idempotency-Key。
- Twitter HTTP v1 uses keyword/search_type/cursor (default Top); v2 uses query/type/cursor (default Latest). Their data is code+data and tweets+next_cursor respectively. Follow each published path and version; no automatic switching. / Twitter HTTP v1 使用 keyword/search_type/cursor，默认 Top，data 保留 code+data；v2 使用 query/type/cursor，默认 Latest，data 保留 tweets+next_cursor。按已发布路径和版本调用，不自动切换。
- HTTP data retains full sanitized business envelopes, text and nested fields. Follow raw/need_format layouts. When published, copy non-null meta.next_input as the next input with a new key/budget; null provides no next page. Otherwise follow the published cursor contract. / HTTP data 保留完整脱敏业务 envelope、正文与嵌套字段，结构随 raw/need_format 变化。发布 meta.next_input 时，将非 null 的完整对象复制为下一页 input，使用新幂等键/预算；null 不提供下一页。没有该字段时按公开游标合同调用。
- Pending HTTP calls use status_url; Tasks use task_ref and poll_after_seconds. Read saved results with their original version without a new source request or charge; actual HTTP cost is meta.credits_charged. / HTTP pending 沿 status_url 读取；Task 沿 task_ref 和 poll_after_seconds 读取。已存结果按原版本读回，不重新请求或扣费；HTTP 实扣费用读取 meta.credits_charged。

## Catalog, API access, Agent tools and Docs / 目录、API 接入、Agent 工具与文档的关系

- The three Dashboard pages read the same runtime directory: the catalog answers what data is available, API access explains programmatic calls, and Agent tools helps an Agent use those capabilities. Each transport is listed separately, so entrypoint counts are not counts of distinct business capabilities. / 三个 Dashboard 页面读取同一份运行时目录：能力目录回答“有哪些数据”，API 接入说明“程序怎么调用”，Agent 工具帮助“让 Agent 使用这些能力”。同一能力可以有多种调用入口，入口数量不等于独立业务能力数量。
- Docs provides public instructions and business examples generated from the maintained knowledge and contracts. Dashboard links to these instructions and reads current schemas from the service. Documentation is published with the site, not updated by a customer request; current availability, access and pricing must be checked in authenticated discovery and actual calls. / Docs 提供从维护中的知识源和契约生成的公开说明与业务示例；Dashboard 链接这些说明，并从服务读取当前参数定义。文档随站点发布，不会因客户调用而实时改写；当前可用范围、权限和费用仍需通过认证后的发现与实际调用确认。

## Product boundary / 产品边界

- Data API remains the complete, fine-grained interface for programs and developers. / Data API 继续为程序和开发者提供完整、细粒度的接口。
- MCP and CLI expose the same Agent-oriented operations over the shared DataTaskService; CLI calls Task HTTP directly and does not call MCP. / MCP 与 CLI 基于共享 DataTaskService 提供一致的 Agent 能力；CLI 直接调用 Task HTTP，不调用 MCP。

## Task workflow / 任务流程

- Use discover to inspect authorized operations, run to submit or resume, task to read status and saved results, and cancel to stop work that has not started. / 用 discover 查看当前身份可用能力，用 run 提交或恢复任务，用 task 读取状态和已保存结果，用 cancel 停止尚未开始的工作。
- Keep the same idempotency_key after approval, timeout, or an uncertain response. Poll only after poll_after_seconds; this value is guidance, not an ETA or SLA. / 审批重放、超时或响应不确定时复用同一 idempotency_key；只按 poll_after_seconds 轮询，该值是建议，不是 ETA 或 SLA。
- Reading saved status or results does not start execution or charge again. Unknown execution outcomes must not be retried automatically. / 读取已保存状态或结果不会再次执行或收费；执行结果 unknown 时不得自动重采。
- New social Task snapshots return core fields per item: complete available text, author, publication time, engagement and identifiers. REST, MCP and CLI read the same saved projection without the full source JSON. Relative time and formatted counts remain source text; long text uses saved-result continuation. Existing snapshots keep their stored fields. / 新社媒 Task 快照逐条返回核心字段：完整可用正文、作者、发表时间、互动数和身份 ID。REST、MCP 与 CLI 读取同一份已存投影，不附完整来源 JSON。相对时间和格式化计数保留来源原文，长正文沿已存结果续读；旧快照保留原有字段。

## Social search defaults / 社媒搜索默认值

- One search covers one platform. It defaults to 3 pages with details disabled; callers may choose any positive page count up to the platform limit, or max pages. / 一次搜索只处理一个平台，默认 3 页且不补详情；调用方可传平台上限以内的任意正整数，或 max 页。
- When include_details is true, enrich every deduplicated result within the approved scope instead of applying a hidden item limit. / include_details=true 时，对批准范围内全部去重结果补详情，不使用隐藏条数限制。

## Rollout authority / 上线准据

- Authenticated discover responses are authoritative for current operations, schemas, regions, entitlements, and billing behavior. / 当前 operation、schema、区域、权限和计费行为以认证后的 discover 响应为准。
- Legacy Data API, Collection, CLI, and MCP entry points remain compatible until a separately announced removal. / 旧 Data API、Collection、CLI 和 MCP 入口继续兼容，直至另行公告下线。

## Legacy capability migration matrix / 旧能力迁移矩阵

| Surface / 旧入口 | Existing capability / 现有能力 | Agent operation / 新 operation | Retention / 保留方式 | Compatibility until / 兼容期限 | Unmigrated reason / 未迁移原因 | Owner / 负责人 |
| --- | --- | --- | --- | --- | --- | --- |
| Data API / Data API | POST /v1/query_metrics / POST /v1/query_metrics（指标查询） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/query_details / POST /v1/query_details（明细查询） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/search_values / POST /v1/search_values（维值搜索） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | GET /v1/datasets/{dataset}/values / GET /v1/datasets/{dataset}/values（旧维值搜索） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/search_products / POST /v1/search_products（商品搜索） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/quote / POST /v1/quote（费用预估） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/run_sql / POST /v1/run_sql（SQL 查询） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | GET /v1/rankings/{dataset}/{agg} / GET /v1/rankings/{dataset}/{agg}（便捷排行） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/search / POST /v1/search（网页搜索） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | POST /v1/search/raw_html / POST /v1/search/raw_html（网页 HTML 获取） | Pending accepted operation / 待验收 operation | Keep the fine-grained developer REST endpoint. / 保留面向开发者的细粒度 REST 接口。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | No accepted Agent Definition currently covers this exact contract. / 当前没有已验收的 Agent Definition 覆盖该具体契约。 | Roles A+B / 甲＋乙 |
| Data API / Data API | GET /v1/datasets / GET /v1/datasets（数据集列表） | discover / discover | Keep the developer REST endpoint; Agent discovery uses accepted Definitions. / 保留开发者 REST；Agent discovery 使用已验收 Definitions。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Mapped, but production discovery wiring remains pending. / 已映射，但生产 discovery 接线仍待完成。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/datasets/{dataset} / GET /v1/datasets/{dataset}（数据集说明） | discover / discover | Keep the developer REST endpoint; Agent discovery uses accepted Definitions. / 保留开发者 REST；Agent discovery 使用已验收 Definitions。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Mapped, but production discovery wiring remains pending. / 已映射，但生产 discovery 接线仍待完成。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/search_products/{query_id} / GET /v1/search_products/{query_id}（商品搜索状态） | task / task export / task / task export | Keep legacy IDs; new tasks use task_ref and snapshot_ref. / 保留旧 ID；新任务使用 task_ref 与 snapshot_ref。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy IDs and Data Task snapshots are intentionally not interchangeable. / 旧 ID 与 Data Task snapshot 有意保持不互通。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/results/{query_id} / GET /v1/results/{query_id}（查询结果读取） | task / task export / task / task export | Keep legacy IDs; new tasks use task_ref and snapshot_ref. / 保留旧 ID；新任务使用 task_ref 与 snapshot_ref。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy IDs and Data Task snapshots are intentionally not interchangeable. / 旧 ID 与 Data Task snapshot 有意保持不互通。 | Roles A+C / 甲＋丙 |
| Data API / Data API | POST /v1/export / POST /v1/export（创建导出） | task / task export / task / task export | Keep legacy IDs; new tasks use task_ref and snapshot_ref. / 保留旧 ID；新任务使用 task_ref 与 snapshot_ref。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy IDs and Data Task snapshots are intentionally not interchangeable. / 旧 ID 与 Data Task snapshot 有意保持不互通。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/export/{job_id} / GET /v1/export/{job_id}（导出状态） | task / task export / task / task export | Keep legacy IDs; new tasks use task_ref and snapshot_ref. / 保留旧 ID；新任务使用 task_ref 与 snapshot_ref。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy IDs and Data Task snapshots are intentionally not interchangeable. / 旧 ID 与 Data Task snapshot 有意保持不互通。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/exports / GET /v1/exports（导出列表） | task / task export / task / task export | Keep legacy IDs; new tasks use task_ref and snapshot_ref. / 保留旧 ID；新任务使用 task_ref 与 snapshot_ref。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy IDs and Data Task snapshots are intentionally not interchangeable. / 旧 ID 与 Data Task snapshot 有意保持不互通。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/search/{job_id} / GET /v1/search/{job_id}（网页搜索状态） | task / task export / task / task export | Keep legacy IDs; new tasks use task_ref and snapshot_ref. / 保留旧 ID；新任务使用 task_ref 与 snapshot_ref。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy IDs and Data Task snapshots are intentionally not interchangeable. / 旧 ID 与 Data Task snapshot 有意保持不互通。 | Roles A+C / 甲＋丙 |
| Data API / Data API | GET /v1/datasets/{dataset}/sample / GET /v1/datasets/{dataset}/sample（样例行） | None / 无 | Keep as a developer or support-plane endpoint. / 作为开发者或支持面接口保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | This endpoint is not a business Data Task. / 该接口不属于业务 Data Task。 | Platform owners / 平台负责人 |
| Data API / Data API | GET /v1/pricing / GET /v1/pricing（价格查询） | None / 无 | Keep as a developer or support-plane endpoint. / 作为开发者或支持面接口保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | This endpoint is not a business Data Task. / 该接口不属于业务 Data Task。 | Platform owners / 平台负责人 |
| Data API / Data API | GET /v1/usage / GET /v1/usage（用量查询） | None / 无 | Keep as a developer or support-plane endpoint. / 作为开发者或支持面接口保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | This endpoint is not a business Data Task. / 该接口不属于业务 Data Task。 | Platform owners / 平台负责人 |
| Collection REST / Collection REST | GET /v1/collections/tasks / GET /v1/collections/tasks（采集任务列表） | discover / discover | Keep explicitly callable. / 保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production publication waits for accepted Definitions. / 生产发布仍等待已验收 Definitions。 | Roles A+C / 甲＋丙 |
| Collection REST / Collection REST | GET /v1/collections/tasks/{task_code} / GET /v1/collections/tasks/{task_code}（采集任务说明） | discover / discover | Keep explicitly callable. / 保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production publication waits for accepted Definitions. / 生产发布仍等待已验收 Definitions。 | Roles A+C / 甲＋丙 |
| Collection REST / Collection REST | POST /v1/collections/estimate / POST /v1/collections/estimate（采集估价） | run (search_social_content / inspect_social_content / research_social_creator / get_social_trends) / run（search_social_content / inspect_social_content / research_social_creator / get_social_trends） | Keep explicitly callable. / 保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Real execution wiring remains pending. / 真实执行接线仍待完成。 | Roles A+C / 甲＋丙 |
| Collection REST / Collection REST | POST /v1/collections/jobs / POST /v1/collections/jobs（启动采集） | run (search_social_content / inspect_social_content / research_social_creator / get_social_trends) / run（search_social_content / inspect_social_content / research_social_creator / get_social_trends） | Keep explicitly callable. / 保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Real execution wiring remains pending. / 真实执行接线仍待完成。 | Roles A+C / 甲＋丙 |
| Collection REST / Collection REST | GET /v1/collections/jobs/{job_id} / GET /v1/collections/jobs/{job_id}（采集任务读取） | task / task | Keep legacy job reads. / 保留旧 job 读取。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy jobs remain readable only through their original entrypoint. / 旧 job 仍只能从原入口读取。 | Roles A+C / 甲＋丙 |
| Legacy MCP / 旧 MCP | query_metrics / query_metrics（指标查询工具） | run after Definition acceptance / Definition 验收后使用 run | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted for production discovery. / 对应 operation Definition 尚未通过生产 discovery 验收。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | query_details / query_details（明细查询工具） | run after Definition acceptance / Definition 验收后使用 run | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted for production discovery. / 对应 operation Definition 尚未通过生产 discovery 验收。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | search_values / search_values（维值搜索工具） | run after Definition acceptance / Definition 验收后使用 run | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted for production discovery. / 对应 operation Definition 尚未通过生产 discovery 验收。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | search_products / search_products（商品搜索工具） | run after Definition acceptance / Definition 验收后使用 run | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted for production discovery. / 对应 operation Definition 尚未通过生产 discovery 验收。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | quote / quote（费用预估工具） | run after Definition acceptance / Definition 验收后使用 run | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted for production discovery. / 对应 operation Definition 尚未通过生产 discovery 验收。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | run_sql / run_sql（SQL 查询工具） | run after Definition acceptance / Definition 验收后使用 run | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted for production discovery. / 对应 operation Definition 尚未通过生产 discovery 验收。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | list_datasets / list_datasets（数据集列表工具） | discover / discover | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production discovery wiring remains pending. / 生产 discovery 接线仍待完成。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | describe / describe（数据集说明工具） | discover / discover | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production discovery wiring remains pending. / 生产 discovery 接线仍待完成。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | results / results（结果读取工具） | task / task export / task / task export | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | export / export（创建导出工具） | task / task export / task / task export | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | export_status / export_status（导出状态工具） | task / task export / task / task export | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | list_exports / list_exports（导出列表工具） | task / task export / task / task export | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | list_collection_tasks / list_collection_tasks（采集任务列表工具） | discover / discover | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production publication waits for accepted Definitions. / 生产发布仍等待已验收 Definitions。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | describe_collection_task / describe_collection_task（采集任务说明工具） | discover / discover | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production publication waits for accepted Definitions. / 生产发布仍等待已验收 Definitions。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | estimate_collection / estimate_collection（采集估价工具） | run (search_social_content / inspect_social_content / research_social_creator / get_social_trends) / run（search_social_content / inspect_social_content / research_social_creator / get_social_trends） | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Real execution wiring is pending. / 真实执行接线仍待完成。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | start_collection / start_collection（启动采集工具） | run (search_social_content / inspect_social_content / research_social_creator / get_social_trends) / run（search_social_content / inspect_social_content / research_social_creator / get_social_trends） | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Real execution wiring is pending. / 真实执行接线仍待完成。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | get_collection_job / get_collection_job（采集任务读取工具） | task / task | Hide from default discovery; keep explicit calls compatible. / 从默认发现面隐藏；保留显式调用兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy job IDs are not Data Task refs. / 旧 job ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy MCP / 旧 MCP | health / health（健康检查工具） | None / 无 | Keep as support-plane tools. / 作为支持面工具保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Legacy MCP / 旧 MCP | sample_rows / sample_rows（样例行工具） | None / 无 | Keep as support-plane tools. / 作为支持面工具保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Legacy MCP / 旧 MCP | get_pricing / get_pricing（价格工具） | None / 无 | Keep as support-plane tools. / 作为支持面工具保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Legacy MCP / 旧 MCP | get_usage / get_usage（用量工具） | None / 无 | Keep as support-plane tools. / 作为支持面工具保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Legacy MCP / 旧 MCP | connection_status / connection_status（连接检查工具） | None / 无 | Keep as support-plane tools. / 作为支持面工具保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Legacy MCP / 旧 MCP | docs / docs（文档工具） | None / 无 | Keep as support-plane tools. / 作为支持面工具保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Legacy CLI / 旧 CLI | asklear query / asklear query（指标查询命令） | run after Definition acceptance / Definition 验收后使用 run | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted. / 对应 operation Definition 尚未验收。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear query-details / asklear query-details（明细查询命令） | run after Definition acceptance / Definition 验收后使用 run | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted. / 对应 operation Definition 尚未验收。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear search-values / asklear search-values（维值搜索命令） | run after Definition acceptance / Definition 验收后使用 run | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted. / 对应 operation Definition 尚未验收。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear search-products / asklear search-products（商品搜索命令） | run after Definition acceptance / Definition 验收后使用 run | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted. / 对应 operation Definition 尚未验收。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear quote / asklear quote（费用预估命令） | run after Definition acceptance / Definition 验收后使用 run | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted. / 对应 operation Definition 尚未验收。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear run-sql / asklear run-sql（SQL 查询命令） | run after Definition acceptance / Definition 验收后使用 run | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | The exact operation Definition is not yet accepted. / 对应 operation Definition 尚未验收。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear datasets / asklear datasets（数据集列表命令） | discover / discover | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production discovery wiring remains pending. / 生产 discovery 接线仍待完成。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear describe / asklear describe（数据集说明命令） | discover / discover | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production discovery wiring remains pending. / 生产 discovery 接线仍待完成。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear results / asklear results（结果读取命令） | task / task export / task / task export | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear export / asklear export（创建导出命令） | task / task export / task / task export | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear export-status / asklear export-status（导出状态命令） | task / task export / task / task export | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Legacy CLI / 旧 CLI | asklear exports / asklear exports（导出列表命令） | task / task export / task / task export | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy result and export IDs are not Data Task refs. / 旧结果与导出 ID 不是 Data Task ref。 | Role C / 丙 |
| Collection CLI / Collection CLI | asklear collection tasks / asklear collection tasks（采集任务列表命令） | discover / discover | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production publication waits for accepted Definitions. / 生产发布仍等待已验收 Definitions。 | Role C / 丙 |
| Collection CLI / Collection CLI | asklear collection describe / asklear collection describe（采集任务说明命令） | discover / discover | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Production publication waits for accepted Definitions. / 生产发布仍等待已验收 Definitions。 | Role C / 丙 |
| Collection CLI / Collection CLI | asklear collection estimate / asklear collection estimate（采集估价命令） | run (search_social_content / inspect_social_content / research_social_creator / get_social_trends) / run（search_social_content / inspect_social_content / research_social_creator / get_social_trends） | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Real execution wiring is pending. / 真实执行接线仍待完成。 | Role C / 丙 |
| Collection CLI / Collection CLI | asklear collection start / asklear collection start（启动采集命令） | run (search_social_content / inspect_social_content / research_social_creator / get_social_trends) / run（search_social_content / inspect_social_content / research_social_creator / get_social_trends） | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Real execution wiring is pending. / 真实执行接线仍待完成。 | Role C / 丙 |
| Collection CLI / Collection CLI | asklear collection get-job / asklear collection get-job（采集任务读取命令） | task / task | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy job IDs are not Data Task refs. / 旧 job ID 不是 Data Task ref。 | Role C / 丙 |
| Collection CLI / Collection CLI | asklear collection wait / asklear collection wait（采集任务等待命令） | task / task | Keep scripts compatible. / 保持脚本兼容。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Legacy job IDs are not Data Task refs. / 旧 job ID 不是 Data Task ref。 | Role C / 丙 |
| CLI support / CLI 支持面 | asklear login / asklear login（登录命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear logout / asklear logout（退出命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear auth status / asklear auth status（认证状态命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear health / asklear health（健康检查命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear connection-status / asklear connection-status（连接检查命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear docs / asklear docs（文档命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear sample / asklear sample（样例行命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear pricing / asklear pricing（价格命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| CLI support / CLI 支持面 | asklear usage / asklear usage（用量命令） | None / 无 | Keep as support-plane commands. / 作为支持面命令保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Support-plane actions are not business Data Tasks. / 支持面动作不是业务 Data Task。 | Platform owners / 平台负责人 |
| Browser CLI / Browser CLI | asklear browser navigate / asklear browser navigate（浏览器导航命令） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser CLI / Browser CLI | asklear browser observe / asklear browser observe（浏览器观察命令） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser CLI / Browser CLI | asklear browser extract / asklear browser extract（浏览器提取命令） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser CLI / Browser CLI | asklear browser scroll / asklear browser scroll（浏览器滚动命令） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser CLI / Browser CLI | asklear browser click / asklear browser click（浏览器点击命令） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser CLI / Browser CLI | asklear browser fill / asklear browser fill（浏览器填写命令） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser MCP / Browser MCP | navigate / navigate（浏览器导航工具） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser MCP / Browser MCP | observe / observe（浏览器观察工具） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser MCP / Browser MCP | scroll / scroll（浏览器滚动工具） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser MCP / Browser MCP | click / click（浏览器点击工具） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser MCP / Browser MCP | fill / fill（浏览器填写工具） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |
| Browser MCP / Browser MCP | extract / extract（浏览器提取工具） | None / 无 | Keep as an independent local-browser surface. / 作为独立本地浏览器能力保留。 | No fixed date; separate deprecation notice required. / 暂无固定日期；下线需另行公告。 | Browser interaction is not a Data Task. / 浏览器交互不属于 Data Task。 | Browser capability owner / 浏览器能力负责人 |