Caixa de conexão

Prévia:você precisa estar na lista de permissão para usar esse conector. Para ser adicionado à lista de permissão, entre em contato com a equipe de contas ou a equipe de vendas.

Esta página descreve como conectar o Box ao Gemini Enterprise. O conector oferece suporte à ingestão de dados e à pesquisa federada. Consulte a seção da abordagem que você planeja usar:

• Conectar o Box (ingestão de dados)
• Conectar a pesquisa federada ao Box

Conectar o Box (ingestão de dados)

Use o procedimento a seguir para sincronizar dados do Box com o Gemini Enterprise.

Depois de configurar a fonte de dados e importar os dados pela primeira vez, o repositório de dados sincroniza as informações dessa fonte com uma frequência que você seleciona durante a configuração.

Antes de começar

Antes de configurar sua conexão:

1. Você precisa ter acesso de administrador à instância do Box, com a autenticação de dois fatores ativada. Todas as instruções de configuração só podem ser realizadas na conta de administrador.

2. Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.

3. Leia a configuração com JWT na documentação do Box para uma visão geral da configuração, com capturas de tela.

Criar um app do Box

1. Faça login no Console do desenvolvedor do Box com sua conta de administrador.
2. Clique em Criar app de plataforma.
3. Selecione Tipo de app como App personalizado.
4. Insira o Nome do app.
5. Defina as seguintes propriedades:
   1. Finalidade:integração
   2. Categorias:IA
   3. Sistema externo: Google Cloud Gemini Enterprise

6. Selecione Método de autenticação como Autenticação do servidor (com JWT).

   

   Selecione Autenticação do servidor (com JWT).

7. Clique em Criar app.

Configurar o app do Box

1. No Console do desenvolvedor do Box, escolha o App de plataforma e acesse a guia Configuração.

2. Na seção Nível de acesso do app, selecione Acesso ao app + Enterprise.

   Observação: o Acesso ao app + Enterprise é necessário para buscar arquivos, comentários e tarefas de contas de usuários individuais. Além disso, esse nível de acesso é necessário para a funcionalidade de sincronização incremental. O fluxo de eventos do Enterprise depende desse nível para identificar e recuperar arquivos, comentários e tarefas novos e modificados de maneira eficiente.

3. Na seção Escopos do aplicativo, selecione os seguintes escopos:

   1. Ler todos os arquivos e pastas armazenados no Box é necessário para buscar comentários e tarefas e visualizar arquivos, embora não seja suficiente para fazer o download de arquivos.

   2. Gravar todos os arquivos e pastas armazenados no Box é necessário para fazer o download de arquivos, e a seleção dessa opção concede automaticamente o acesso Ler todos os arquivos ; embora esse escopo seja amplo e tecnicamente permita criar e modificar arquivos, ele é usado apenas para o download de arquivos.

   3. Gerenciar usuários é necessário para buscar a lista de usuários, o que permite a recuperação de arquivos, comentários e tarefas de contas de usuários individuais.

   4. Gerenciar grupos também é necessário para buscar a lista de grupos e seus participantes. Isso é fundamental para o controle de acesso, já que os itens compartilhados com grupos do Box precisam ter seus participantes identificados.

   5. Gerenciar propriedades corporativas é um escopo necessário para a funcionalidade de sincronização incremental, já que facilita o uso do fluxo de eventos do Enterprise para rastrear mudanças.

4. Na seção Recursos avançados, selecione Fazer chamadas de API usando o cabeçalho como usuário.

   Observação: Fazer chamadas de API usando o cabeçalho como usuário é necessário para buscar arquivos, comentários e tarefas de contas de usuários individuais. Esse é um recurso essencial porque a conta de serviço do administrador não tem acesso inerente a todos os arquivos de propriedade do usuário. O cabeçalho "como usuário" permite que o sistema faça solicitações de API como o usuário específico para acessar os dados dele. A seleção dessa opção concede automaticamente o acesso Gerenciar usuários.

   

   Configurar o app do Box.

