---
title: "审阅选项"
description: "使用 ReviewOptions 配置 AI 生成更改的预览和审阅行为。"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/review-options"
---

# 审阅选项

使用 ReviewOptions 配置 AI 生成更改的预览和审阅行为。

所有 [编辑文档](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/edit-the-document.md) 的 AI Toolkit 方法都具有 `reviewOptions` 属性。配置该属性后，可以在文档编辑完成后显示审阅界面。

```ts
const result = toolkit.executeTool({
  toolName: 'tiptapEdit',
  input,
  // 显示一个界面，允许用户在更改应用后进行审阅。
  reviewOptions: { mode: 'review' },
})
```

编辑文档后，将显示一个 [建议](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/agents/review-changes.md) 列表。

`reviewOptions` 属性接收一个 `ReviewOptions` 配置对象。

## `ReviewOptions`

- `mode?` (`'disabled' | 'review' | 'preview' | 'trackedChanges'`): 在应用更改之前还是之后审阅这些更改。默认值：`'disabled'`
  - `'disabled'`：不显示审阅界面。
  - `'review'`：先应用更改，然后显示审阅界面，允许用户撤销这些更改。
  - `'preview'`：在应用更改之前显示预览界面，允许用户接受或拒绝这些更改。
  - `'trackedChanges'`：AI 生成的更改会使用 [Tracked Changes](https://tiptap.zhcndoc.com/tracked-changes/getting-started/overview.md) 扩展编码为跟踪更改，允许用户接受或拒绝单个更改。
- `displayOptions?` (`DisplayOptions`): 自定义建议在编辑器 UI 中的显示方式。设置 [`Suggestion`](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/suggestions.md#the-suggestion-object) 类型的 `displayOptions` 属性。[查看可用选项](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/suggestions.md#the-suggestion-object)。
- `metadata?` (`Record<string, any>`): 为建议提供的额外元数据，可用于存储有关它们的附加信息（例如它们的来源或类别）。扩展内部不会使用它，但它可能有助于开发者自定义建议在 UI 中的显示方式。
- `trackedChangesOptions?` (`{ userId: string, userMetadata?: Record<string, unknown> | null }`): `trackedChanges` 模式的配置。`userId` 用于标识跟踪更改的作者。`userMetadata` 用于存储作者的附加信息。
- `commentsOptions?` (`{ threadData?: Record<string, unknown>, commentData?: Record<string, unknown> }`): 当与 `trackedChanges` 模式一起提供时，操作元数据（编辑操作中的 `meta` 字段）会变成链接到每个跟踪更改的评论线程。需要 [Comments](https://tiptap.zhcndoc.com/comments/getting-started/overview.md) 扩展。
- `useDiffUtility?` (`boolean`): 是否使用 [Diff Utility](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/diff-utility.md) 比较更改前后的文档，并将删除和新增的内容以富差异的形式显示。如果为 `false`，删除的内容和新增的内容将作为一个整体块显示为单个更改。默认值：`true`
- `diffUtilityOptions?` ([`ExternalDiffUtilityOptions`](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/diff-utility.md#parameters-diffutilityoptions)): 使用 diff 工具比较文档时的选项。[查看可用选项](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/api-reference/diff-utility.md#parameters-diffutilityoptions)。