文档中心

数据智能体

会话管理

IDA-获取会话历史/隐藏指定任务

请求说明

项目	内容
请求方式	`GET` / `POST`：获取会话历史快照；`DELETE`：隐藏指定历史任务
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/a2a/sessionHistory`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`
兼容鉴权	支持 `x-token` 和 JWT Token

该接口按会话维度分页获取历史任务列表，适用于页面恢复与回溯完整问答轨迹。每个任务以标准 A2A Task 结构返回，可通过 includeEvents 控制是否携带任务输入、事件流明细与概要标记。
GET 与 POST 的查询参数相同：GET 使用 Query 参数，POST 使用 JSON Body。DELETE 用于隐藏指定历史任务；如果任务仍在运行，服务端会先尝试取消任务再隐藏。

请求参数

参数名	类型	必填	适用方法	说明
`sessionId`	string / int	是	GET / POST / DELETE	会话 ID；仅允许访问归属当前用户的会话
`offset`	int	否	GET / POST	偏移量，默认 `0`；可用 `pageToken` 代替，二者同时传入时 `pageToken` 优先
`pageSize`	int	否	GET / POST	每页条数，默认 `20`，范围 `1～100`；也可使用 `limit`
`includeEvents`	bool	否	GET / POST	是否返回任务事件流明细 `events` 和输入 `input`，默认 `true`
`taskId`	string / int	是	DELETE	要隐藏的历史任务 ID

请求示例

GET 获取会话历史快照：

curl -X GET \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/a2a/sessionHistory?sessionId=14541&offset=0&pageSize=20&includeEvents=true" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H 'Content-Type: application/json' \
  --silent | jq

POST 获取会话历史快照：

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/a2a/sessionHistory" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-raw '{"sessionId":14541,"offset":0,"pageSize":20,"includeEvents":true}' \
  --silent | jq

DELETE 隐藏指定历史任务：

curl -X DELETE \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/a2a/sessionHistory" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-raw '{"sessionId":2481,"taskId":"661"}' \
  --silent | jq

返回参数

顶层返回字段

字段路径	类型	说明
`session`	object	会话元信息。
`tasks`	array	会话历史任务列表，按时间线分页返回。
`nextPageToken`	string	下一页游标；仅当还有更多数据时返回。

session 字段

字段路径	类型	说明
`session.contextId`	integer	对外暴露的会话 ID。
`session.name`	string	会话名称。
`session.data_set_id`	integer	null
`session.create_time`	string	会话创建时间。
`session.last_active_time`	string	会话最后活跃时间。
`session.is_expired`	boolean	会话是否已过期。
`session.restrict_mode`	integer	会话限制模式。
`session.session_type`	string	会话类型，例如 `deep_research`。
`session.latest_task_status`	string	null
`session.is_mixed`	boolean	是否为混合会话。
`session.mcp_servers`	array	会话关联的 MCP Server 列表。
`session.version`	string	会话上下文版本，例如 `v5`。
`session.customTag`	array	会话自定义标签。
`session.is_knowledge_qa`	boolean	是否为知识问答会话。
`session.scene`	string	会话场景，例如 `data_set`。
`session.report_id`	integer	null
`session.query_history_id`	integer	null
`session.storage_id`	string	null
`session.origin_report_storage_id`	string	null
`session.origin_data_preview_mode`	string	null
`session.related_query_id`	integer	null
`session.related_query_question`	string	null
`session.related_query_data_set_id`	integer	null
`session.related_query_data_set_id_list`	array	null
`session.x_page_url`	string	null
`session.is_backend_created`	boolean	是否由后端创建。
`session.submitted_via_internal_a2a`	boolean	是否通过内部 A2A 提交。
`session.server_time`	string	服务端当前时间。
`session.file_list`	array	会话上传文件列表。
`session.generalAgentInfo`	object	通用 Agent 扩展信息。
`session.linkEmbed`	array	会话关联链接资源。
`session.extraInfo`	object	会话扩展信息。

tasks 字段

字段路径	类型	说明
`tasks[].task`	object	A2A Task 投影信息。
`tasks[].input`	object	该任务对应的输入消息。
`tasks[].events`	array	任务历史事件；当 `includeEvents=false` 时不返回或为空。
`tasks[].summary`	object	任务摘要标记。

tasks[].task 字段

