Caixa de conexão

Prévia:você precisa estar na lista de permissão para usar esse conector.

Nesta página, descrevemos como conectar o Box ao Gemini Enterprise. O conector aceita ingestão de dados e pesquisa federada. Consulte a seção da abordagem que você planeja usar:

• Caixa de conexão (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 executadas 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 Configuração com JWT na documentação do Box para ter uma visão geral da configuração com capturas de tela.

Criar um app do Box

1. Faça login no Box Developer Console 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 Box

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

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

   Observação: o acesso ao app e à empresa é 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 corporativo depende desse nível para identificar e recuperar arquivos, comentários e tarefas novos e modificados com eficiência.

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

   1. A opção Ler todos os arquivos e pastas armazenados no Box é necessária para buscar comentários e tarefas e visualizar arquivos, mas não é suficiente para baixar arquivos.

   2. A opção Gravar todos os arquivos e pastas armazenados no Box é necessária para baixar arquivos, e ao selecioná-la, o acesso Ler todos os arquivos é concedido automaticamente. Embora esse escopo seja amplo e tecnicamente permita criar e modificar arquivos, ele é usado estritamente apenas para o download de arquivos.

   3. A permissão Gerenciar usuários é necessária 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. Também é necessário ter a permissão Gerenciar grupos para buscar a lista de grupos e participantes. Isso é essencial para o controle de acesso, já que os itens compartilhados com grupos do Box precisam ter os 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 corporativos para rastrear mudanças.

4. Na seção Recursos avançados, selecione Fazer chamadas de API usando o cabeçalho "as-user".

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

   

   Configure o app 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. É possível fazer o download de um arquivo de configuração com a chave privada e a senha. Guarde esse arquivo para uso posterior.

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

      

      Gerencie as chaves.

6. Clique em Salvar alterações.

Autorizar o app Box

1. No Console do desenvolvedor do Box, escolha o app da plataforma e acesse a guia Autorização.
2. Clique em Revisar e enviar.

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

   

   Autorize o app Box.

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

   

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

4. Faça login no gerenciador de apps da plataforma de administração 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.

   

   Clique em "Autorizar".

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

• ID da empresa: obtenha na guia Configurações gerais.

  

  Obtenha o ID corporativo.

• ID do cliente e chave secreta do cliente: obtenha essas informações na guia Configuração em Credenciais do OAuth 2.0.

  

  Consiga a configuração do cliente.

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

  

  Adicione e gerencie 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 console Google Cloud , 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 Enterpriserise 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.

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. Com essa abordagem, é possível 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 Box Developer Console com sua conta de administrador.

2. Clique em Criar app de plataforma.

   

   Crie um app de plataforma.

3. Clique em Custom App (App personalizado).

4. Preencha os campos obrigatórios.

   

   Forneça 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 console Google Cloud e fazer uma pesquisa federada no Box pelo Gemini Enterprise.

1. No console Google Cloud , 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 Federated para conectar sua fonte de terceiros.

   

   Pesquisar o Box Federated

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. Em seguida, insira um nome.

   

   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 dele 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 vai 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 aos back-ends de terceiros.