Configure um arquivo de dados do Box

Esta página descreve como criar um repositório de dados e associar o Box ao Gemini Enterprise.

Antes de começar

Antes de configurar a ligação do Box, certifique-se de que faz o seguinte:

  1. Conceda a função Editor do Discovery Engine (roles/discoveryengine.editor). Esta função é necessária para o utilizador criar o arquivo de dados. Para conceder esta função, faça o seguinte:
    1. Na Google Cloud consola, aceda à página IAM.

      Aceda ao IAM

    2. Localize a conta de utilizador e clique no ícone editar Editar.
    3. Conceda a função de Discovery Engine Editor ao utilizador. Para mais informações, consulte o artigo Funções e autorizações de IAM.
  2. Crie e autorize a conta da app Box.
  3. Configure o Box e defina as autorizações necessárias. Para ver a lista de âmbitos necessários para a pesquisa e a carregamento de dados, consulte o artigo Autorizações necessárias.
  4. Obtenha as informações de autenticação para usar durante a criação do arquivo de dados.
  5. Configure um Google Cloud projeto com uma conta de administrador capaz de gerir as configurações ao nível da organização, garantindo que a organização pode configurar um conjunto de trabalhadores.
  6. Certifique-se de que a sua organização está configurada para gerir um conjunto de trabalhadores.

Crie o arquivo de dados do Box

Para criar o arquivo de dados do Box, siga estes passos:

  1. Na Google Cloud consola, aceda à página do Gemini Enterprise.

    Gemini Enterprise

  2. Selecione ou crie um Google Cloud projeto.

  3. No menu de navegação, clique em Armazenamentos de dados.

  4. Clique em Criar arquivo de dados.

  5. Na secção Origem, pesquise Box e clique em Selecionar.

  6. Na secção Dados:

    1. Na secção Modo do conetor, selecione Pesquisa federada ou Carregamento de dados como modo de ligação.

    2. Clique em Continuar.

    3. Na secção Definições de autenticação, configure a autenticação com base no modo de ligação escolhido.

      • Se selecionou Pesquisa federada, introduza os seguintes detalhes:

        • ID do cliente: o identificador exclusivo da sua aplicação Box.
        • Segredo do cliente: a chave secreta associada à sua aplicação Box.

      • Se selecionou Carregamento de dados, introduza os seguintes detalhes:

        • ID da empresa: o identificador exclusivo da sua empresa do Box.
        • ID do cliente: o identificador público da sua aplicação Box.
        • Segredo do cliente: a chave secreta associada à sua aplicação Box.
        • URI da instância: o URL base da API da sua instância do Box.
        • Chave privada: a chave privada usada para autenticar a sua aplicação Box.
        • ID da chave: o identificador da chave privada.
        • Frase de acesso: a frase de acesso usada para desencriptar a chave privada.

        Para ver a lista de âmbitos necessários para a pesquisa e a carregamento de dados, consulte o artigo Âmbitos necessários. Para ver informações sobre como obter informações de autenticação, consulte o artigo Obtenha informações de autenticação do Box.

      • Se selecionou Pesquisa federada, clique em Iniciar sessão e conclua o início de sessão.

    4. Clique em Continuar.

    5. Na secção Opções avançadas:

      • Se selecionou Pesquisa federada, selecione o Modo de representação do utilizador como Admin ou User e clique em Continuar.
      • Opcional. Se selecionou Carregamento de dados, selecione a caixa de verificação Ativar endereços IP estáticos para permitir um conjunto de endereços IP estáticos no seu sistema.

    6. Clique em Continuar.

    7. Na secção Entidades a pesquisar (se selecionou Pesquisa federada) ou Entidades a sincronizar (se selecionou Carregamento de dados):

      1. Selecione todas as entidades necessárias.
      2. Se selecionou Carregamento de dados, continue com os seguintes passos:
        1. Opcional: para sincronizar projetos específicos, faça o seguinte:
          1. Clique em Filtrar.
          2. Para filtrar entidades do índice, selecione a caixa de verificação Excluir do índice ou, para garantir que são incluídas no índice, selecione a caixa de verificação Incluir no índice.
          3. Introduza as chaves. Prima Enter após cada tecla.
          4. Clique em Guardar.
        2. Para configurar a programação de sincronização, faça o seguinte:
          1. Na lista Frequência de sincronização, selecione a frequência de sincronização.
            • Para agendar sincronizações completas separadas de dados de entidades e identidades, expanda o menu na secção Sincronização completa e, de seguida, selecione Opções personalizadas.
          2. Na lista Frequência de sincronização incremental, selecione a frequência de sincronização incremental. Para mais informações, consulte o artigo Sincronize agendas.

  7. Clique em Continuar.

  8. Na secção Configuração:

    1. Na lista Várias regiões, selecione a localização do conetor de dados.
    2. No campo Nome do conetor de dados, introduza um nome para o conetor.
    3. Se selecionou US ou EU como a localização, configure as Definições de encriptação:
      • Opcional: se não tiver configurado chaves de região única, clique em Aceder à página de definições para o fazer. Para mais informações, consulte o artigo Registe uma chave de região única para conetores de terceiros.
      • Selecione chave de encriptação gerida pelaGoogle ou chave do Cloud KMS.
      • Se selecionou Chave do Cloud KMS:
        • Na lista Tipo de gestão de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte o artigo Chaves de encriptação geridas pelo cliente.

  9. Clique em Continuar.

  10. Na secção Faturação, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte os artigos Valide o estado de faturação dos seus projetos e Licenças.

  11. Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

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

  1. Navegue para o arquivo de dados na lista de arquivos de dados e monitorize o respetivo estado até mudar para Ativo.
  2. Quando o estado do armazenamento de dados muda de A criar para Ativo, o conetor do Box está pronto a ser usado.

Para um arquivo de dados de carregamento criado com o Box, o estado do arquivo de dados passa de A criar para Em execução após o início da sincronização. Em seguida, muda para Ativa assim que o carregamento estiver concluído, o que significa que o armazenamento de dados está totalmente configurado. Consoante o volume de dados, o carregamento pode demorar várias horas.

Se tiver criado um arquivo de dados federado do Box, tem de autorizar o Gemini Enterprise no Box antes de executar a consulta.

Tratamento de dados e execução de consultas

Esta secção descreve como o Gemini Enterprise gere a sua consulta e as implicações de privacidade da utilização do repositório de dados federado.

Execução de consultas

Depois de autorizar o Box e enviar uma consulta de pesquisa para o Gemini Enterprise:

  • O Gemini Enterprise envia a sua consulta de pesquisa diretamente para a API Box.
  • O Gemini Enterprise mistura os resultados com os de outras origens de dados ligadas e apresenta um resultado de pesquisa abrangente.

Tratamento de dados

Quando utiliza a pesquisa federada de terceiros, aplicam-se as seguintes regras de processamento de dados:

  • A sua string de consulta é enviada para o back-end de pesquisa de terceiros (API Box).
  • Estes terceiros podem associar consultas à sua identidade.
  • Se estiverem ativadas várias origens de dados de pesquisa federada, a consulta pode ser enviada para todas elas.
  • Assim que os dados chegam ao sistema de terceiros, são regidos pelos Termos de Utilização e pelas Políticas de Privacidade desse sistema.

O que se segue?