Visão geral

Com o repositório de dados do Box para o Gemini Enterprise, você pode acessar seus dados do Box e interagir com registros.

Versões compatíveis do Box

O repositório de dados do Box é compatível com a versão 2024.0 da API Box.

Ações permitidas

Quando o repositório de dados do Box está ativado, os usuários finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar a seguinte ação.

Ação Descrição
Copiar arquivo Cria um duplicado de um arquivo em uma pasta de destino sem alterar o arquivo original.

Escopos obrigatórios

Para permitir que o Gemini Enterprise faça pesquisas, ações e ingestão de dados usando o repositório de dados do Box, você precisa dos seguintes escopos:

Modo de conexão Scope Purpose
Pesquisa federada Read all files and folders stored in Box Necessário para buscar comentários e tarefas e visualizar arquivos para pesquisa.
Pesquisa e ações federadas Write all files and folders stored in Box Necessário para copiar os arquivos, buscar comentários e tarefas e visualizar arquivos para pesquisa.
Ingestão de dados Read all files and folders stored in Box Obrigatório para ingestão de dados.
Manage users Necessário para buscar a lista de usuários, permitindo a recuperação de arquivos, comentários e tarefas de contas de usuários individuais para ingestão. 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.
Manage enterprise properties Necessário para a funcionalidade de sincronização incremental, já que facilita o uso do fluxo de eventos corporativo para rastrear mudanças na ingestão.
Manage groups Obrigatório para buscar a lista de grupos e participantes. Isso é fundamental para o controle de acesso durante a ingestão.

Para saber como adicionar essas permissões ao Box, consulte Configurar o Box e definir as permissões necessárias.

Limitações

O repositório de dados do Box para o Gemini Enterprise tem as seguintes limitações:

  • Ao criar um aplicativo ou adicionar um repositório de dados a um já existente, recomendamos adicionar apenas um repositório com ações pertencentes a um único tipo de conector, independente do modo de conexão. Por exemplo, não associe dois repositórios de dados do Box com ações ativadas ao mesmo aplicativo.
  • Não é possível aplicar um perímetro do VPC Service Controls aos armazenamentos de dados do Box. Para aplicar o VPC Service Controls, é necessário excluir e recriar os repositórios de dados. Para mais informações sobre o VPC Service Controls e como usar ações depois de ativar o VPC Service Controls, consulte Proteger seu app com o VPC Service Controls.
  • O repositório de dados do Box está disponível apenas nos locais Global, US e EU.

  • O repositório de dados federado do Box usa APIs do Box para pesquisa. Consequentemente, a qualidade da pesquisa depende dos resultados fornecidos pela pesquisa do Box. Isso pode resultar em limitações na qualidade da pesquisa para idiomas que não sejam o inglês, porque as APIs do Box podem não estar totalmente otimizadas para eles. Para melhorar a qualidade da pesquisa nesses cenários, use o repositório de dados de ingestão.

A seguir