Configurar um repositório de dados do Google Drive

Nesta página, descrevemos como criar um repositório de dados e conectar o Google Drive ao Gemini Enterprise. Essa conexão permite que o Gemini Enterprise recupere informações diretamente do Google Drive. Como os dados não são copiados para o índice do Gemini Enterprise, não é preciso gerenciar o armazenamento de dados.

Antes de começar

  • Faça login no console Google Cloud com a mesma conta usada na instância do Google Drive que você quer conectar. O Gemini Enterprise usa seu ID de cliente do Google Workspace para se conectar ao Google Drive. As contas pessoais do Google (contas de consumidor que terminam em @gmail.com) não têm um ID de cliente e não são aceitas.

  • Para aplicar o controle de acesso à fonte de dados e proteger os dados no Gemini Enterprise, verifique se você configurou seu provedor de identidade.

  • Verifique se todos os documentos estão acessíveis. Para isso, coloque-os em um drive compartilhado de propriedade do domínio ou atribua a propriedade a um usuário no domínio.

  • Ative os recursos inteligentes: na sua conta do Google Workspace, ative os Recursos inteligentes no Google Workspace e os Recursos inteligentes em outros Google produtos. Para mais detalhes, consulte Ativar ou desativar os recursos inteligentes do Google Workspace.

  • Adicione o app OAuth à lista de permissões (somente administradores): o repositório de dados do Google Drive usa um app OAuth gerenciado pelo Googlepara acessar seus dados. Se a organização restringir o acesso ao app OAuth, o administrador do Google Workspace precisará adicionar esse app à lista de permissões da organização. Para mais detalhes, consulte Adicionar o app OAuth gerenciado pelo Googleà lista de permissões.

Criar o repositório de dados do Google Drive

Para criar o repositório de dados do Google Drive, siga estas etapas:

  1. No Google Google Cloud console, acesse a página do Gemini Enterprise.

    Gemini Enterprise

  2. Selecionar ou criar um projeto Google Cloud

  3. No menu de navegação, selecione Repositório de dados.

  4. Clique em Criar repositório de dados.

  5. Na seção Origem, pesquise Google Drive e clique em Selecionar.

  6. Opcional: na seção Dados, configure filtros que definem o conteúdo do Google Drive que o repositório de dados pesquisa. Para configurar filtros usando o Google Cloud console ou a API REST, selecione uma das seguintes opções:

    Console

    1. No campo IDs de drives compartilhados, no campo IDs de pastas, ou em ambos, insira os IDs que você quer filtrar.
    2. Para cada campo, escolha Incluir para pesquisar apenas os IDs especificados ou Excluir para omiti-los da pesquisa. Configure o modo Incluir ou Excluir para cada campo, mas não ambos.
    3. Para localizar um ID de pasta ou de drive compartilhado, abra a pasta ou o drive compartilhado no Google Drive e copie o ID do URL. O URL segue este formato: https://drive.google.com/drive/folders/ID. Por exemplo, https://drive.google.com/drive/folders/123456789012345678901.

    API REST

    Para criar um repositório de dados com filtros, chame o setUpDataConnector método.

    As listas de inclusão são definidas em admin_filter, e as listas de exclusão são definidas em admin_exclusion_filter. Para cada tipo de filtro, preencha a lista em admin_filter ou em admin_exclusion_filter, mas não em ambas.

       curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
   -d '{
       "collectionId": "COLLECTION_ID",
       "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
       "dataConnector": {
         "dataSource": "google_drive",
         "params": {
           "FILTER_TYPE": {
             "FILTER_KEY": [
               "FILTER_VALUE_1",
               "FILTER_VALUE_2"
             ]
           }
         },
         "entities": [
           {
             "entityName": "google_drive"
           }
         ],
         "connectorModes": [
           "FEDERATED"
         ]
       }
   }'

    Substitua:

    • PROJECT_ID: ID do projeto.
    • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
      • us para a multirregião dos EUA
      • eu para a multirregião da UE
      • global para o local global
      Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
    • LOCATION: a multirregião do seu repositório de dados: global ou us.
    • COLLECTION_ID: o ID exclusivo do repositório de dados.
    • COLLECTION_DISPLAY_NAME: o nome de exibição do repositório de dados.
    • FILTER_TYPE: o tipo de filtro, admin_filter para inclusão ou admin_exclusion_filter para exclusão. Preencha a lista sob admin_filter ou sob admin_exclusion_filter, mas não em ambas.
    • FILTER_KEY: a entidade do Drive a ser filtrada, SharedDriveIds ou FolderIds.
    • FILTER_VALUE_1, FILTER_VALUE_2: os IDs de drives compartilhados ou de pastas a serem filtrados.

  7. Na seção Ações, escolha as ações na lista para ativá-las no conector do Google Drive.

    Para gerenciar a lista de ações, consulte Gerenciar ações.

  8. Clique em Continuar.

  9. Na seção Configuração:

    1. Na lista Multirregional, selecione o local do conector de dados.
    2. No campo Nome do conector de dados, insira um nome para o conector.
    3. Se você selecionou us ou eu como o local, configure as Configurações de criptografia:
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

  10. Opcional: no campo Tag, insira um identificador estável para o repositório de dados. Esse identificador é usado em diferentes versões do conector e se torna imutável após a criação do repositório de dados. Portanto, escolha um valor que não precise ser alterado mais tarde.

  11. Opcional: na seção Política de Proteção de Dados Sensíveis, anexe uma política de Proteção de Dados Sensíveis existente para inspecionar e desidentificar os dados que o Gemini Enterprise recupera por meio desse repositório de dados. Se a organização não exigir uma política de Proteção de Dados Sensíveis, pule esta etapa.

  12. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.

