# 管理会话与条目

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

## 前提条件

准备具有 Genesis 权限的[个人访问令牌](../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)。操作已有会话时，使用创建该会话时的凭据和会话标识。

## 调用顺序

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

## API 操作

### 管理会话记录

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

### 管理条目摘要

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 添加条目摘要 | [添加会话条目](../../../../reference/api/genesis/conversations/create-item.md) | 在已有会话中记录类型、角色和状态等摘要。 |
| 浏览条目摘要 | [查询会话条目列表](../../../../reference/api/genesis/conversations/list-items.md) | 使用会话标识检查已记录的条目。 |
| 检查单条摘要 | [查询会话条目](../../../../reference/api/genesis/conversations/get-item.md) | 使用所属会话及条目标识读取摘要。 |
| 清理单条摘要 | [删除会话条目](../../../../reference/api/genesis/conversations/delete-item.md) | 确认该条目不再需要后使用。 |

## 结果确认

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

## 限制和注意事项

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