---
title: "内容 AI 中的自动补全"
description: "设置您的 AI 生成扩展，在用户按下编辑器中的 Tab 键时自动补全并流式传输文本。更多内容请查看文档！"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/autocompletion"
---

# 内容 AI 中的自动补全

设置您的 AI 生成扩展，在用户按下编辑器中的 Tab 键时自动补全并流式传输文本。更多内容请查看文档！

- **1. 激活试用或订阅**

  在您的账户中开始[免费试用](https://cloud.tiptap.dev/v2?trial=true)或[订阅入门计划](https://cloud.tiptap.dev/v2/billing)。
- **2. 集成 AI 提供商**

  在您的[AI 设置](https://cloud.tiptap.dev/v2/cloud/ai)中配置 OpenAI，或参考[自定义大语言模型指南](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/custom-llms.md)。
- **3. 从私有仓库安装**

  若要安装前端扩展，请按照[设置指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md)认证登录 Tiptap 的私有 npm 仓库。

启用自动补全时，系统会利用您已书写的文本片段来生成建议。

只需在书写时按下 `Tab` 键即可触发自动补全。再次按下 `Tab` 键接受建议的补全内容。

如果您想现场体验，请在本演示中任意文本行后按 `Tab` 键。

> **Interactive demo:** [AiAutocompletion](https://embed-pro.tiptap.dev/preview/Extensions/AiAutocompletion)

## 配置自动补全

集成内容 AI 扩展时，您可以指定是否启用自动补全，\
自动补全功能的行为方式以及应考虑的上下文。

| 设置项                     | 类型        | 默认值                                                                                             | 定义                                                                                                        |
| ----------------------- | --------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `autocompletion`        | `boolean` | `false`                                                                                         | 启用自动补全功能。书写文本时，按下 **Tab** 键触发自动补全，再按一次 **Tab** 接受补全内容。系统会使用您已书写的部分文本作为向 OpenAI 构建提示的基础。                   |
| `autocompletionOptions` | `object`  | `{ trigger: 'Tab', accept: 'Tab', debounce: 0, inputLength: 4000, modelName: 'gpt-3.5-turbo' }` | 定义触发自动补全所用的触发键和用于生成补全建议的文本长度。若未显式设置，accept 默认为触发键。debounce 表示触发后请求的去抖动时间（毫秒）。您还可以选择用于运行自动补全任务的 OpenAI 模型。 |

欲了解内容 AI 扩展的其他全部配置选项，请访问[安装页面](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/install.md#configure-the-extension)。

## 启用自动补全

```js
import { Editor } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'
import Ai from '@tiptap-pro/extension-ai'

const editor = new Editor({
  extensions: [
    StarterKit,
    Ai.configure({
      token: 'TOKEN_HERE',
      autocompletion: true,
      // … 其他选项（见上文）
    }),
    // … 更多扩展
  ],
})
```

## 在协作中的使用

当与[Tiptap 协作功能](https://tiptap.zhcndoc.com/collaboration/getting-started/overview.md)一起使用自动补全时，建议内容对每个用户均为私有，只有在接受建议后才会对其他人可见。