字段路径	类型	说明
`tasks[].task.id`	string	A2A Task ID，通常对应 DeepResearch task ID。
`tasks[].task.contextId`	integer	会话 ID。
`tasks[].task.status`	object	Task 状态对象。
`tasks[].task.status.state`	string	A2A 任务状态，例如 `TASK_STATE_COMPLETED`。
`tasks[].task.metadata`	object	任务扩展元信息。
`tasks[].task.metadata.version`	string	AIDA A2A 扩展版本，例如 `v5`。
`tasks[].task.metadata.sequence`	integer	序号。
`tasks[].task.metadata.phase`	string	任务阶段，例如 `running`、`completed`、`failed`、`canceled`。
`tasks[].task.metadata.planStatus`	string	计划状态，例如 `running`、`success`、`failed`、`canceled`。
`tasks[].task.metadata.agentId`	integer	Agent ID。
`tasks[].task.metadata.deepResearchTaskId`	integer	DeepResearch 任务 ID。
`tasks[].task.metadata.messageId`	integer	Agent 回复消息 ID。
`tasks[].task.metadata.relativeMessageId`	integer	用户输入消息 ID。
`tasks[].task.metadata.createTime`	integer	任务创建时间戳（毫秒）。
`tasks[].task.metadata.timing`	object	任务耗时信息。
`tasks[].task.metadata.timing.createTime`	integer	创建时间戳（毫秒）。
`tasks[].task.metadata.timing.startTime`	integer	开始时间戳（毫秒）。
`tasks[].task.metadata.timing.endTime`	integer	结束时间戳（毫秒）。
`tasks[].task.metadata.timing.durationMs`	integer	任务耗时（毫秒）。

tasks[].input.message 字段

字段路径	类型	说明
`tasks[].input.message.role`	string	输入消息角色；用户输入通常为 `ROLE_USER`。
`tasks[].input.message.parts`	array	消息内容片段。
`tasks[].input.message.parts[].text`	string	文本内容。
`tasks[].input.message.messageId`	string	输入消息 ID。
`tasks[].input.message.metadata`	object	原始消息元数据。
`tasks[].input.message.metadata.content.content.config`	object	输入消息配置。
`tasks[].input.message.metadata.content.content.config.source`	string	请求来源，例如 `normal_chat`。
`tasks[].input.message.metadata.content.content.config.deepResearch`	boolean	是否开启DeepResearch。
`tasks[].input.message.metadata.content.content.config.enableKnowledgeQA`	boolean	是否开启知识问答。
`tasks[].input.message.metadata.content.content.config.enableWebSearch`	boolean	是否开启 Web 搜索。
`tasks[].input.message.metadata.content.content.config.enableAeolusAssetSearch`	boolean	是否开启 Aeolus 资产搜索。
`tasks[].input.message.metadata.content.content.config.enableSkills`	array	启用的技能列表。
`tasks[].input.message.metadata.content.content.config.extraInfo`	object	输入扩展信息。
`tasks[].input.message.metadata.content.content.config.generalAgentInfo`	object	输入携带的通用 Agent 上下文。
`tasks[].input.message.metadata.content.content.config.content`	string	用户输入内容。

tasks[].events 字段

字段路径	类型	说明
`tasks[].events[].artifactUpdate`	object	产物更新事件，常用于步骤、过程、阶段性内容。
`tasks[].events[].message`	object	消息事件，常用于最终回复。
`tasks[].events[].statusUpdate`	object	任务状态更新事件，常用于终态。

artifactUpdate 字段

字段路径	类型	说明
`artifactUpdate.taskId`	string	关联任务 ID。
`artifactUpdate.contextId`	integer	会话 ID。
`artifactUpdate.artifact`	object	产物对象。
`artifactUpdate.append`	boolean	是否追加到已有产物。
`artifactUpdate.lastChunk`	boolean	是否为该产物的最后一个分片。
`artifactUpdate.artifact.artifactId`	string	产物 ID。
`artifactUpdate.artifact.name`	string	产物名称。
`artifactUpdate.artifact.description`	string	产物描述。
`artifactUpdate.artifact.parts`	array	产物内容片段。
`artifactUpdate.artifact.parts[].text`	string	产物文本。
`artifactUpdate.artifact.parts[].mediaType`	string	产物媒体类型，例如 `text/plain`。
`artifactUpdate.artifact.metadata`	object	产物扩展元信息。
`artifactUpdate.artifact.metadata.kind`	string	元信息类型，例如 `step`。
`artifactUpdate.artifact.metadata.stepAction`	string	步骤动作，例如 `add_step`。
`artifactUpdate.artifact.metadata.stepType`	string	步骤类型，例如 `executor_think`。
`artifactUpdate.artifact.metadata.stepId`	integer	步骤 ID。
`artifactUpdate.artifact.metadata.parentStepId`	integer	父步骤 ID。
`artifactUpdate.artifact.metadata.stepStatus`	integer	步骤状态。
`artifactUpdate.artifact.metadata.displayProcess`	boolean	是否展示过程。
`artifactUpdate.artifact.metadata.assets`	array	步骤关联资产。

message 事件字段

