# 界面会话

管理界面中的会话、分组和显示状态。

## 选择任务

| 任务 | 接口 | 说明 |
| --- | --- | --- |
| 创建 UI 协议会话记录 | [创建 UI 协议会话记录](create-session.md) | 保存当前用户的会话记录。 |
| 删除 UI 协议会话记录 | [删除 UI 协议会话记录](delete-session.md) | 维护当前用户会话记录。 |
| 切换 UI 协议消息点踩 | [切换 UI 协议消息点踩](dislike-message.md) | 切换当前用户消息的评价标签，并返回消息记录。 |
| 读取 UI 协议消息详情 | [读取 UI 协议消息详情](get-message.md) | 读取当前用户的消息及可取得的标签。 |
| 读取 UI 协议会话详情 | [读取 UI 协议会话详情](get-session.md) | 读取当前用户的会话记录。 |
| 查询最近 UI 协议消息 ID | [查询最近 UI 协议消息 ID](latest-message.md) | 读取当前用户在指定会话内的最大消息 ID。 |
| 切换 UI 协议消息点赞 | [切换 UI 协议消息点赞](like-message.md) | 切换当前用户消息的评价标签，并返回消息记录。 |
| 查询 UI 协议会话消息 | [查询 UI 协议会话消息](list-messages.md) | 按 ID 游标读取当前用户的消息，返回消息数组。 |
| 查询普通会话一页中的置顶项 | [查询普通会话一页中的置顶项](list-pinned-sessions.md) | 按当前用户、来源和筛选条件读取会话记录。 |
| 查询 UI 协议会话 | [查询 UI 协议会话](list-sessions.md) | 按当前用户、来源和筛选条件读取会话记录。 |
| 查询未置顶的 UI 协议会话 | [查询未置顶的 UI 协议会话](list-unpinned-sessions.md) | 按当前用户、来源和筛选条件读取会话记录。 |
| UI 协议会话对象与读取规则 | [UI 协议会话对象与读取规则](objects.md) | 这些接口读取和维护持久化记录，不提交模型推理或智能体任务。 |
| 置顶 UI 协议会话 | [置顶 UI 协议会话](pin-session.md) | 维护当前用户会话记录。 |
| UI 与工作区 LLM 协议比较 | [UI 与工作区 LLM 协议比较](protocol-comparison.md) | 两组入口由同一持久化 owner 管理，使用相同类型的数值记录 ID。 |
| 取消 UI 协议会话置顶 | [取消 UI 协议会话置顶](unpin-session.md) | 维护当前用户会话记录。 |
| 更新 UI 协议会话记录 | [更新 UI 协议会话记录](update-session.md) | 更新当前用户会话的非空标题或配置文本。 |

```{toctree}
:hidden:
:maxdepth: 1

创建 UI 协议会话记录 <create-session>
删除 UI 协议会话记录 <delete-session>
切换 UI 协议消息点踩 <dislike-message>
读取 UI 协议消息详情 <get-message>
读取 UI 协议会话详情 <get-session>
查询最近 UI 协议消息 ID <latest-message>
切换 UI 协议消息点赞 <like-message>
查询 UI 协议会话消息 <list-messages>
查询普通会话一页中的置顶项 <list-pinned-sessions>
查询 UI 协议会话 <list-sessions>
查询未置顶的 UI 协议会话 <list-unpinned-sessions>
UI 协议会话对象与读取规则 <objects>
置顶 UI 协议会话 <pin-session>
UI 与工作区 LLM 协议比较 <protocol-comparison>
取消 UI 协议会话置顶 <unpin-session>
更新 UI 协议会话记录 <update-session>
```
