---
title: "管理检查点"
description: "学习如何在 AI 代理中管理检查点。"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/agent/features/checkpoints"
---

# 管理检查点

学习如何在 AI 代理中管理检查点。

检查点是编辑器内容和对话状态在特定时间点的快照。它们允许你保存文档和对话的当前状态，并在需要时恢复。

## 设置检查点

要创建检查点，请使用 `setCheckpoint` 方法：

```tsx
const checkpointMessage = provider.setCheckpoint()
```

此方法返回一个检查点消息，其中包含当前的聊天消息和编辑器内容。

## 恢复检查点

要恢复之前保存的检查点，请使用 `restoreCheckpoint` 方法：

```tsx
provider.restoreCheckpoint(checkpointMessage.checkpoint)
```

这将把编辑器内容和对话消息还原到创建该检查点时的状态。

## 自动检查点

你可以配置提供者，使其在用户发送消息时自动保存检查点：

```tsx
const provider = new AiAgentProvider({
  // ...其他选项
  autoSaveCheckpoints: true,
})
```

启用 `autoSaveCheckpoints` 后，检查点会在用户消息发送之前以及调用工具之前保存。若要在其他时间保存检查点，可以手动调用 `setCheckpoint`。