字段路径	类型	说明
`message.taskId`	string	关联任务 ID。
`message.contextId`	integer	会话 ID。
`message.role`	string	消息角色；Agent 回复为 `ROLE_AGENT`。
`message.parts`	array	消息内容片段。
`message.parts[].text`	string	回复文本。
`message.parts[].mediaType`	string	媒体类型，例如 `text/plain`。
`message.messageId`	string	消息 ID。
`message.metadata`	object	消息扩展元信息。
`message.metadata.sequence`	integer	事件序号。
`message.metadata.planStatus`	string	计划状态，例如 `success`。
`message.metadata.conversationType`	string	对话类型，例如 `research`。
`message.metadata.kind`	string	消息类型，例如 `report`。
`message.metadata.reportKind`	string	报告类型，例如 `markdown`。
`message.metadata.contentType`	string	内容类型，例如 `markdown`。

statusUpdate 字段

字段路径	类型	说明
`statusUpdate.taskId`	string	关联任务 ID。
`statusUpdate.contextId`	integer	会话 ID。
`statusUpdate.status`	object	任务状态对象。
`statusUpdate.status.state`	string	A2A 任务状态，例如 `TASK_STATE_COMPLETED`。
`statusUpdate.metadata`	object	状态扩展元信息。
`statusUpdate.metadata.sequence`	integer	事件序号。
`statusUpdate.metadata.phase`	string	任务阶段，例如 `completed`。
`statusUpdate.metadata.planStatus`	string	计划状态，例如 `success`。
`statusUpdate.metadata.plan_status`	string	兼容 snake_case 的计划状态字段。
`statusUpdate.metadata.timing`	object	任务耗时信息。
`statusUpdate.metadata.messageId`	integer	Agent 回复消息 ID。
`statusUpdate.metadata.relativeMessageId`	integer	用户输入消息 ID。
`statusUpdate.final`	boolean	是否为任务终态事件。

summary 字段

字段路径	类型	说明
`tasks[].summary.hasFinalArtifact`	boolean	是否存在最终产物。
`tasks[].summary.hasFinalMessage`	boolean	是否存在最终消息。

历史快照返回示例