5. Na seção Adicionar e gerenciar chaves públicas, clique em Gerar um par de chaves pública/privada.

   1. A chave pública é enviada automaticamente ao console com um ID. Esse ID é usado ao criar uma conexão.
   2. Você pode fazer o download de um arquivo de configuração com a chave privada e a senha. Mantenha esse arquivo para uso posterior.

   3. Opcionalmente, para gerar sua própria chave, consulte o guia de configuração do par de chaves do Box.

      

      Gerenciar as chaves.

6. Clique em Salvar alterações.

Autorizar o app do Box

1. No Console do desenvolvedor do Box, escolha o App de plataforma e acesse a guia Autorização.
2. Clique em Ler e enviar.

3. Na caixa de diálogo Ler envio de autorização do app, clique em Enviar.

   

   Autorizar o app do Box.

   Se a solicitação de autorização for enviada, a seguinte mensagem de confirmação será mostrada:

   

   A solicitação de autorização foi enviada.

4. Faça login no gerenciador de apps de plataforma do administrador do Box com sua conta de administrador.

5. Escolha o App de plataforma que você configurou.

6. Clique nos três pontos (...) na linha correspondente.

7. Selecione Autorizar app na lista suspensa.

8. Na caixa de diálogo Autorizar app, clique em Autorizar para concluir o processo de autorização.

   

   Clique em Autorizar.

Tenha as seguintes informações de autenticação do Box prontas:

• ID corporativo: encontre-o na guia Configurações gerais.

  

  Obtenha o ID empresarial.

• ID do cliente e Chave secreta do cliente: encontre-o na guia Configuração em Credenciais do OAuth 2.0.

  

  Encontre a configuração do cliente.

• Chave privada, ID da chave e Senha: esses parâmetros já foram gerados e transferidos por download para um arquivo local na guia Configuração em Adicionar e gerenciar chaves públicas ao configurar o app.

  

  Adicionar e gerenciar chaves públicas.

Criar um conector do Box

Console

Para usar o Google Cloud console e sincronizar dados do Box com o Gemini Enterprise, siga estas etapas:

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

   Gemini Enterprise

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

3. Clique em Criar repositório de dados.

4. Na página Selecionar uma fonte de dados, role a tela ou pesquise Box para conectar sua fonte de terceiros.

5. Insira suas informações de autenticação nas Configurações de autenticação. No campo Chave privada, copie e cole o seguinte valor de chave privada.

    -----BEGIN ENCRYPTED PRIVATE KEY-----\nMIIFLTBXBgkqhkiG9w0BBQ0wSjApBgkqhkiGK7wbIkVf2jW\n-----END ENCRYPTED PRIVATE KEY-----\n
   

6. Selecione quais entidades sincronizar e clique em Continuar.

7. Selecione a Frequência de sincronização para Sincronização completa e a Frequência de sincronização incremental para Sincronização incremental de dados. Para mais informações, consulte Programações de sincronização.

   Se quiser programar sincronizações completas separadas de dados de entidade e identidade, expanda o menu em Sincronização completa e selecione Opções personalizadas.

   

   Definir programações separadas para sincronização completa de entidades e de identidades.

8. Selecione uma região para o repositório de dados.

9. Insira um nome para o repositório de dados.

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar minutos ou horas.

Próximas etapas

• Para anexar seu repositório de dados a um app, crie um app e selecione o repositório seguindo as etapas em Criar um app de pesquisa.

• Para ver como os resultados da pesquisa aparecem depois que o app e o repositório de dados são configurados, consulte Receber resultados da pesquisa.

• Para ativar alertas para o repositório de dados, consulte Configurar alertas para repositórios de dados de terceiros.

Conectar a pesquisa federada ao Box

Use o procedimento a seguir para pesquisar na sua conta do Box usando a pesquisa federada.

Prévia:você precisa estar na lista de permissão para usar esse conector. Para ser adicionado à lista de permissão, entre em contato com a equipe de contas ou a equipe de vendas.

Sobre a federação de dados

