API访问域名

请求参数

Header参数

Body参数

请求示例

1{
2  "startDate": "2025-06-09 00:00:00",
3  "endDate": "2025-06-24 23:59:59",
4  "searchType": 3,
5  "sessionIds": [
6    "session_001",
7    "session_002"
8  ],
9  "order": "desc",
10  "channel": [
11    "default",
12    "_sys_web"
13  ],
14  "pn": 1,
15  "ps": 20
16}

响应参数

data子数据

list子数据

小结状态说明

接口返回的 status 取自小结索引中的 summaryStatus 字段；当 summaryStatus 为空时，降级使用索引中的 status 字段。

说明：

1. 当前 OpenAPI 分页查询不按 status 过滤，命中时间、机器人、渠道、用户名称或会话 ID 条件的记录都会返回。
2. 只有 status=SUCCESS 时，接口才会返回 dialogueSummary；其他状态下 dialogueSummary 固定为空字符串。
3. INVALID_JSON 的异常信息会由接口统一转为固定中文提示，其他状态透传索引中的 errorMessage，为空时返回空字符串或空值，取决于序列化配置。

响应示例

1{
2  "code": 200,
3  "msg": "OK",
4  "time": 1710000000000,
5  "data": {
6    "total": 1,
7    "pn": 1,
8    "ps": 20,
9    "totalPn": 1,
10    "list": [
11      {
12        "userId": "user_001",
13        "userName": "张三",
14        "sessionId": "session_001",
15        "status": "SUCCESS",
16        "errorMessage": "",
17        "channel": "default",
18        "startTime": "2025-06-09 10:00:00",
19        "endTime": "2025-06-09 10:05:00",
20        "roundNumber": 5,
21        "conversation": "用户: 投诉。\nAI: 请您描述问题。\n用户: 餐品送来已经没法吃了。",
22        "dialogueSummary": "{\"summary\":\"用户反馈餐品无法食用，机器人已引导用户描述问题。\"}"
23      }
24    ]
25  }
26}

处理规则

1. token 不能为空，且必须能识别到有效机器人；机器人必须存在，且机器人租户 ID 不能为空。
2. startDate 和 endDate 必填，格式必须为 yyyy-MM-dd HH:mm:ss。
3. 查询时间范围不能超过 1 个月。当前实现会直接拒绝超过 1 个月的请求，不会自动调整到最近 1 个月或当前时间。
4. order 仅支持 asc、desc，为空默认按 desc 排序。
5. searchType 仅支持 1 和 3。不传 searchType 时按时间、渠道分页查询。
6. searchType=1 时，keyword 非空才追加用户名匹配条件；为空时不按用户名过滤。
7. searchType=3 时，sessionIds 必填，且单次最多 100 个。
8. channel 非空且不包含 all 时，按渠道列表过滤；为空或包含 all 时不过滤渠道。
9. 查询范围限定在 token 对应机器人的 tenantId 和 agentId 下。
10. 排序字段为本次对话开始时间 startTime；开始时间相同的记录再按小结创建时间 createdTime 排序，两个排序字段使用相同的 order。
11. 当前分页查询不按小结状态过滤；返回记录会包含 status 和 errorMessage。其中 dialogueSummary 仅在 status=SUCCESS 时返回小结 JSON 字符串。
12. 无匹配记录、索引不存在或 ES 查询异常时，返回成功响应和空分页列表。

常见错误码