---
title: "基础 AI 生成中的自动补全"
description: "启用由 AI 驱动的自动补全，通过 Tab 键触发，将智能文本建议直接流式传入你的 Tiptap 编辑器。"
canonical_url: "https://tiptap.zhcndoc.com/ai/basic/text-generation/autocompletion"
---

# 基础 AI 生成中的自动补全

启用由 AI 驱动的自动补全，通过 Tab 键触发，将智能文本建议直接流式传入你的 Tiptap 编辑器。

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

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

  在您的 [AI 设置](https://cloud.tiptap.dev/v2/cloud/ai) 中配置 OpenAI，或查看
  [自定义 LLM 指南](https://tiptap.zhcndoc.com/ai/basic/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)

## 配置自动补全

在集成 Basic AI Generation 扩展时，您可以指定是否启用自动补全、
自动补全功能应如何表现，以及它应考虑哪些上下文。

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

要查看 Basic AI Generation 扩展的其他所有配置选项，请前往 [安装](https://tiptap.zhcndoc.com/ai/basic/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)一起使用自动补全时，建议内容对每个用户均为私有，只有在接受建议后才会对其他人可见。