会话管理

分页查询指定应用下某个用户的会话列表，按更新时间倒序返回。Agent、AgentLite 和 ChatFlow 类型应用支持会话（TextCompletion 无对话上下文）。

• 接口路径：POST /v1/openapi/chat/conversations

INFO

Agent、AgentLite 与 ChatFlow 共用同一接口路径，由 app_id 对应应用的类型分发。

请求头

参数名	必填	说明
Content-Type	是	application/json
Authorization	是	鉴权凭证，格式 Bearer sk_xxx

请求参数

{
    "app_id": "",      // 必填-应用ID
    "user_id": "",     // 用户标识，按业务方用户筛选（可选）
    "page": 1,         // 页码，缺省 1
    "page_size": 10    // 每页条数，缺省 10
}

参数名	类型	必填	说明
app_id	string(uuid)	是	应用 ID
user_id	string	否	业务方用户标识，按用户筛选会话
page	int	否	页码，缺省 1
page_size	int	否	每页条数，缺省 10

返回数据

{
    "code": 200,
    "message": "success",
    "data": {
        "total": 25,
        "record": [
            {
                "id": "01965de1-1920-7fe4-aa38-2e6836c46f22",      // 会话ID
                "name": "关于销售周报的咨询",                          // 会话名称
                "user_id": "u_12345",                              // 业务方用户ID
                "created_at": "2025-04-22 22:22:34",               // 创建时间
                "updated_at": "2025-04-22 22:30:11"                // 最后更新时间
            }
        ]
    }
}

字段	类型	说明
id	string(uuid)	会话 ID，后续对话与查询历史使用
name	string	会话名称，通常由首轮对话自动生成
user_id	string	业务方用户 ID
created_at	string	创建时间，YYYY-MM-DD HH:mm:ss
updated_at	string	最后更新时间，YYYY-MM-DD HH:mm:ss