文档中心

数据智能体 DataAgent（私有化）

A2A

获取任务快照

A2A 获取任务快照 getTask

请求说明

用于获取指定任务的当前快照（snapshot）。JSON-RPC result.task，包含任务 ID、会话 ID、当前状态、元信息以及已落盘产物。

项目	内容
请求方式	`POST`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/a2a/`
`method`	`GetTask`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`
内容类型	`Content-Type: application/json`

请求参数

原文未提供单独参数表。以下为根据请求说明与示例整理的 JSON-RPC 2.0 请求结构参数。

顶层参数（JSON-RPC）

参数名	类型	是否必填	说明
`jsonrpc`	string	是	固定为 `"2.0"`
`id`	string	number	是
`method`	string	是	固定为 `"GetTask"`
`params`	object	是	业务参数对象，见下表

params 参数

taskId、id、task.id 为任务 ID（三选一），可从发起流式问答 SSE 返回结果中获取。

参数名	类型	是否必填	说明
`id`	string	否（三选一）	任务 ID（与 `taskId`、`task.id` 三选一）
`taskId`	string	否（三选一）	任务 ID（与 `id`、`task.id` 三选一）
`task.id`	string	否（三选一）	任务 ID（与 `id`、`taskId` 三选一）
`contextId`	string	否	会话/上下文 ID。传入时会额外校验任务与会话归属关系

请求示例

标准 Curl 示例：

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/a2a/" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data-raw '{"jsonrpc":"2.0","id":3,"method":"GetTask","params":{"id":"7103"}}' \
  --silent | jq

返回参数

顶层字段

字段路径	类型	示例值	说明
`jsonrpc`	string	`2.0`	JSON-RPC 协议版本。
`id`	integer	`3`	请求 ID，与请求体中的 `id` 对应。
`result`	object		请求成功后的业务结果。
`result.task`	object		查询到的 A2A 任务详情。

result.task 字段

字段路径	类型	示例值	说明
`result.task.id`	string	`7103`	A2A Task ID。
`result.task.contextId`	integer	`6620`	任务所属会话 ID。
`result.task.status`	object		任务状态对象。
`result.task.status.state`	string	`TASK_STATE_COMPLETED`	任务状态。示例表示任务已完成。
`result.task.metadata`	object		任务扩展元信息。
`result.task.artifacts`	array		任务产物列表，包含步骤产物、工具结果或最终产物等。

result.task.metadata 字段

字段路径	类型	示例值	说明
`result.task.metadata.version`	string	`v5`	AIDA A2A 扩展版本。
`result.task.metadata.sequence`	integer	`1`	当前任务对象的序号。
`result.task.metadata.phase`	string	`completed`	任务阶段。示例表示已完成。
`result.task.metadata.planStatus`	string	`success`	计划执行状态。示例表示成功。
`result.task.metadata.agentId`	integer	`279`	执行该任务的 Agent ID。
`result.task.metadata.deepResearchTaskId`	integer	`7103`	对应的 DeepResearch 任务 ID。
`result.task.metadata.createTime`	integer	`1786507551000`	任务创建时间戳，单位毫秒。
`result.task.metadata.timing`	object		任务耗时信息。

result.task.metadata.timing 字段

字段路径	类型	示例值	说明
`result.task.metadata.timing.createTime`	integer	`1786507551000`	任务创建时间戳（毫秒）。
`result.task.metadata.timing.startTime`	integer	`1786507551678`	任务开始执行时间戳（毫秒）。
`result.task.metadata.timing.endTime`	integer	`1786507608679`	任务结束时间戳（毫秒）。
`result.task.metadata.timing.durationMs`	integer	`57679`	任务执行耗时（毫秒）。

result.task.artifacts[] 字段

字段路径	类型	示例值	说明
`result.task.artifacts[].artifactId`	string	`step-710301`	产物 ID。示例表示该产物来自步骤 `710301`。
`result.task.artifacts[].metadata`	object		产物扩展元信息。
`result.task.artifacts[].parts`	array		产物内容片段列表。
`result.task.artifacts[].name`	string	`查找销售额相关的数据集、报表、指标定义及数据入口`	产物名称，通常对应步骤标题。
`result.task.artifacts[].description`	string	`任务已完成：【默认搜索工具】销售额、销售额趋势报表、销售额数据集、销售额指标口径`	产物描述，通常用于说明步骤执行结果。

