管理会话与条目¶

创建和维护本地会话记录，保存会话元数据与条目摘要。本任务覆盖尚未关联上游模型的本地会话；消息正文和模型调用上下文由应用维护。

前提条件¶

准备具有 Genesis 权限的个人访问令牌。操作已有会话时，使用创建该会话时的凭据和会话标识。

调用顺序¶

需要新记录时创建会话，保留返回的会话标识；已有会话则使用保存的标识查询会话。
如需调整会话元数据，先读取当前信息，再提交更新，并查询会话确认替换结果。
需要记录条目摘要时，向该会话添加条目，并保留返回的条目标识。
使用会话标识查询条目列表，或使用会话标识和条目标识查询单条摘要，确认记录内容。
确认不再需要某条摘要或整个会话时，按需删除对应对象，并检查删除确认。

API 操作¶

管理会话记录¶

要完成的事	API 操作	何时使用或确认什么
新建会话记录	创建会话	保存元数据和可选条目摘要，并取得会话标识。
检查会话	查询会话	使用已有标识读取元数据、状态和时间。
替换会话元数据	更新会话元数据	需要调整记录信息时，提交完整的新元数据。
清理整个会话	删除会话	确认该会话及其条目不再需要通过接口访问后使用。

管理条目摘要¶

要完成的事	API 操作	何时使用或确认什么
添加条目摘要	添加会话条目	在已有会话中记录类型、角色和状态等摘要。
浏览条目摘要	查询会话条目列表	使用会话标识检查已记录的条目。
检查单条摘要	查询会话条目	使用所属会话及条目标识读取摘要。
清理单条摘要	删除会话条目	确认该条目不再需要后使用。

结果确认¶

创建或更新后，查询会话确认元数据；添加条目后，查询该条目确认摘要。删除会话后无法再通过会话接口访问该会话及其条目，删除单条条目后无法再查询该条目。

限制和注意事项¶

本地会话不保存消息正文，也不自动将会话内容传给模型。
更新会话元数据会替换全部元数据，提交前保留仍需使用的信息。
本地条目列表最多返回 200 条，暂不支持游标翻页。需要完整历史记录时，由应用保存条目与消息正文。

最后更新于 2026 年 9 月 8 日