> 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

## Visão geral

Conecte o [Google Drive](https://drive.google.com) aos seus agentes da ElevenLabs para sincronizar documentos com sua base de conhecimento. Seus agentes poderão usar o conteúdo sincronizado para geração aumentada por recuperação (RAG) durante as conversas.

A conexão usa o escopo restrito `drive.file`. A ElevenLabs vê apenas os arquivos que você compartilha por meio do Seletor de arquivos do Google e não pode listar nem ler nada mais no seu Drive.

Após a sincronização inicial, a ElevenLabs detecta alterações e sincroniza incrementalmente de novo, sem reprocessar documentos inalterados.

## Recursos

| Recurso                     | Suporte        |
| --------------------------- | -------------- |
| Modo de retenção zero (ZRM) | Não compatível |

## Configuração

#### Conectar sua conta do Google

Na página de integração do Google Drive da ElevenLabs, clique em **Connect**. Você será redirecionado ao Google para autorizar o escopo `drive.file`.

#### Iniciar uma sincronização

Na página da base de conhecimento, clique em **Sync Documents** e selecione a pasta de destino dos arquivos importados. Se quiser, ative **Auto sync** para atualizar periodicamente os arquivos (configurável entre 1 e 180 dias, com o padrão de uma vez por dia) e **Auto remove** para excluir automaticamente um documento quando você perder o acesso ao arquivo de origem no Drive.

#### Selecionar arquivos

Clique em **Pick files** e selecione, no Seletor de arquivos do Google, os arquivos que deseja sincronizar. Somente os arquivos selecionados são compartilhados com a ElevenLabs e importados para a pasta de destino.

## Tipos de arquivo compatíveis

| Formato                         | Compatível | Observações                                                                                   |
| ------------------------------- | ---------- | --------------------------------------------------------------------------------------------- |
| Google Docs                     | Sim        | O texto e a formatação são preservados. Imagens incorporadas e comentários não são incluídos. |
| PDF                             | Sim        |                                                                                               |
| DOCX                            | Sim        |                                                                                               |
| Texto simples                   | Sim        |                                                                                               |
| HTML                            | Sim        |                                                                                               |
| Markdown                        | Sim        |                                                                                               |
| EPUB                            | Sim        |                                                                                               |
| Google Sheets, Slides, Drawings | Não        |                                                                                               |

Arquivos maiores que 20 MB são ignorados.

## Como funciona

**Tipo de conexão.** A conexão solicita o escopo `drive.file`, que limita a ElevenLabs aos arquivos selecionados no Seletor de arquivos do Google.

**Sincronização inicial.** Cada arquivo selecionado é importado individualmente.

**Sincronização incremental.** As sincronizações seguintes processam apenas arquivos adicionados, modificados ou excluídos desde a última sincronização. Os arquivos excluídos são removidos da base de conhecimento quando a remoção automática está ativada.

**Sincronização manual.** Você pode iniciar uma sincronização a qualquer momento, independentemente da programação de sincronização automática. Use **Sync now** em um arquivo para atualizar apenas o conteúdo dele.

## Segurança e permissões

O acesso é concedido por usuário pelo fluxo padrão de consentimento do Google OAuth e pode ser revogado a qualquer momento nas [permissões da sua conta do Google](https://myaccount.google.com/permissions). A ElevenLabs não pode criar, modificar ou excluir arquivos no seu Drive.

| Escopo       | Concede                                                                                   |
| ------------ | ----------------------------------------------------------------------------------------- |
| `drive.file` | Acesso somente leitura apenas aos arquivos selecionados no Seletor de arquivos do Google. |

## Links úteis

* [Documentação da base de conhecimento](https://elevenlabs.io/docs/eleven-agents/customization/knowledge-base)
* [Referência da API do Google Drive](https://developers.google.com/drive/api/reference/rest/v3)
* [API Google Picker](https://developers.google.com/drive/picker/guides/overview)
* [Escopos do Google OAuth 2.0 para o Drive](https://developers.google.com/identity/protocols/oauth2/scopes#drive)