{
  "session": {
    "contextId": 14541,
    "name": "OpenAPI 数据问答",
    "data_set_id": null,
    "create_time": "2026-08-12 09:56:09",
    "last_active_time": "2026-08-12 10:55:14",
    "is_expired": false,
    "restrict_mode": 0,
    "session_type": "deep_research",
    "latest_task_status": "completed",
    "is_mixed": true,
    "mcp_servers": [],
    "version": "v5",
    "customTag": [],
    "is_knowledge_qa": false,
    "scene": "data_set",
    "report_id": null,
    "query_history_id": null,
    "storage_id": null,
    "origin_report_storage_id": null,
    "origin_data_preview_mode": null,
    "related_query_id": null,
    "related_query_question": null,
    "related_query_data_set_id": null,
    "x_page_url": null,
    "related_query_data_set_id_list": null,
    "is_backend_created": false,
    "submitted_via_internal_a2a": false,
    "server_time": "2026-08-12 10:55:44",
    "file_list": [],
    "generalAgentInfo": {},
    "linkEmbed": [],
    "extraInfo": {}
  },
  "tasks": [
    {
      "task": {
        "id": "15582",
        "contextId": 14541,
        "status": {
          "state": "TASK_STATE_COMPLETED"
        },
        "metadata": {
          "version": "v5",
          "sequence": 1,
          "phase": "completed",
          "planStatus": "success",
          "agentId": 430,
          "deepResearchTaskId": 15582,
          "messageId": 38105,
          "relativeMessageId": 38104,
          "createTime": 1786503308000,
          "timing": {
            "createTime": 1786503308000,
            "startTime": 1786503308092,
            "endTime": 1786503313725,
            "durationMs": 5725
          }
        }
      },
      "input": {
        "message": {
          "role": "ROLE_USER",
          "parts": [
            {
              "text": "你好"
            }
          ],
          "messageId": "38104",
          "metadata": {
            "content": {
              "content": {
                "config": {
                  "source": "normal_chat",
                  "deepResearch": true,
                  "enableLarkQA": false,
                  "enableWebSearch": true,
                  "enableAeolusAssetSearch": false,
                  "enableKnowledgeQA": true,
                  "enableSkills": [],
                  "linkEmbed": [],
                  "extraInfo": {
                    "template": "你好",
                    "skills": []
                  },
                  "llmModel": false,
                  "enable_report_search": true,
                  "version": 4,
                  "generalAgentInfo": {
                    "fileList": [],
                    "datasetList": [],
                    "larkFileList": [],
                    "reportList": []
                  },
                  "relatedQueryDataSetIdList": [],
                  "enableSlideGeneration": false,
                  "content": "你好"
                }
              }
            }
          }
        }
      },
      "events": [
        {
          "artifactUpdate": {
            "taskId": "15582",
            "artifact": {
              "artifactId": "step-1558201",
              "metadata": {
                "version": "v5",
                "sequence": 1,
                "phase": "running",
                "planStatus": "running",
                "kind": "step",
                "stepAction": "add_step",
                "stepType": "executor_think",
                "stepId": 1558201,
                "parentStepId": 0,
                "stepStatus": 1,
                "displayProcess": true,
                "llmMessageIndex": 0,
                "type": "deep_research_running_step",
                "status": 1,
                "assets": [],
                "messageId": 38105,
                "relativeMessageId": 38104
              },
              "parts": [
                {
                  "text": "",
                  "mediaType": "text/plain"
                }
              ],
              "name": "思考推理",
              "description": "思考推理"
            },
            "append": false,
            "contextId": 14541,
            "lastChunk": true
          }
        },
        {
          "artifactUpdate": {
            "taskId": "15582",
            "artifact": {
              "artifactId": "step-1558202",
              "metadata": {
                "version": "v5",
                "sequence": 2,
                "phase": "running",
                "planStatus": "running",
                "kind": "step",
                "stepAction": "add_step",
                "stepType": "executor_think",
                "stepId": 1558202,
                "parentStepId": 1558201,
                "stepStatus": 1,
                "displayProcess": true,
                "llmMessageIndex": 0,
                "contentType": "text",
                "type": "deep_research_running_step",
                "status": 1,
                "assets": [],
                "messageId": 38105,
                "relativeMessageId": 38104
              },
              "parts": [
                {
                  "text": "你好！我是数据问答助手，很高兴为你服务。\n\n我可以帮你完成以下事情：\n\n- **查询数据**：查找数据集、报表、仪表盘、指标等数据资产\n- **数据分析**：归因分析、异常点分析、趋势洞察等\n- **生成报告**：撰写文档、报告、方案等书面交付物\n- **数据可视化**：将数据渲染成图表\n- **飞书相关**：查询消息、管理群聊、操作云文档等\n\n请告诉我你需要什么帮助，我会尽力为你解答！😊",
                  "mediaType": "text/plain"
                }
              ],
              "name": "思考推理",
              "description": "思考推理完成"
            },
            "append": false,
            "contextId": 14541,
            "lastChunk": true
          }
        },
        {
          "message": {
            "taskId": "15582",
            "role": "ROLE_AGENT",
            "parts": [
              {
                "text": "你好！我是数据问答助手，很高兴为你服务。\n\n我可以帮你完成以下事情：\n\n- **查询数据**：查找数据集、报表、仪表盘、指标等数据资产\n- **数据分析**：归因分析、异常点分析、趋势洞察等\n- **生成报告**：撰写文档、报告、方案等书面交付物\n- **数据可视化**：将数据渲染成图表\n- **飞书相关**：查询消息、管理群聊、操作云文档等\n\n请告诉我你需要什么帮助，我会尽力为你解答！😊",
                "mediaType": "text/plain"
              }
            ],
            "metadata": {
              "version": "v5",
              "sequence": 3,
              "planStatus": "success",
              "conversationType": "research",
              "messageId": 38105,
              "relativeMessageId": 38104,
              "kind": "report",
              "reportKind": "markdown",
              "contentType": "markdown"
            },
            "messageId": "38105",
            "contextId": 14541
          }
        },
        {
          "statusUpdate": {
            "taskId": "15582",
            "status": {
              "state": "TASK_STATE_COMPLETED"
            },
            "metadata": {
              "version": "v5",
              "sequence": 4,
              "phase": "completed",
              "planStatus": "success",
              "plan_status": "success",
              "timing": {
                "createTime": 1786503308000,
                "startTime": 1786503308092,
                "endTime": 1786503313725,
                "durationMs": 5725
              },
              "messageId": 38105,
              "relativeMessageId": 38104
            },
            "contextId": 14541,
            "final": true
          }
        }
      ],
      "summary": {
        "hasFinalArtifact": false,
        "hasFinalMessage": true
      }
    }
  ]
}

隐藏历史任务返回示例

{
  "success": true,
  "sessionId": "2481",
  "taskId": "661",
  "taskCanceled": false
}

最近更新时间：2026.08.17 14:31:58

这个页面对您有帮助吗？

有用

无用

数据智能体

请求说明 #

请求参数 #

请求示例 #

返回参数 #

顶层返回字段 #

session 字段 #

tasks 字段 #

tasks[].task 字段 #

tasks[].input.message 字段 #

tasks[].events 字段 #

artifactUpdate 字段 #

message 事件字段 #

statusUpdate 字段 #

summary 字段 #