审阅选项
所有 编辑文档 的 AI Toolkit 方法都具有 reviewOptions 属性。配置该属性后,可以在文档编辑完成后显示审阅界面。
const result = toolkit.executeTool({
toolName: 'tiptapEdit',
input,
// 显示一个界面,允许用户在更改应用后进行审阅。
reviewOptions: { mode: 'review' },
})编辑文档后,将显示一个 建议 列表。
reviewOptions 属性接收一个 ReviewOptions 配置对象。
ReviewOptions
mode?('disabled' | 'review' | 'preview' | 'trackedChanges'): 在应用更改之前还是之后审阅这些更改。默认值:'disabled''disabled':不显示审阅界面。'review':先应用更改,然后显示审阅界面,允许用户撤销这些更改。'preview':在应用更改之前显示预览界面,允许用户接受或拒绝这些更改。'trackedChanges':AI 生成的更改会使用 Tracked Changes 扩展编码为跟踪更改,允许用户接受或拒绝单个更改。
displayOptions?(DisplayOptions): 自定义建议在编辑器 UI 中的显示方式。设置Suggestion类型的displayOptions属性。查看可用选项。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 扩展。useDiffUtility?(boolean): 是否使用 Diff Utility 比较更改前后的文档,并将删除和新增的内容以富差异的形式显示。如果为false,删除的内容和新增的内容将作为一个整体块显示为单个更改。默认值:truediffUtilityOptions?(ExternalDiffUtilityOptions): 使用 diff 工具比较文档时的选项。查看可用选项。