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

Para preparar o ambiente do Google Drive antes de criar o repositório de dados, faça o seguinte:

  • 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 do Google pessoais (contas de consumidor que terminam em @gmail.com) não têm um ID de cliente e não são compatíveis.

  • 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 o acesso do Gemini Enterprise no Google Workspace: no Google Admin Console, um administrador do Google Workspace para a organização em que os usuários e a residência de dados do Google Drive residem precisa ativar a opção Permitir que o Gemini Enterprise acesse os dados do Google Workspace. Se essa configuração estiver desativada, as pesquisas do Google Drive não vão retornar resultados no app da Web do Gemini Enterprise (e podem retornar um erro 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. na API). Para ver instruções, consulte Controlar o acesso do Gemini Enterprise aos dados do Google Workspace.

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

  • Adicione o app OAuth à sua lista de permissões: o repositório de dados do Google Drive usa um app OAuth gerenciado pelo Googlepara acessar seus dados. Se sua organização restringe o acesso a apps OAuth, o administrador do Google Workspace precisa adicionar esse app à lista de permissões da organização. Para mais detalhes, consulte Adicionar à lista de permissões o app OAuth gerenciado pelo Google.

  • Configurar o acesso entre organizações (se aplicável): 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 . Se os usuários ou os dados do Google Drive pertencerem a uma organização diferente do Google Workspace (por exemplo, quando o projeto do Google Cloud estiver em um domínio e os usuários fizerem login em um ou mais domínios separados do Google Workspace ou locatários de teste), siga estas etapas:

    1. Entre em contato com o Cloud Customer Care para adicionar o ID de cliente da organização do Google Workspace de cada usuário (por exemplo, C01234567) à lista de permissões do seu projeto do Google Cloud .
    2. Peça para um administrador do Google Workspace em cada organização do Google Workspace ativar a opção Permitir que o Gemini Enterprise acesse os dados do Google Workspace no Google Admin Console da organização. Ativar essa configuração apenas na organização do projeto Google Cloud não é suficiente. Para mais detalhes, consulte Controlar o acesso do Gemini Enterprise aos dados do Google Workspace.

    Além disso, se os usuários precisarem encontrar documentos de fora da própria organização, ative a opção Incluir documentos entre domínios no app. Você pode selecionar essa opção ao criar o app ou ativá-la mais tarde em Gerenciar recursos do app da Web.

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 escopo do conteúdo do Google Drive que o repositório de dados pesquisa. Para configurar filtros usando o console do Google Cloud 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 o ID de uma pasta ou de um 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 método setUpDataConnector.

    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 ambos.

       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, que pode ser admin_filter para inclusão ou admin_exclusion_filter para exclusão. Preencha a lista em admin_filter ou em admin_exclusion_filter, mas não em ambos.
    • FILTER_KEY: a entidade do Drive a ser filtrada, SharedDriveIds ou FolderIds.
    • FILTER_VALUE_1, FILTER_VALUE_2: os IDs de drive compartilhado ou de pasta para filtrar.
  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 posteriormente.

  11. Opcional: na seção Política de Proteção de Dados Sensíveis, anexe uma política de conteúdo da Proteção de Dados Sensíveis para inspecionar e bloquear dados sensíveis que o Gemini Enterprise recupera por esse repositório de dados. Para mais informações, consulte Proteger dados sensíveis em fontes. Se a organização não exigir uma política de conteúdo da 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 da 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 da 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 com um ID de cliente do Google Workspace que corresponda à organização do repositório de dados do Google Workspace e ao projeto do Google Cloud , a menos que o ID de cliente do Google Workspace do usuário esteja na lista de permissões do projeto. Se a incompatibilidade não for intencional, recrie o repositório de dados em um projeto do Google Cloud que pertença à mesma organização que os usuários do Google Workspace ou remova o repositório de dados do Google Workspace do app. Se os usuários e o repositório de dados do Google Workspace precisarem estar em organizações diferentes, entre em contato com o Cloud Customer Care para adicionar o ID de cliente do Google Workspace de cada usuário à lista de permissões do projeto do Google Cloud e garantir que um administrador do Google Workspace em cada organização de usuário ative o acesso do Gemini Enterprise aos dados do Google Workspace. Além disso, se os usuários precisarem encontrar documentos que pertencem a pessoas de fora da organização, ative a opção Incluir documentos entre domínios em Gerenciar recursos do app da web.
403 Permissão negada O acesso do Agentspace ao Workspace foi desativado pelo administrador da organização. Um administrador do Google Workspace na organização do usuário desativou o acesso aos dados do Google Workspace para o Gemini Enterprise. No app da Web do Gemini Enterprise, esse erro pode não ser exibido diretamente. Em vez disso, as consultas não retornam arquivos correspondentes do Google Drive. Entre em contato com o administrador do Google Workspace da organização do usuário para ativar o acesso. Em configurações entre organizações, essa configuração precisa ser ativada no Admin Console do Google de cada organização do Google Workspace em que os usuários fazem consultas no Google Drive.
400 Argumento inválido A solicitação contém um argumento inválido. Esse erro ocorre se o nome do conector de dados na solicitação não atender 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, hifens 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