跳转到内容

任务对象

提交任务和查询任务都返回任务对象;任务列表返回它的精简版。

字段 类型 说明
task_id string 任务 ID,形如 task_ 加 UUID
platform string 平台标识(已转为小写)
query string 问题(已去掉首尾空白)
status string queued、dispatching、pending、running、succeeded、failed、canceled,见任务生命周期
answer string 回答正文(Markdown),等于 raw_result.rawContent;没有结果时为空字符串
result_json string 原始结果的 JSON 字符串,结构与 raw_result 相同,可能包含 raw_result 尚未收录的新字段;没有结果时为空字符串
share_link string 平台分享链接,没有为空字符串
error_code string 任务级错误码,见错误处理。不为空不代表失败,以 status 为准
error_message string 错误说明,{"zh","en"} JSON 字符串,解析后按语言展示;不要按文案做程序判断
created_at integer 提交时间(Unix 秒)
updated_at integer 最近更新时间(Unix 秒)
started_at integer 开始执行时间(Unix 秒),0 表示未开始或未记录
finished_at integer 结束时间(Unix 秒),0 表示未结束
monitor_date string 业务日期 YYYY-MM-DD(北京时间),提交时确定
priority integer 提交时的优先级:1 = P1、2 = P2。实际执行档位以 raw_result.priority 为准
country string 请求的出口国家(大写),未指定为空字符串;不代表已验证的实际出口
thinking boolean 提交时请求的思考模式,未请求为 false。实际是否开启以 raw_result.thinking 为准,见思考模式
credits integer succeeded:扣除的点数;未结束:预占的点数;failed / canceled:0
raw_result object 结构化结果,见下文。只在拿到结果后出现(成功,或平台执行失败);排队中、被取消、派发失败的任务没有这个字段

外层字段即使为空也会返回(""、0 或 false)。

结构化结果沿用 protobuf 的 JSON 编码,与外层的约定不同:

  • 字段名为小驼峰(rawContent、shareLink)。
  • 零值字段省略:false、0、空字符串、空数组都不出现,读取时自行补默认值。
  • elapsedMs 是 64 位整数,编码为字符串(如 "48213")。
字段 类型 说明
taskId string 任务 ID
platform string 平台标识
monitorDate string 业务日期 YYYY-MM-DD
query string 实际执行的问题
success boolean 是否拿到回答;为 false 时字段不出现
rawContent string 回答原文(Markdown),平台的引用标记与卡片占位符原样保留
references Reference[] 引用来源,见下文
shareLink string 平台分享链接
error string 失败说明,与 error_message 相同的 {"zh","en"} JSON 字符串;不要按文案做程序判断
elapsedMs string 执行耗时(毫秒),不含排队
completedAt string 完成时间,ISO 8601 UTC,如 2026-10-26T12:41:37.512Z
priority integer 实际执行的档位:1 = P1、2 = P2,对账以此为准
thinking boolean 实际是否开启了思考:true 为开启;没有开启、平台没有思考开关或任务失败时不出现。判断思考模式是否生效以此为准,而不是外层的 thinking
agentSteps AgentStep[] 执行过程(思考、搜索、工具调用),按发生顺序
mediaCards MediaCard[] 回答中的多媒体卡片,按出现顺序
conversationId string 平台侧会话 ID,仅供对照
messageId string 平台侧消息 ID,仅供对照
字段 类型 说明
rank integer 平台展示顺序,从 1 开始
title string 标题
url string 链接;少数来源没有链接或为平台内部 ID,使用前请校验
snippet string 摘要
source string 来源名称(站点名)
domain string 域名
contentPlatform string 识别出的内容平台,识别不出时不出现
cited boolean true 被正文引用,false 搜到但未引用;字段不存在表示平台不区分,不能当作 false
publishTime string 发布时间:ISO 8601、YYYY-MM-DD 或平台给出的相对时间原文(如「1天前」)
author string 作者(笔记作者、视频 UP 主等)

引用来源包含平台搜到或读过的全部来源,被正文引用的排在前面。各平台对 cited 的支持情况见解析回答结果。

按 type 读取对应字段:

字段 类型 适用 type 说明
type string — thinking 思考、search 联网搜索、tool 其他工具调用
content string thinking 思考正文
summary string thinking 思考摘要或平台的过程说明
name string search、tool 平台工具名
queries string[] search 本次搜索使用的检索词
results AgentSearchResult[] search 搜索返回的结果,未必被正文引用
args string tool 调用参数原文

AgentSearchResult:title、url、siteName(站点展示名)、snippet。

字段 类型 说明
type string image、video、product、ranking、other
platformType string 平台原始卡片类型名,仅供对照,取值随平台变化
anchor string 卡片在 rawContent 中的占位符原文;平台不在正文放占位符时不出现
items MediaCardItem[] 卡片中的各项

MediaCardItem:

字段 类型 说明
title string 标题或品名
url string 点击跳转的页面(视频页、商品页、笔记页)
imageUrl string 封面或图片链接,通常带签名、会过期
source string 来源站点、店铺或商城名
author string 作者
duration string 视频时长,平台原文(如 05:03)
price string 价格,平台原文
rating string 评分或推荐度,平台原文
publishTime string 发布时间,口径同 Reference
description string 平台给出的说明或点评

成功任务的完整示例见查询任务。