Visão geral

O repositório de dados do Box para o Gemini Enterprise permite pesquisar e realizar ações nos seus dados e registros do Box.

Versões do Box com suporte

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, mantendo o arquivo original inalterado.
Fazer upload do arquivo Faz upload de um arquivo para uma pasta especificada no Box.
Baixar o arquivo Baixa um arquivo do Box.

Escopos obrigatórios

Para permitir que o Gemini Enterprise realize 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, fazer upload e baixar arquivos, além de buscar comentários e tarefas e visualizar arquivos para pesquisa.
Ingestão de dados Read all files and folders stored in Box Necessá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 inerente 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 corporativos para acompanhar as mudanças na ingestão.
Manage groups Necessário para buscar a lista de grupos e os participantes deles. Isso é fundamental para o controle de acesso durante a ingestão.

Para informações sobre 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 novo app ou adicionar um repositório de dados a um app já existente, recomendamos associar apenas um repositório de dados a ações pertencentes a um único tipo de conector.
  • Não há suporte para a aplicação de um perímetro do VPC Service Controls em repositórios 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 tem suporte 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