O repositório de dados do Google Drive para o Gemini Enterprise permite pesquisar e realizar ações nos seus dados do Google Drive, incluindo arquivos e pastas.
Ações permitidas
Quando o repositório de dados do Google Drive está ativado, os usuários finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar as ações a seguir.
| Ação | Descrição |
|---|---|
| Copiar arquivo | Copia um arquivo no Google Drive. |
| Criar arquivo | Cria um arquivo no Google Drive. |
| Baixar o conteúdo do arquivo | Faz o download do conteúdo de um arquivo do Google Drive. |
| Receber valores de células | Lê valores de células de uma planilha do Google. |
| Acessar metadados de arquivos | Busca metadados de um arquivo do Google Drive. |
| Obter permissões do arquivo | Lista as permissões de um arquivo do Google Drive. |
| Acessar planilha | Lê o conteúdo e os metadados de uma planilha do Google. |
| Inserir dimensão | Insere linhas ou colunas em uma planilha do Google Planilhas. |
| Listar arquivos recentes | Lista os arquivos recentes no Google Drive. |
| Listar drives compartilhados | Lista os drives compartilhados no Google Drive. |
| Ler documento | Lê o conteúdo de um documento do Google Docs. |
| Ler o conteúdo do arquivo | Lê o conteúdo de um arquivo do Google Drive. |
| Ler apresentação | Lê o conteúdo de uma apresentação do Google Slides. |
| Pesquisar arquivos | Pesquisa arquivos do Google Drive que correspondem a uma consulta. |
| Compartilhar arquivo | Compartilha um arquivo do Google Drive com um ou mais usuários. |
| Mover arquivo para a lixeira | Move um arquivo do Google Drive para a lixeira. |
| Atualizar valores de células | Grava valores de células em uma planilha do Google. |
| Atualizar arquivo | Atualiza um arquivo do Google Drive. |
| Atualizar fórmulas | Grava fórmulas em uma planilha do Google. |
Escopos obrigatórios
O app OAuth gerenciado pelo Googlesolicita os seguintes escopos do OAuth. Os usuários concedem esses escopos ao autorizar o conector:
| Escopo | Finalidade |
|---|---|
https://www.googleapis.com/auth/drive.readonly |
Pesquisar e recuperar conteúdo do Google Drive. Permite que o repositório de dados liste arquivos e pastas, visualize metadados, liste permissões e leia o conteúdo dos arquivos. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Ler metadados de arquivos do Google Drive. |
https://www.googleapis.com/auth/drive.file |
Criar e atualizar arquivos que o usuário abre ou cria com o conector. |
https://www.googleapis.com/auth/drive.appdata |
Armazenar dados específicos do aplicativo no Google Drive. |
https://www.googleapis.com/auth/drive |
Realizar ações de gravação em arquivos do Google Drive (por exemplo, copiar, compartilhar, excluir e atualizar). |
Limitações
- O repositório de dados do Google Drive é compatível apenas com os locais
global,useeu.
Se você usa controles de segurança, esteja ciente das limitações deles relacionadas aos dados no Google Drive, conforme discutido na tabela a seguir:
Controle de segurança Observe o seguinte: Residência de dados (DRZ) O Gemini Enterprise garante a residência de dados apenas em Google Cloud. Para informações sobre residência de dados e o Google Drive, consulte as orientações e a documentação de conformidade do Google Workspace, incluindo Regiões de dados do Google Workspace. Confira também exemplos como Escolher a região onde os dados são armazenados e Soberania digital. Chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) Suas chaves criptografam apenas dados no Google Cloud. Os controles do Cloud Key Management Service não se aplicam aos dados armazenados no Google Drive. Transparência no acesso Os registros de Transparência no acesso mostram as ações realizadas pela equipe do Google no projeto Google Cloud . Você também precisa analisar os registros da Transparência no acesso criados pelo Google Workspace. Para mais informações, consulte Eventos de registro da Transparência no acesso na documentação da Ajuda do administrador do Google Workspace.
Problemas comuns de pesquisa
Se a pesquisa não retornar o arquivo que você está procurando ou se o app da Web Gemini Enterprise informar que nenhum arquivo correspondente do Google Drive foi encontrado, verifique os problemas e as soluções a seguir.
O acesso do Gemini Enterprise aos dados do Google Workspace está desativado
Sintoma: o app da Web do Gemini Enterprise informa que nenhum arquivo correspondente do Google Drive foi encontrado ou as solicitações de pesquisa enviadas pela API Search retornam um erro (ou aviso) 403 Permission
Denied: Workspace access for Agentspace disabled by organization admin.. Também é possível inspecionar os registros de erros do repositório de dados no Cloud Logging.
Consulte Resolver problemas de repositórios de dados do Gemini Enterprise.
Problema: a configuração Permitir que o Gemini Enterprise acesse os dados do Google Workspace está desativada no Admin Console Google da organização do Google Workspace do usuário.
Solução: peça para um administrador do Google Workspace da organização do usuário ativar a opção Permitir que o Gemini Enterprise acesse os dados do Google Workspace. Em configurações entre organizações, um administrador em cada organização do Google Workspace em que os usuários consultam o Google Drive precisa ativar essa configuração.
O usuário e o repositório de dados pertencem a organizações diferentes do Google Workspace
Sintoma: os usuários que fazem login em uma organização do Google Workspace diferente
daquela do projeto do Google Cloud não recebem resultados do Google Drive no
app da Web do Gemini Enterprise, ou as solicitações enviadas pela API
Search retornam um erro 403 Permission Denied: User
does not belong to the same organization as the Workspace data store. Workspace
data store is configured for customer ID ... while user belongs to customer ID
.... Para verificar se há erros de 403 nos registros, consulte Acessar registros de erros do conector do Gemini Enterprise com o Cloud Logging.
Problema: por padrão, o Gemini Enterprise só permite que os usuários pesquisem um repositório de dados do Google Drive quando o ID de cliente do Google Workspace do usuário corresponde à organização do repositório de dados do Google Drive e ao projeto do Google Cloud .
Solução: conclua a configuração entre organizações:
- Entre em contato com o Cloud Customer Care para adicionar o ID de cliente de cada organização do Google Workspace com usuários que acessam o Gemini Enterprise à lista de permissões do seu projeto do Google Cloud .
- Peça para um administrador do Google Workspace em cada organização ativar a opção Permitir que o Gemini Enterprise acesse os dados do Google Workspace.
- Se os usuários precisarem encontrar documentos de fora da organização, ative Incluir documentos entre domínios em Gerenciar recursos do app da Web Web.
Palavras-chave que excedem o limite de 1 MB de extração de texto não podem ser pesquisadas.
Sintoma: a pesquisa de palavras-chave que aparecem mais adiante em um arquivo grande não retorna o arquivo.
Problema: o Google Drive extrai apenas 1 MB de texto e dados de formatação do arquivo para que ele possa ser pesquisado. Palavras-chave que excedem o limite de 1 MB do índice não podem ser pesquisadas.
Solução: pesquise usando termos que aparecem no primeiro 1 MB do arquivo ou divida documentos grandes em arquivos menores.
Arquivos que excedem os limites de tamanho ou de páginas de PDF não são indexados
Sintoma: arquivos grandes ou PDFs longos específicos não aparecem nos resultados da pesquisa.
Problema: os arquivos que excedem os limites de tamanho ou de páginas do Google Drive não são indexados e não aparecem nos resultados da pesquisa:
- Para a maioria dos tipos de arquivo, o tamanho não pode exceder 10 MB, com as seguintes
exceções:
- Arquivos XLSX: até 20 MB.
- Arquivos PDF: até 30 MB.
- Arquivos de texto: até 100 MB.
- O reconhecimento óptico de caracteres em arquivos PDF é limitado a 80 páginas. O Google Drive não indexa PDFs com mais de 50 MB ou 80 páginas.
Solução: reduza o tamanho do arquivo ou divida os arquivos e PDFs que excedem esses limites de indexação.
A seguir
- Para criar e configurar um repositório de dados com o Google Drive, consulte Configurar um repositório de dados do Google Drive.