审阅选项

所有 编辑文档 的 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,删除的内容和新增的内容将作为一个整体块显示为单个更改。默认值:true
  • diffUtilityOptions? (ExternalDiffUtilityOptions): 使用 diff 工具比较文档时的选项。查看可用选项