Com a federação de dados, o Gemini Enterprise recupera informações diretamente das fontes de dados de terceiros usando APIs, em vez de copiar os dados para o Gemini Enterprise. Usando essa abordagem, você pode acessar fontes de dados externas imediatamente, sem esperar pela ingestão.

Antes de começar

Antes de criar um repositório de dados do Box no Gemini Enterprise, registre um aplicativo OAuth 2.0 no Console do desenvolvedor do Box.

Para registrar o aplicativo, faça o seguinte:

1. Faça login no Console do desenvolvedor do Box com sua conta de administrador.

2. Clique em Criar app de plataforma.

   

   Criar um novo app de plataforma.

3. Clique em App personalizado.

4. Preencha os campos obrigatórios.

   

   Informe detalhes sobre seu app.

5. Selecione Autenticação do usuário (OAuth 2.0).

   

   Selecione o método de autenticação.

6. Clique em Criar app.

7. Copie o ID do cliente e a Chave secreta do cliente. Eles são necessários para criar um repositório de dados de pesquisa federada com o Box no Gemini Enterprise.

   

   Registre as credenciais do OAuth 2.0.

8. Na seção URIs de redirecionamento do OAuth 2.0, adicione os seguintes URIs de redirecionamento:

   • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html
   • https://vertexaisearch.cloud.google.com/oauth-redirect

   

   Informe os URIs de redirecionamento.

9. Selecione os seguintes escopos de aplicativo:

   • Ler todos os arquivos e pastas armazenados no Box
   • Gravar todos os arquivos e pastas armazenados no Box

   

   Selecione os escopos necessários.

10. Clique em Salvar alterações.

Criar um conector de pesquisa federada com o Box

Console

Siga estas etapas para usar o Google Cloud console para realizar uma pesquisa federada no Box pelo Gemini Enterprise.

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

   Gemini Enterprise

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

3. Clique em Criar repositório de dados.

4. Na página Selecionar uma fonte de dados, role a tela ou pesquise Box federado para conectar sua fonte de terceiros.

   

   Pesquisar por Box federado

5. Em Configurações de autenticação:

   1. Insira o ID do cliente e a Chave secreta do cliente.
   2. Clique em Autenticar.

   3. Clique em Continuar.

      

      Insira as informações de autenticação

6. Selecione uma região para sua fonte de dados.

7. Insira um nome para a fonte de dados.

   

   Configure seu conector de dados

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

Depois que o repositório de dados for criado, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir o status. Se o estado do conector mudar de Criação para Ativo, o conector de pesquisa federada estará pronto para uso.

Autorização do usuário

Depois de criar um repositório de dados de pesquisa federada, ele vai aparecer como uma das fontes de dados no painel de gerenciamento de fontes. Se você não tiver autorizado o Gemini Enterprise antes, não será possível selecionar a fonte de dados. Em vez disso, um botão Autorizar aparece ao lado dele.

Para iniciar o fluxo de autorização:

1. Clique em Autorizar. Você será redirecionado para o servidor de autorização do Box.

   

   Clique em Autorizar

2. Faça login na sua conta do Box.

3. Clique em Conceder acesso. Depois de conceder acesso, o sistema redirecionará você de volta ao Gemini Enterprise para concluir o fluxo de autorização.

   O Gemini Enterprise recebe o access_token e o usa para acessar a pesquisa de terceiros.

Execução da consulta

Quando você insere uma consulta de pesquisa:

• Se a pesquisa federada do Box estiver autorizada, o Gemini Enterprise enviará a consulta para a API do Box.
• O Gemini Enterprise combina os resultados com os de outras fontes e os mostra.

Processamento de dados

Ao usar a pesquisa federada de terceiros, sua string de consulta é enviada para o back-end de pesquisa de terceiros. Esses terceiros podem associar consultas à sua identidade. Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.

Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema (não pelos termos do Google Cloud).

Observação: um LLM pode reescrever sua consulta antes do envio. Essa consulta reescrita pode incorporar informações do seu histórico de consultas com base na sessão. Como resultado, partes desse histórico também podem ser incluídas no que é enviado a os back-ends de terceiros.