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.
| Item | Por que importa |
|---|---|
| Conta no DoubleX Agentes | Criar a conta é grátis, sem cartão |
| Acesso ao Box | O agente enxerga o que a conta conectada enxerga |
| Definição do escopo | Saber quais pastas e documentos o agente deve consultar |
| Quem vai usar | Define 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:
- Crie a conta e, se quiser, faça o diagnóstico para gerar uma equipe de agentes já com as instruções da empresa.
- Abra a tela Conectores e procure o Box (categoria documentos).
- Inicie a conexão e autorize o acesso com a sua conta do Box.
- Escolha o tipo de conexão: pessoal, do time ou da empresa.
- Na tela Agentes, abra o agente que vai usar o Box e ative o conector para ele.
- 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.
| Tipo | Quando usar | Cuidado |
|---|---|---|
| Pessoal | Pastas e arquivos que só você acessa | O agente usa o seu acesso |
| Do time | Área com pastas compartilhadas, como Jurídico ou Comercial | Combine com o time quem administra |
| Da empresa | Acervo geral, como políticas e modelos | Revise 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
- Como conectar o Jam a um agente de IA passo a passoVeja como conectar o Jam a um agente de IA no DoubleX Agentes: escolha o tipo de conexão, limite permissões e teste com um relatório de bug.
- Como conectar o Hex a um agente de IA passo a passoVeja como conectar o Hex a um agente de IA: do diagnóstico à primeira pergunta sobre dados, com escolha do escopo da conexão e controle de permissões.