Para verificar o estado do repositório de dados, faça o seguinte:

  1. Navegue até o conector na lista de repositório de dados e monitore o estado dele até que mude para Ativo.
  2. Quando o estado do repositório de dados muda de Criação para Ativo, o conector do Google Drive está pronto para uso.

Depois de criar o repositório de dados, crie um app e conecte-o ao repositório de dados do Google Drive antes de executar a consulta.

Execução da consulta

Depois de autorizar o Google Drive, quando você inserir uma consulta de pesquisa:

  1. O Gemini Enterprise envia sua consulta de pesquisa para a API Google Drive.

  2. O Gemini Enterprise combina os resultados com os de outras fontes e os mostra.

Mensagens de erro e solução de problemas

A tabela a seguir descreve as mensagens de erro, incluindo códigos de erro de HTTP e etapas de solução de problemas sugeridas, que podem aparecer ao trabalhar com essa Google fonte de dados.

Código do erro Mensagem de erro Descrição Solução de problemas
403 Permissão negada A pesquisa usando credenciais de conta de serviço não é compatível com repositórios de dados do Google Workspace. O mecanismo pesquisado tem repositórios de dados do Google Workspace, e as credenciais transmitidas são de uma conta de serviço. Não é possível pesquisar usando credenciais de conta de serviço em repositórios de dados do Google Workspace. Chame a pesquisa usando as credenciais do usuário ou remova os repositórios de dados do Google Workspace do mecanismo.
403 Permissão negada As contas pessoais não são compatíveis com os repositórios de dados do Google Workspace. A pesquisa é chamada usando uma credencial de conta pessoal (@gmail.com), que não é compatível com repositórios de dados do Google Workspace. Remova os repositórios de dados do Google Workspace do mecanismo ou use uma Conta Google gerenciada.
403 Permissão negada Incompatibilidade de ID do cliente para o datastore A pesquisa só é permitida para usuários que pertencem à mesma organização que os repositórios de dados do Google Workspace. Remova os repositórios de dados do Google Workspace do mecanismo ou entre em contato com o suporte se o usuário e os repositórios de dados do Google Workspace precisarem estar em organizações diferentes.
403 Permissão negada O acesso do Agentspace ao Workspace foi desativado pelo administrador da organização. Um administrador do Google Workspace desativou o acesso aos dados do Google Workspace para o Gemini Enterprise. Entre em contato com o administrador do Google Workspace para ativar o acesso.
400 Argumento inválido A solicitação contém um argumento inválido. Esse erro ocorre quando o nome do conector de dados na solicitação não atende aos requisitos de nomenclatura. Verifique o nome do conector de dados, garantindo que ele tenha de 1 a 63 caracteres, comece com uma letra minúscula, termine com uma letra minúscula ou um dígito e contenha apenas letras minúsculas, dígitos, hífens ou sublinhados. Por exemplo, use um nome como cymbal-collection-123456789 em vez de 123456789-cymbal-collection.

Para problemas comuns de pesquisa que você encontra ao consultar os dados do Google Drive, consulte Problemas comuns de pesquisa.

A seguir