任务对象
| 字段 | 类型 | 说明 |
|---|---|---|
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)。
raw_result
Section titled “raw_result”结构化结果沿用 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,仅供对照 |
Reference
Section titled “Reference”| 字段 | 类型 | 说明 |
|---|---|---|
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 的支持情况见解析回答结果。
AgentStep
Section titled “AgentStep”按 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。
MediaCard
Section titled “MediaCard”| 字段 | 类型 | 说明 |
|---|---|---|
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 | 平台给出的说明或点评 |
成功任务的完整示例见查询任务。
