Como conectar o Box a um agente de IA passo a passo

· DoubleX

Resposta rápida

Para conectar o Box a um agente de IA, ligue o conector do Box na tela Conectores, autorize o acesso com sua conta, escolha quais ações o agente pode usar (de preferência só leitura) e faça um primeiro pedido. No DoubleX Agentes, o histórico da tarefa mostra tudo o que o agente fez.

O Box guarda contratos, propostas, relatórios e pastas de clientes que a equipe consulta o tempo todo. Ligar esse acervo a um agente de IA evita abrir pasta por pasta para achar uma informação. O ponto central da conexão é o controle: você decide quem conecta, o que o agente enxerga e o que ele pode fazer.

O que o agente de IA consegue fazer com o Box?#

Com o conector do Box, o agente pode pesquisar e ler arquivos e pastas, usando também o Box AI. O conector é a ligação entre a plataforma e um sistema externo: o agente usa as ferramentas que esse sistema oferece.

Na prática, o agente localiza um documento pelo nome ou pelo assunto, lê o conteúdo e responde com base nele. Para ideias de pedidos e rotinas, veja o guia O que automatizar no Box com IA. Este guia cuida só da conexão e do controle de acesso.

O que preparar antes de conectar?#

Antes de conectar, você precisa de uma conta no DoubleX Agentes e de acesso ao Box com a conta que o agente vai usar. Vale também decidir quais pastas fazem parte do trabalho do agente.

ItemPor que importa
Conta no DoubleX AgentesCriar a conta é grátis, sem cartão
Acesso ao BoxO agente enxerga o que a conta conectada enxerga
Definição do escopoSaber quais pastas e documentos o agente deve consultar
Quem vai usarDefine se a conexão será pessoal, do time ou da empresa

Se ainda não tem agentes, faça o diagnóstico: uma conversa de 5 a 10 minutos com a consultora de IA do produto, que indica por onde começar. O primeiro é grátis. O Início rápido mostra esse caminho em detalhes.

Como conectar o Box em Conectores?#

A conexão é feita na tela Conectores: você escolhe o Box, autoriza o acesso e o conector fica disponível para os agentes. O passo a passo no DoubleX Agentes é este:

  1. Crie a conta e, se quiser, faça o diagnóstico para gerar uma equipe de agentes já com as instruções da empresa.
  2. Abra a tela Conectores e procure o Box (categoria documentos).
  3. Inicie a conexão e autorize o acesso com a sua conta do Box.
  4. Escolha o tipo de conexão: pessoal, do time ou da empresa.
  5. Na tela Agentes, abra o agente que vai usar o Box e ative o conector para ele.
  6. Defina as ações permitidas, como explicado na próxima seção.

Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM. Quem prefere automatizar a configuração também pode usar a API; veja Conectores na API.

Como escolher quais ações o agente pode usar (só leitura)?#

Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Ações que alteram dados podem ficar desligadas, deixando o agente em modo só leitura.

Para o Box, o ponto de partida mais seguro é liberar apenas pesquisar e ler. Só amplie as permissões se houver um motivo claro, e apenas para o agente que precisa.

Além disso, antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez. Você mantém a decisão final.

Como fazer o primeiro pedido e conferir o histórico na tarefa?#

Faça o primeiro pedido em conversa com o agente que tem o Box ativo. Cada pedido vira uma tarefa na tela Tarefas, com o histórico completo: o pedido, cada ferramenta usada e o resultado.

Exemplos para copiar:

  • "Procure no Box o contrato do cliente Alfa e me diga a data de vigência."
  • "Liste os arquivos da pasta Propostas 2025 e resuma o que cada um contém."
  • "Leia o documento de política de reembolso no Box e responda em três tópicos."
  • "Encontre no Box a última versão da apresentação institucional e me diga quando foi atualizada."

Depois, abra a tarefa em Tarefas e confira quais ferramentas do Box o agente chamou. Assim você sabe quem pediu, o que foi feito e quando. Se o agente não achou algo, o histórico mostra o que ele buscou.

Conexão pessoal, do time ou da empresa: qual escolher?#

Escolha pessoal quando só você deve usar o acesso, do time quando um grupo compartilha as mesmas pastas e da empresa quando o acervo vale para todos. Uma conexão pessoal vale só para a pessoa, como o próprio e-mail.

TipoQuando usarCuidado
PessoalPastas e arquivos que só você acessaO agente usa o seu acesso
Do timeÁrea com pastas compartilhadas, como Jurídico ou ComercialCombine com o time quem administra
Da empresaAcervo geral, como políticas e modelosRevise o escopo com um administrador

A plataforma tem papéis de dono, administrador e membro, além de times e compartilhamento por pessoa, time ou empresa. O conteúdo da empresa não é usado para treinar modelos. Se quiser ligar outro sistema da mesma forma, veja o guia Como conectar o Hex a um agente de IA.

Perguntas frequentes#

O agente de IA altera ou apaga arquivos no Box?#

Só se você permitir. Dá para deixar as ações que alteram dados desligadas, em modo só leitura. Mesmo quando liberadas, o agente pede confirmação antes de apagar ou alterar algo.

Preciso programar para conectar o Box?#

Não. A conexão é feita na tela Conectores, com autorização da conta. Quem quiser ir além pode usar a API REST, a CLI e o servidor MCP.

Como saber o que o agente fez com meus arquivos?#

Tudo fica registrado na tela Tarefas. Cada tarefa mostra o pedido, as ferramentas usadas e o resultado, com a informação de quem pediu e quando.

O conteúdo do Box é usado para treinar modelos de IA?#

Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores de IA que não usam o que recebem para treinamento. Há ainda a opção de retenção zero na tela Modelos.

Posso usar o Box com agentes diferentes?#

Sim. Você ativa o conector em cada agente e define, para cada um, quais ações ele pode executar.

Guias relacionados

Mais guias de Box