A2A 获取会话任务列表 listTasks

请求说明

用于查询指定会话（contextId / sessionId）下的任务列表，支持分页。

contextId 或 sessionId 必填（二选一即可）。
pageSize 默认 20，取值范围 1～100；也可使用别名 limit。
分页建议优先使用上次响应返回的 nextPageToken 作为下一次请求的 pageToken；也可直接传 offset 进行翻页。

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

请求参数

顶层参数（JSON-RPC）

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

params 参数

参数名	类型	是否必填	说明
`contextId`	string	否（二选一必填）	会话/上下文 ID（与 `sessionId` 二选一必填）。
`sessionId`	string	否（二选一必填）	会话 ID（与 `contextId` 二选一必填）。
`pageSize`	integer	否	每页条数，默认 `20`，范围 `1～100`。
`limit`	integer	否	`pageSize` 的别名。若与 `pageSize` 同时传入，优先级以实际接口为准（建议只传一个）。
`pageToken`	string	否	翻页标记。建议使用上次响应的 `result.nextPageToken` 作为下一次请求的 `pageToken`。
`nextPageToken`	string	否	仅在响应中返回。存在下一页时返回，用于下一次请求的 `pageToken`。
`offset`	integer	否	可选的偏移翻页方式（不推荐与 `pageToken` 混用）。

请求示例

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":4,"method":"ListTasks","params":{"sessionId":"6620","pageSize":20,"pageToken":"0"}}' \
  --silent | jq

返回参数

顶层字段

字段路径	类型	示例值	说明
`jsonrpc`	string	`2.0`	JSON-RPC 协议版本。
`id`	integer	`4`	请求 ID，与请求体中的 `id` 对应。
`result`	object		请求成功后的业务结果。
`result.tasks`	array		当前会话下的任务列表。
`result.nextPageToken`	string	`20` / `eyJvZmZzZXQiOjIwfQ==`（示例）	下一页游标。仅当存在下一页时返回；用于作为下一次请求的 `params.pageToken`。

result.tasks[] 字段（任务对象）

字段路径	类型	示例值	说明
`result.tasks[]`	object		单个 A2A 任务对象（摘要）。
`result.tasks[].id`	string	`7103` / `7098`	A2A Task ID。
`result.tasks[].contextId`	integer	`6620`	任务所属会话 ID。
`result.tasks[].status`	object		任务状态对象。
`result.tasks[].status.state`	string	`TASK_STATE_COMPLETED`	任务状态。示例表示任务已完成。
`result.tasks[].metadata`	object		任务扩展元信息。

result.tasks[].metadata 字段

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

result.tasks[].metadata.timing 字段

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

返回示例

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "tasks": [
      {
        "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
          }
        }
      }
    ]
  }
}

最近更新时间：2026.09.09 14:51:59

这个页面对您有帮助吗？

有用

无用

数据智能体

A2A 获取会话任务列表 listTasks #

请求说明 #

#

请求参数 #

顶层参数（JSON-RPC）

params 参数

#

请求示例 #

返回参数 #

顶层字段

result.tasks[] 字段（任务对象）

result.tasks[].metadata 字段

result.tasks[].metadata.timing 字段 #

返回示例 #

A2A 获取会话任务列表 listTasks

请求说明

请求参数

请求示例

返回参数

result.tasks[].metadata.timing 字段

返回示例