数据智能体 DataAgent（私有化）
数据智能体 DataAgent（私有化）
- 文档首页
数据智能体 DataAgent（私有化）iDAOpenAPI会话管理IDA-获取会话详情
复制全文
下载 pdf
文档反馈
问问助手获取会话详情（Session Info）
根据 sessionId 获取会话基本信息；可选返回消息列表与（DeepResearch/A2A 场景下的）任务历史。
请求说明
项目 | 内容 |
|---|---|
请求方式 |
|
请求地址 |
|
默认鉴权 |
|
请求参数（Query）
参数名 | 类型 | 必填 | 默认值 | 示例 | 说明 |
|---|---|---|---|---|---|
| integer | 是 | 14468 | 会话 ID。 | |
| boolean | 否 |
|
| 是否返回会话消息列表。 |
| integer | 否 |
| 返回的最大消息条数。仅在 |
说明：如果会话属于 DeepResearch/A2A 类型，响应中可能包含
data.tasks作为任务历史；其他会话类型可能返回空数组。任务仍在执行时，接口会结合最新任务状态更新会话状态（如latestTaskStatus）。
请求示例
标准 Curl 示例：
curl -X GET \ "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/signed/agent/sessionInfo?sessionId=14468&needMsg=true&maxMsgCount=20" \ -H "Authorization: Bearer ${JWT_TOKEN}" \ -H 'Content-Type: application/json' \ --silent | jq
HTTP 示例：
GET https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/signed/agent/sessionInfo?sessionId=8350&needMsg=true&maxMsgCount=20
返回参数
返回参数
参数名 | 类型 | 说明 |
|---|---|---|
| string | 请求结果码，成功为 |
| object | 提示信息，成功时通常为空对象。 |
| object | 业务数据。 |
| array | 会话消息列表； |
| array | 会话关联任务列表（DeepResearch/A2A 会话可能返回）；无任务时为空数组。 |
| object | 会话详情。 |
| integer | 会话 ID。 |
| string | 会话名称。 |
| string | 会话创建人邮箱前缀。 |
| integer | null |
| string | 会话类型，例如 |
| string | 会话场景，例如 |
| string | 会话上下文版本，例如 |
| string | 会话创建时间。 |
| string | 会话最后活跃时间。 |
| string | 服务端当前时间。 |
| boolean | 会话是否已过期。 |
| boolean | 是否为知识问答会话。 |
| boolean | 是否为混合会话。 |
| boolean | 是否由后端创建。 |
| boolean | 是否通过内部 A2A 提交。 |
| integer | 会话限制模式。 |
| string | null |
| array | 会话上传文件列表。 |
| array | 会话关联链接资源。 |
| array | 会话启用的 MCP Server 列表。 |
| array | 会话自定义标签。 |
| object | 会话扩展信息。 |
| object | 通用 Agent 扩展信息。 |
| integer | null |
| string | null |
| integer | null |
| integer | null |
| string | null |
| integer | null |
| array | null |
| string | null |
| string | null |
| string | null |
| object | 会话所属 Agent 信息。 |
| integer | Agent ID。 |
| string | Agent 名称。 |
| string | Agent 描述。 |
| object | null |
| string | Agent 头像标识。 |
| string | Agent 类型，例如 |
| string | Agent 当前模式，例如 |
| string | Agent 创建人邮箱前缀。 |
| string | 权限类型，例如 |
| string | 模型类型标准名称。 |
| boolean | 当前用户是否为 Agent 管理员。 |
| boolean | 是否开启深度研究能力。 |
| boolean | 是否开启深度研究取数链路。 |
| boolean | 是否开启洞察报告能力。 |
| boolean | 是否开启智能问数能力。 |
| boolean | 是否展示知识问答能力。 |
| boolean | 是否开启技能市场。 |
| boolean | 会话内是否允许上传技能。 |
| boolean | 深度研究会话内是否允许上传技能。 |
| boolean | 是否开启内置 PPT 模板选择。 |
| boolean | 是否开启多报告能力。 |
| integer | 多报告数量上限。 |
| boolean | 是否支持知识引擎。 |
| object | 不同模式使用的知识引擎配置。 |
| string | 知识问答使用的知识引擎。 |
| string | 深度研究使用的知识引擎。 |
| object | Agent 配置。 |
| boolean | 是否为新版 Agent 配置。 |
| boolean | 是否开启日期计算开关。 |
| integer | 默认知识库 ID。 |
| integer | 默认知识库租户 ID。 |
| boolean | 默认知识库是否已初始化。 |
| boolean | 是否使用知识引擎知识库。 |
| string | 知识引擎优先级，例如 |
| boolean | 配置层洞察报告开关。 |
| array | 可见 Agent 模式列表。 |
| string | Oncall 入口 URL。 |
| object | 知识问答配置。 |
| object | 知识问答场景配置。 |
| object | 知识问答可用工具配置。 |
| boolean | 是否启用 Python 工具。 |
| boolean | 是否启用 SQL 工具。 |
| boolean | 是否启用 Web 搜索工具。 |
| boolean | 是否启用 Aeolus 报告查询工具。 |
| boolean | 是否启用 Hive 表信息查询工具。 |
| boolean | 是否启用知识库搜索。 |
| boolean | 是否启用 Aeolus 资产搜索。 |
返回示例
{ "JSONIFY_PRETTYPRINT_REGULAR": false, "code": "llm/ok", "data": { "messageList": [], "sessionInfo": { "agentInfo": { "agentMode": "knowledgeQA", "agentType": "Expert", "avatar": "system3", "config": { "dateCalcSw": true, "defaultKnowledgeBaseId": 118, "defaultKnowledgeBaseInitd": true, "defaultKnowledgeTenantId": 8000000000001, "isInsightReportOpen": false, "isNewAgent": true, "knowledgeEnginePriority": "user", "knowledgeQa": { "scene": {}, "tools": { "python": { "enabled": true }, "queryAeolusReport": { "enabled": true }, "queryHiveTableInfo": { "enabled": true }, "search": { "aeolusAsset": { "enabled": false }, "knowledgeBase": { "enabled": true } }, "sql": { "enabled": true }, "webSearch": { "enabled": true } } }, "oncallEntrance": "https://cloud.bytedance.net/oncall/chats/user/index?lang=zh-CN&open_in_browser=true&x-resource-account=public&x-bc-region-id=bytedance&tenantId=28603&step=self-solve", "useKnowledgeEngineKb": true, "visibleAgentModes": [] }, "creatorPrefix": "admin", "deepResearchUploadSkillOnSessionEnable": false, "description": "openApi 测试", "detail": null, "enableMultiReport": false, "id": 430, "isAgentAdmin": true, "isBuiltinPPTTemplateSelectionEnable": false, "isDeepResearchOpen": true, "isDeepResearchQueryOpen": true, "isInsightReportOpen": true, "isKnowledgeQASeen": true, "isSkillMarketPlaceEnable": true, "isSmartQueryOpen": true, "knowledgeEngines": { "deepresearch": "knowledgeBase", "knowledgeQA": "knowledgeBase" }, "modelTypeStandardName": "GPT模型", "multiReportNums": 1, "name": "openApi", "privilegeType": "agent", "supportKnowledgeEngine": true, "uploadSkillOnSessionEnable": true }, "createTime": "2026-08-11 16:41:55", "customTag": [], "dataSetId": null, "emailPrefix": "admin", "extraInfo": {}, "fileList": [], "generalAgentInfo": {}, "id": 14468, "isBackendCreated": false, "isExpired": false, "isKnowledgeQA": false, "isMixed": false, "lastActiveTime": "2026-08-11 16:41:55", "latestTaskStatus": null, "linkEmbed": [], "mcpServers": [], "name": "OpenAPI 数据问答", "originDataPreviewMode": null, "originReportStorageId": null, "queryHistoryId": null, "relatedQueryDataSetId": null, "relatedQueryDataSetIdList": null, "relatedQueryId": null, "relatedQueryQuestion": null, "reportId": null, "restrictMode": 0, "scene": "data_set", "serverTime": "2026-08-12 10:01:27", "sessionType": "normal", "storageId": null, "submittedViaInternalA2a": false, "version": "v5", "xPageUrl": null }, "tasks": [] }, "msg": {} }