Skip to main content

查询近期会话

千问办公企业旗舰版开发者文档:查询近期会话。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务
  • 接口:GET/api/openapi/app/v1/sessions/recent
  • operationId:list-recent-sessions

接口说明

查询当前用户未置顶的主会话,与置顶列表互补。每个计划任务分组仅展示最新一条未删除的主会话,task_id 标识所属任务。排除已删除会话、子会话和 Desktop 本地执行记录。近期指按创建时间、ID倒序,不是所有会话列表,也不是按最后活动时间排序。

请求参数

字段类型必填说明
cursor (query)integer否minimum=0
limit (query)integer否default=20;minimum=1;maximum=100

成功响应

HTTP 200

字段类型必填说明
has_moreboolean是见接口说明
itemsarray是见接口说明
items[].created_atstring是会话创建时间,ISO 8601,含微秒和时区。
items[].end_reasonstring/null是会话结束原因;尚未结束时为 null,仅 terminated 状态下设置。
items[].modestring是会话使用的能力档位。
items[].namestring是显示名称。
items[].pinnedboolean是见接口说明
items[].session_idstring是会话 ID,可用于查询会话详情。
items[].statusstring是当前会话状态。使用 status=action_required 筛选等待用户回应的会话。
items[].task_idstring否此行关联的计划任务;普通会话不返回。
items[].updated_atstring是会话记录最近更新时间,ISO 8601。
next_cursorinteger是见接口说明

分页

limit 默认20、最大100;首次省略 cursor,后续使用 next_cursor,并以 has_more 判断是否继续。items 为空时返回空数组。游标沿用当前偏移分页,数据变更期间不保证快照一致性;

错误与边界

401:入口身份无效;404:资源不存在、已删除或非本人;422:输入无效;503:所需依赖未装配或暂不可用。业务状态和审核拒绝按服务端错误体处理。 本接口不接受调用方传入身份来改变归属,不暴露内部 extra_data、沙箱凭据或模型 runtime 配置。写入超时后先查询实际状态,不把超时视为操作未发生。