result.task.artifacts[].metadata 字段

字段路径	类型	示例值	说明
`result.task.artifacts[].metadata.version`	string	`v5`	AIDA A2A 扩展版本。
`result.task.artifacts[].metadata.sequence`	integer	`5`	当前产物事件序号。
`result.task.artifacts[].metadata.phase`	string	`running`	产物生成时任务所处阶段。
`result.task.artifacts[].metadata.planStatus`	string	`running`	产物生成时计划状态。
`result.task.artifacts[].metadata.kind`	string	`step`	产物类型。示例表示步骤产物。
`result.task.artifacts[].metadata.stepAction`	string	`step_changed`	步骤动作。示例表示步骤发生更新。
`result.task.artifacts[].metadata.stepType`	string	`use_ai_search_tool`	步骤类型。示例表示使用 AI 搜索工具。
`result.task.artifacts[].metadata.stepId`	integer	`710301`	步骤 ID。
`result.task.artifacts[].metadata.parentStepId`	integer	`0`	父步骤 ID。`0` 表示无父步骤。
`result.task.artifacts[].metadata.stepStatus`	integer	`1`	步骤状态。
`result.task.artifacts[].metadata.displayProcess`	boolean	`true`	是否展示执行过程。
`result.task.artifacts[].metadata.llmMessageIndex`	integer	`1`	LLM 消息索引。
`result.task.artifacts[].metadata.type`	string	`deep_research_running_step`	兼容旧前端的事件类型。
`result.task.artifacts[].metadata.status`	integer	`1`	兼容旧前端的状态值。
`result.task.artifacts[].metadata.assets`	array		步骤关联资产列表。
`result.task.artifacts[].metadata.timing`	object		当前步骤或工具调用耗时信息。
`result.task.artifacts[].metadata.displayTitleWithDescription`	boolean	`false`	是否将标题和描述组合展示。

result.task.artifacts[].metadata.timing 字段

字段路径	类型	示例值	说明
`result.task.artifacts[].metadata.timing.toolName`	string	`unified_internal_search`	工具名称。
`result.task.artifacts[].metadata.timing.startTime`	integer	`1786507556246`	工具开始执行时间戳（毫秒）。
`result.task.artifacts[].metadata.timing.endTime`	integer	`1786507556840`	工具结束执行时间戳（毫秒）。
`result.task.artifacts[].metadata.timing.durationMs`	integer	`594`	工具执行耗时（毫秒）。

result.task.artifacts[].metadata.assets[] 字段

字段路径	类型	示例值	说明
`result.task.artifacts[].metadata.assets[].type`	string	`knowledge`	资产类型。示例表示知识库/知识资产。
`result.task.artifacts[].metadata.assets[].createTime`	integer	`1786507556829`	资产生成或检索时间戳（毫秒）。
`result.task.artifacts[].metadata.assets[].title`	string	`电商平台销售数据_测试(1).xlsx`	资产标题。
`result.task.artifacts[].metadata.assets[].version`	string	null	`null`
`result.task.artifacts[].metadata.assets[].contentType`	string	null	`null`
`result.task.artifacts[].metadata.assets[].content`	string	`电商平台销售数据_测试(1).xlsx_Sheet1... (truncated)`	资产内容摘要（示例中内容已截断）。
`result.task.artifacts[].metadata.assets[].result`	object	null	`null`
`result.task.artifacts[].metadata.assets[].url`	string	`https://[DOMAIN_REDACTED]/...`	资产访问地址（示例中域名已脱敏）。
`result.task.artifacts[].metadata.assets[].iconUrl`	string	null	`null`
`result.task.artifacts[].metadata.assets[].keywords`	array	null	`null`

result.task.artifacts[].parts[] 字段

字段路径	类型	示例值	说明
`result.task.artifacts[].parts[].text`	string	`""`	文本片段内容。示例为空字符串。
`result.task.artifacts[].parts[].data`	object		JSON 数据片段。示例中用于承载检索到的知识资产信息。
`result.task.artifacts[].parts[].mediaType`	string	`text/plain` / `application/json`	内容片段媒体类型。

result.task.artifacts[].parts[].data 字段

