用途：该技能围绕会话线程中的单条消息交换，覆盖消息的保存、检索、展示与管理。适用于向用户显示对话历史、在生成回复前保存用户消息、在 UI 中实现乐观消息更新、使用 UIMessages 做富文本格式展示，以及从展示历史中过滤工具消息。
主要能力：可通过 listUIMessages 分页查询线程消息，并在 React 中用 useUIMessages 展示；可用 saveMessage 手动保存消息，并支持 skipEmbeddings 选项；支持乐观更新，例如用 optimisticallySendMessage 包装 generateResponse 的 useMutation；可删除消息，包括 deleteMessage、deleteMessages 和按 order 范围删除的 deleteMessageRange。UIMessage 类型包含 key、role、text、status（saved、streaming、finished、aborted）、agentName、_creationTime 和 parts 等字段。
使用方式：查询侧使用 listUIMessages(ctx, components.agent, { threadId, paginationOpts })；保存侧使用 saveMessage(ctx, components.agent, { threadId, prompt, skipEmbeddings: true })；React 侧使用 useUIMessages(api.messages.listThreadMessages, { threadId }, { initialNumItems: 20 })。消息顺序由 order 和 stepOrder 自动维护。
关键原则与限制：UI 用 UIMessages，后端用 MessageDocs；在 mutation 中保存消息时跳过 embeddings；乐观更新用于在保存前立即展示消息。资料未提供收费、价格、平台兼容性及更细的限制说明，暂未提供。后续可参考 streaming、files、threads 相关技能。