Vista geral

O arquivo de dados do Box para o Gemini Enterprise permite-lhe aceder aos seus dados do Box e interagir com registos.

Versões do Box compatíveis

O armazenamento de dados do Box suporta a versão 2024.0 da API Box.

Ações suportadas

Quando o arquivo de dados do Box está ativado, os utilizadores finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar a seguinte ação.

Ação Descrição
Copie o ficheiro Cria um duplicado de um ficheiro numa pasta de destino, deixando o ficheiro original inalterado.

Âmbitos obrigatórios

Para permitir que o Gemini Enterprise realize pesquisas, ações e carregamento de dados através do arquivo de dados do Box, precisa dos seguintes âmbitos:

Modo de ligação Âmbito Purpose
Pesquisa federada Read all files and folders stored in Box Necessário para obter comentários e tarefas, e para pré-visualizar ficheiros para pesquisa.
Pesquisa e ações federadas Write all files and folders stored in Box Necessário para copiar os ficheiros, bem como para obter comentários e tarefas, e para pré-visualizar ficheiros para pesquisa.
Carregamento de dados Read all files and folders stored in Box Obrigatório para o carregamento de dados.
Manage users Necessário para obter a lista de utilizadores, o que permite a obtenção de ficheiros, comentários e tarefas de contas de utilizadores individuais para carregamento. A conta de serviço do administrador não tem inerentemente acesso a todos os ficheiros pertencentes aos utilizadores. O cabeçalho as-user permite que o sistema faça pedidos de API como o utilizador específico para aceder aos respetivos dados.
Manage enterprise properties Necessário para a funcionalidade de sincronização incremental, uma vez que facilita a utilização da stream de eventos empresarial para acompanhar as alterações para carregamento.
Manage groups Necessário para obter a lista de grupos e os respetivos membros. Isto é fundamental para o controlo de acesso durante o carregamento.

Para obter informações sobre como adicionar estas autorizações para o Box, consulte o artigo Configure o Box e defina as autorizações necessárias.

Limitações

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

  • Ao criar uma nova aplicação ou adicionar um arquivo de dados a um existente, recomendamos que adicione apenas um arquivo de dados com ações pertencentes a um único tipo de conetor, independentemente do modo de associação. Por exemplo, não associe dois armazenamentos de dados do Box com ações ativadas à mesma aplicação.
  • A aplicação de um perímetro dos VPC Service Controls a arquivos de dados do Box existentes não é suportada. Para aplicar os VPC Service Controls, tem de eliminar e recriar os arquivos de dados. Para mais informações sobre o VPC Service Controls e como usar ações após a ativação do VPC Service Controls, consulte o artigo Proteja a sua app com o VPC Service Controls.
  • O arquivo de dados do Box só é suportado nas localizações Global, US e EU.

  • O arquivo de dados federado do Box usa APIs Box para a pesquisa. Consequentemente, a qualidade da pesquisa depende dos resultados fornecidos pela pesquisa do Box. Isto pode resultar em limitações na qualidade da pesquisa para idiomas que não o inglês, porque as APIs Box podem não estar totalmente otimizadas para estes idiomas. Para alcançar uma melhor qualidade de pesquisa nestes cenários, use o arquivo de dados de carregamento.

O que se segue?