字段路径	类型	示例值	说明
`result.task.artifacts[].parts[].data.type`	string	`knowledge`	数据类型。示例表示知识资产。
`result.task.artifacts[].parts[].data.createTime`	integer	`1786507556829`	数据生成或检索时间戳（毫秒）。
`result.task.artifacts[].parts[].data.title`	string	`电商平台销售数据_测试(1).xlsx`	数据标题。
`result.task.artifacts[].parts[].data.version`	string	null	`null`
`result.task.artifacts[].parts[].data.contentType`	string	null	`null`
`result.task.artifacts[].parts[].data.content`	string	`电商平台销售数据_测试(1).xlsx_Sheet1... (truncated)`	数据内容摘要（示例中内容已截断）。
`result.task.artifacts[].parts[].data.result`	object	null	`null`
`result.task.artifacts[].parts[].data.url`	string	`https://[DOMAIN_REDACTED]/...`	数据资源访问地址（示例中域名已脱敏）。
`result.task.artifacts[].parts[].data.iconUrl`	string	null	`null`
`result.task.artifacts[].parts[].data.keywords`	array	null	`null`

结构说明

项目	说明
`result.task.status.state = TASK_STATE_COMPLETED`	表示任务已经完成。
`result.task.metadata.phase = completed`	表示任务整体阶段已完成。
`result.task.metadata.planStatus = success`	表示任务计划执行成功。
`result.task.artifacts`	任务历史产物集合。示例中返回的是一个搜索步骤产物。
`artifact.metadata.stepType = use_ai_search_tool`	表示该步骤使用了 AI 搜索工具。
`artifact.metadata.assets`	该步骤检索到的资产列表。
`artifact.parts`	同一个产物的内容片段。示例中包含一个空文本片段和一个 JSON 数据片段。

返回示例

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "task": {
      "id": "7103",
      "contextId": 6620,
      "status": {
        "state": "TASK_STATE_COMPLETED"
      },
      "metadata": {
        "version": "v5",
        "sequence": 1,
        "phase": "completed",
        "planStatus": "success",
        "agentId": 279,
        "deepResearchTaskId": 7103,
        "createTime": 1786507551000,
        "timing": {
          "createTime": 1786507551000,
          "startTime": 1786507551678,
          "endTime": 1786507608679,
          "durationMs": 57679
        }
      },
      "artifacts": [
        {
          "artifactId": "step-710301",
          "metadata": {
            "version": "v5",
            "sequence": 5,
            "phase": "running",
            "planStatus": "running",
            "kind": "step",
            "stepAction": "step_changed",
            "stepType": "use_ai_search_tool",
            "stepId": 710301,
            "parentStepId": 0,
            "stepStatus": 1,
            "displayProcess": true,
            "llmMessageIndex": 1,
            "type": "deep_research_running_step",
            "status": 1,
            "assets": [
              {
                "type": "knowledge",
                "createTime": 1786507556829,
                "title": "电商平台销售数据_测试(1).xlsx",
                "version": null,
                "contentType": null,
                "content": "电商平台销售数据_测试(1).xlsx_Sheet1... (truncated)",
                "result": null,
                "url": "https://[DOMAIN_REDACTED]/minio.cdp.rag/rag-1/1/电商平台销售数据_测试_1.xlsx",
                "iconUrl": null,
                "keywords": null
              }
            ],
            "timing": {
              "toolName": "unified_internal_search",
              "startTime": 1786507556246,
              "endTime": 1786507556840,
              "durationMs": 594
            },
            "displayTitleWithDescription": false
          },
          "parts": [
            {
              "text": "",
              "mediaType": "text/plain"
            },
            {
              "data": {
                "type": "knowledge",
                "createTime": 1786507556829,
                "title": "电商平台销售数据_测试(1).xlsx",
                "version": null,
                "contentType": null,
                "content": "电商平台销售数据_测试(1).xlsx_Sheet1... (truncated)",
                "result": null,
                "url": "https://[DOMAIN_REDACTED]/minio.cdp.rag/rag-1/1/电商平台销售数据_测试_1.xlsx",
                "iconUrl": null,
                "keywords": null
              },
              "mediaType": "application/json"
            }
          ],
          "name": "查找销售额相关的数据集、报表、指标定义及数据入口",
          "description": "任务已完成：【默认搜索工具】销售额、销售额趋势报表、销售额数据集、销售额指标口径"
        }
      ]
    }
  }
}

最近更新时间：2026.09.04 10:25:42

这个页面对您有帮助吗？

有用

无用