> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Google Drive

## 概述

将 [Google Drive](https://drive.google.com) 连接到 ElevenLabs 智能体，即可将文档同步到知识库。智能体随后可在对话中使用同步内容进行检索增强生成（RAG）。

此连接使用权限范围较小的 `drive.file` 作用域。ElevenLabs 只能看到你通过 Google 文件选择器授予访问权限的文件，无法列出或读取 Drive 中的其他内容。

初次同步后，ElevenLabs 会检测更改并执行增量同步，无需重新处理未变更的文档。

## 功能

| 功能         | 支持情况 |
| ---------- | ---- |
| 零留存模式（ZRM） | 不支持  |

## 设置

#### 连接 Google 账号

在 ElevenLabs Google Drive 集成页面，点击 **连接**。随后会跳转到 Google 以授权 `drive.file` 作用域。

#### 开始同步

在知识库页面，点击 **同步文档**，然后选择导入文件的目标文件夹。你还可选择启用 **自动同步**，定期刷新文件（可设置为每 1 至 180 天一次，默认每天一次）；也可启用 **自动移除**，当你失去对 Drive 中源文件的访问权限时，自动删除相应文档。

#### 选择文件

点击 **选择文件**，然后在 Google 文件选择器中选择要同步的文件。只有你选择的文件会共享给 ElevenLabs，并导入目标文件夹。

## 支持的文件类型

| 格式                            | 支持 | 说明                  |
| ----------------------------- | -- | ------------------- |
| Google Docs                   | 是  | 保留文本和格式，不包含嵌入图片和评论。 |
| PDF                           | 是  |                     |
| DOCX                          | 是  |                     |
| 纯文本                           | 是  |                     |
| HTML                          | 是  |                     |
| Markdown                      | 是  |                     |
| EPUB                          | 是  |                     |
| Google Sheets、Slides、Drawings | 否  |                     |

大于 20 MB 的文件会被跳过。

## 工作原理

**连接类型。** 此连接请求 `drive.file` 作用域，将 ElevenLabs 的访问范围限制为你在 Google 文件选择器中选择的文件。

**初次同步。** 每个选中的文件都会单独导入。

**增量同步。** 后续同步仅处理自上次同步后新增、修改或删除的文件。启用自动移除后，已删除的文件会从知识库中移除。

**手动同步。** 无论自动同步计划如何，你都可随时触发同步。对某个文件使用 **立即同步**，即可仅刷新该文件内容。

## 安全和权限

访问权限通过标准 Google OAuth 授权流程按用户授予，可随时通过 [Google 账号权限](https://myaccount.google.com/permissions)撤销。ElevenLabs 无法在 Drive 中创建、修改或删除文件。

| 作用域          | 授予权限                             |
| ------------ | -------------------------------- |
| `drive.file` | 仅对你通过 Google 文件选择器选择的文件拥有只读访问权限。 |

## 实用链接

* [知识库文档](https://elevenlabs.io/docs/eleven-agents/customization/knowledge-base)
* [Google Drive API 参考文档](https://developers.google.com/drive/api/reference/rest/v3)
* [Google Picker API](https://developers.google.com/drive/picker/guides/overview)
* [Google Drive 的 Google OAuth 2.0 作用域](https://developers.google.com/identity/protocols/oauth2/scopes#drive)