1. 接口描述
接口请求域名： dataagent.tencentcloudapi.com 。
查询用户会话详情
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：QueryUserSessionDetail。 |
| Version | 是 | String | 公共参数，本接口取值：2025-05-13。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| SessionId | 否 | String | 会话id 示例值：67e0bdc1-c148-45c7-8ec5-9c8908b83932 |
| Limit | 否 | Integer | 分页参数 示例值：50 |
| Offset | 否 | Integer | 偏移量 示例值：0 |
| InstanceId | 否 | String | 实例id 示例值：dataagent-haBKQxLt |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| SubAccountUin | String | 用户 Id 示例值：600000563247 |
| SessionId | String | 会话id 示例值：67e0bdc1-c148-45c7-8ec5-9c8908b83932 |
| RecordList | Array of RecordList | 会话详情数组 |
| TotalCount | Integer | 记录总数 示例值：1 |
| RunRecord | String | 运行中的聊天请求, 返回为json字符串 示例值：{"SessionId": "","Context": "{"KnowledgeBases":[{"KnowledgeBaseId":"klbase-TX1cUnuOLa","FileIds":[],"SelectAllFiles":true,"DbTables":[]}],"SceneId":"","Version":"2.0.1","DataSourceInfo":{}}", "OldRecordId": "", "RecordId": ""} |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 接口已通
输入示例
POST / HTTP/1.1
Host: dataagent.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: QueryUserSessionDetail
<公共请求参数>
{
"SessionId": "67e0bdc1-c148-45c7-8ec5-9c8908b83932",
"Limit": 50,
"Offset": 0,
"InstanceId": "dataagent-haBKQxLt"
}输出示例
{
"Response": {
"RecordList": [
{
"Answer": "接口已通",
"Context": "",
"CreateTime": "2026-07-01 00:00:00",
"ErrorContext": "",
"Feedback": 0,
"Question": "这是一条假数据，用于验证接口连通性",
"RecordId": "fake-record-001",
"SessionId": "67e0bdc1-c148-45c7-8ec5-9c8908b83932",
"TraceId": "",
"UpdateTime": "2026-07-01 00:00:00"
}
],
"RunRecord": "{\"SessionId\": \"*************************d*************\"*********************e************\"* \"******************************e*******\"****************************************e************\\\"***********************************************i********************************************************\"**\"**************SourceInfo\\\":{}}\", \"OldRecordId\": \"\", \"RecordId\": \"************************************\"}",
"SessionId": "67e0bdc1-c148-45c7-8ec5-9c8908b83932",
"SubAccountUin": "600000563247",
"TotalCount": 1,
"RequestId": "5e19effb-3897-45d7-ae73-5f2b845687db"
}
}示例2 测试
输入示例
POST / HTTP/1.1
Host: dataagent.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: QueryUserSessionDetail
<公共请求参数>
{
"SessionId": "5a905d26-a24d-47cc-a5e4-00f2d27155da",
"Limit": 1,
"Offset": 0,
"InstanceId": "dataagent-G5XTaxnz"
}输出示例
{
"Response": {
"RecordList": [
{
"Answer": "[{\"kind\": \"run.started\", \"name\": \"\", \"status\": \"\", \"payload\": {\"question\": \"展示数据\"}, \"durationMs\": null}, {\"kind\": \"reasoning.delta\", \"name\": \"\", \"status\": \"\", \"payload\": {\"content\": \"我理解你想要查看数据，但目前会话中没有配置数据源，也没有上传任何数据文件。\\n\\n要展示数据，我需要有数据来源。你可以：\\n\\n1. **上传数据文件** - 比如 CSV、Excel 等格式的文件\\n2. **连接数据源** - 配置数据库或业务系统连接\\n3. **使用示例数据** - 我可以基于公开数据集或模拟数据为你做演示\\n\\n如果你有具体的数据分析需求，可以告诉我：\\n- 你想分析什么类型的数据？（销售、用户、产品等）\\n- 需要展示什么样的数据？（表格、图表、统计指标等）\\n- 是否需要生成报告？\\n\\n这样我可以为你创建一个演示示例来展示数据分析能力。\", \"role\": \"assistant\"}, \"durationMs\": 3423}, {\"kind\": \"run.finished\", \"name\": \"\", \"status\": \"completed\", \"payload\": {\"status\": \"completed\"}, \"durationMs\": null}]",
"Context": "{\"KnowledgeBases\":[{\"KnowledgeBaseId\":\"klbase-TX1cUnuOLa\",\"FileIds\":[],\"SelectAllFiles\":true,\"DbTables\":[]}],\"SceneId\":\"\",\"Version\":\"2.0.1\",\"DataSourceInfo\":{}}",
"CreateTime": "2026-07-15T11:02:25.510933+00:00",
"ErrorContext": "",
"Feedback": 0,
"Model": "deepseek-v3.2",
"Question": "展示数据",
"RecordId": "5ad4a73d-15a8-432c-b47b-4d32ebf7ea75",
"SessionId": "5a905d26-a24d-47cc-a5e4-00f2d27155da",
"TraceId": "a39eb1fe-a1de-4a80-9dad-9144e85d61e7",
"UpdateTime": "2026-07-15T11:02:31.262006+00:00"
}
],
"RunRecord": "",
"SessionId": "5a905d26-a24d-47cc-a5e4-00f2d27155da",
"SubAccountUin": "100047911039",
"TotalCount": 4,
"RequestId": "2b22a90c-2a72-498a-9552-ab97990d6819"
}
}示例3 示例
输入示例
POST / HTTP/1.1
Host: dataagent.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: QueryUserSessionDetail
<公共请求参数>
{
"SessionId": "5a905d26-a24d-47cc-a5e4-00f2d27155da",
"Limit": 100,
"Offset": 9,
"InstanceId": "dataagent-G5XTaxnz"
}输出示例
{
"Response": {
"RecordList": [
{
"Answer": "[{\"kind\": \"run.started\", \"name\": \"\", \"status\": \"\", \"payload\": {\"question\": \"你好\"}, \"durationMs\": null}, {\"kind\": \"reasoning.delta\", \"name\": \"\", \"status\": \"\", \"payload\": {\"content\": \"你好！我是 Intellix 数据智能助手，可以帮你进行数据分析、知识检索、图表生成和报告制作等任务。\\n\\n不过我看到当前会话没有配置任何数据源，这意味着我无法直接查询数据库或业务系统。但我仍然可以帮你处理以下类型的工作：\\n\\n1. **知识库检索** - 如果你上传了文档、表格等文件，我可以从中查找信息\\n2. **示例分析和演示** - 使用公开数据集或模拟数据进行数据分析演示\\n3. **报告生成** - 创建 PDF、PPT、Excel、Word 等格式的报告\\n4. **图表制作** - 基于你提供的数据生成可视化图表\\n5. **第三方数据** - 获取股价、天气等公开信息（需要相应技能）\\n\\n请告诉我你想做什么，我会根据你的需求选择合适的方式来帮助你！\", \"role\": \"assistant\"}, \"durationMs\": 4093}, {\"kind\": \"run.finished\", \"name\": \"\", \"status\": \"completed\", \"payload\": {\"status\": \"completed\"}, \"durationMs\": null}]",
"Context": "{\"KnowledgeBases\":[],\"SceneId\":\"\",\"Version\":\"2.0.1\",\"DataSourceInfo\":{}}",
"CreateTime": "2026-07-15T10:01:17.148185+00:00",
"ErrorContext": "Internal error.",
"Feedback": 0,
"Model": "deepseek-v3.2",
"Question": "你好",
"RecordId": "699908ba-f047-49c1-a8e7-c703189ea1e9",
"SessionId": "5a905d26-a24d-47cc-a5e4-00f2d27155da",
"TraceId": "14d16231-2f89-4be1-8e3a-cacae175e80c",
"UpdateTime": "2026-07-15T10:01:23.509533+00:00"
}
],
"RunRecord": "",
"SessionId": "5a905d26-a24d-47cc-a5e4-00f2d27155da",
"SubAccountUin": "100047911039",
"TotalCount": 10,
"RequestId": "3a79ba02-ec0d-4059-9475-71c92a0658d2"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameter.Invalid | 自定义错误码 |
| InvalidParameterCombination | 无效参数组合 |
| InvalidParameterValue | 参数取值错误。 |
| MissingParameter | 缺少参数错误。 |
| ResourceNotFound | 资源不存在。 |
| UnauthorizedOperation | 未授权操作。 |
| UnknownParameter | 未知参数错误。 |
| UnsupportedOperation | 操作不支持。 |
