获取会话历史

GET

/agent/conversation-history

返回指定会话的聊天历史。
服务会先校验归属关系，再优先读取 Redis，必要时回退到 MySQL。
reasoning_content 现已支持在缓存命中和数据库历史两种场景下返回（若可用）。
reasoning_duration_seconds 由服务端计算，并以秒为单位持久化。
重试分组通过 retry_group_id、retry_index 和 retry_total 返回。

请求参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://test-cn.your-api-server.com/agent/conversation-history?conversation_id=undefined' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxLCJ0b2tlbl90eXBlIjoiYWNjZXNzX3Rva2VuIiwianRpIjoiZjhhMzhhMzUtOGMyMS00MjgxLWE3MmQtM2JjMDNhMzJjMzIzIiwiZXhwIjoxNzc1MjEzODY5LCJpYXQiOjE3NzQ2MDkwNjl9.4qPEtWnHvVet0iemNJF6g32WvoVi_9T5dVlCCB-npJQ'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "status": "10000",
    "info": "成功",
    "data": [
        {
            "id": 101,
            "role": "user",
            "content": "帮我看看明天最重要的任务是什么。",
            "created_at": "2026-03-24T22:15:01+08:00",
            "reasoning_content": "",
            "reasoning_duration_seconds": 0,
            "retry_group_id": "retry-group-001",
            "retry_index": 1,
            "retry_total": 2
        },
        {
            "id": 102,
            "role": "assistant",
            "content": "明天你应该优先处理数据库联调和接口校验。",
            "created_at": "2026-03-24T22:15:06+08:00",
            "reasoning_content": "阶段：request.accepted\n用户请求已接收。\n\n阶段：task_query.reflecting\n正在对比检索到的任务并选择截止时间最紧的事项。",
            "reasoning_duration_seconds": 5,
            "retry_group_id": "retry-group-001",
            "retry_index": 2,
            "retry_total": 2
        }
    ]
}

🟠400

🟠401

修改于 2026-03-27 12:04:12

获取会话列表

获取上下文窗口 token 分布统计