Takeoff › Documentação › Conectar à IA
Conectar o Takeoff a uma inteligência artificial
O Takeoff pode ser ligado ao Claude, ao ChatGPT e ao Power BI. Feita a ligação, você conversa com a IA em português e ela lê e edita seus orçamentos e cronogramas direto na sua conta — sem planilha no meio do caminho.
Nesta página
1. O que dá para fazer
A integração com IA não é um chat que "dá dicas" sobre obra. É um acesso real à sua conta: a inteligência artificial enxerga os seus planos, as suas tarefas e as suas composições de custo, e pode alterá-los quando você pede.
Na prática, isso permite pedir coisas como:
- "Crie um plano novo chamado Ponte do Rio Claro e comece em 10 de março."
- "Liste as tarefas do plano Pátio de Cargas Norte com custo acima de R$ 50 mil."
- "Na tarefa de concretagem, troque a equipe para dois turnos e me diga o que acontece com o prazo."
- "Copie a composição de forma de madeira para todas as tarefas de estrutura."
O Power BI é uma integração de natureza diferente: ele não conversa, apenas lê os dados para montar painéis. Está descrito na seção 5.
2. Antes de começar
Você vai precisar de três coisas:
- Uma conta no Takeoff em um plano que inclua integrações — hoje, os planos Free e Enterprise.
- Uma conta no assistente de IA que você pretende usar: Claude ou ChatGPT. A assinatura é sua, contratada direto com eles; o Takeoff não revende nem cobra por isso.
- Cinco minutos. A ligação é feita copiando e colando um endereço. Não é preciso instalar nada nem saber programar.
A IA enxerga apenas os dados da sua empresa no Takeoff, com as mesmas permissões que você tem ao entrar pelo navegador. Ela não alcança dados de outras empresas.
3. Onde ficam as integrações
Tudo começa na mesma tela, dentro do Takeoff:
- Entre no Takeoff e vá até o Hub, a tela com a lista dos seus planos.
- Clique no seu nome, no canto superior direito, para abrir o menu da conta.
- Escolha Integrações.
Hub › menu da conta › Integrações
A tela abre já com tudo pronto: na primeira vez que você entra, o Takeoff cria automaticamente a sua chave de acesso. Não há nada para preencher. Os dois blocos que interessam aqui são MS Power BI e Claude e ChatGPT, cada um com um botão Copiar.
O item só aparece no menu para contas em planos com integração liberada. Se ele não estiver lá, fale com o responsável pela conta da sua empresa ou escreva para contato@b2builder.com.br.
4. Conectar ao Claude ou ao ChatGPT
Os dois usam o mesmo endereço, chamado na tela de URL do Connector. É um endereço longo, que já vem com a sua chave embutida.
- Na tela de Integrações, no bloco Claude e ChatGPT, clique em Copiar.
- Abra o Claude ou o ChatGPT e vá nas configurações, na área de conectores.
- Escolha adicionar um conector personalizado e cole o endereço que você copiou.
- Confirme. O assistente vai se apresentar ao Takeoff e listar o que passou a saber fazer.
Depois de conectar — e sempre que a lista de recursos do Takeoff for atualizada — abra uma conversa nova. Conversas que já estavam abertas continuam com a lista antiga e podem responder que não conseguem fazer algo que, numa conversa nova, funciona normalmente.
A partir daí é só conversar. Peça em português, do jeito que você falaria com um colega: a IA identifica sozinha o plano e as tarefas de que você está falando.
5. Conectar ao Power BI
O Power BI lê os dados do Takeoff e monta os painéis que a sua empresa quiser. São dois endereços, cada um com um conteúdo:
| Endereço | O que traz |
|---|---|
| Tarefas (Custos + Planejamento) | As tarefas dos planos, com seus custos e suas datas. |
| Composições (Recursos) | Os recursos usados nas composições de custo: pessoal, equipamentos e materiais. |
- Na tela de Integrações, bloco MS Power BI, clique em Copiar no endereço desejado. O botão Testar ao lado abre o endereço no navegador — serve para conferir que os dados estão vindo.
- No Power BI, use Obter dados e escolha a origem Web.
- Cole o endereço e confirme.
- Repita para o segundo endereço, se quiser as duas tabelas no mesmo painel.
Os dados são consultados ao vivo: quando você atualiza o painel no Power BI, ele busca a situação atual do Takeoff.
6. O que pedir para a IA
Vale conversar normalmente. Alguns exemplos do que costuma funcionar bem no dia a dia:
Consultar
- "Quais são os dez itens mais caros do plano Ponte do Rio Claro?"
- "Qual o custo total de pessoal desse plano, já com encargos?"
- "Esse cronograma termina em que data?"
Editar
- "Adicione uma tarefa de escavação com 1.200 m³ embaixo da etapa de terraplenagem."
- "Mude a data de início do plano para 3 de abril e me diga como ficam as entregas."
- "Duplique esse plano para eu usar como modelo na próxima obra."
Comparar e revisar
- "Compare as composições de concreto dos dois planos e aponte as diferenças."
- "Tem alguma tarefa sem recurso associado?"
A IA altera os dados de verdade. Depois de uma alteração em massa, vale abrir o plano no Takeoff e conferir o resultado — do mesmo jeito que você conferiria o trabalho de um estagiário caprichoso.
7. Segurança do acesso
O endereço que você copia já contém a sua chave de acesso. Quem tiver esse endereço em mãos alcança os dados da sua empresa no Takeoff, sem precisar de senha. Trate-o como você trataria uma senha: não publique em grupo de WhatsApp, não cole em documento compartilhado, não mande por e-mail para fora da empresa.
Se o endereço vazar
Na tela de Integrações, no bloco Claude e ChatGPT, existe o botão Rotacionar. Ele cria um endereço novo e derruba o antigo na hora.
A chave é a mesma para todas as integrações. Ao rotacionar, os endereços do Power BI param de funcionar junto, e os painéis passam a dar erro na atualização. Depois de rotacionar, volte à tela de Integrações, copie os endereços novos e atualize também as conexões do Power BI e dos assistentes de IA.
8. Perguntas frequentes
Preciso saber programar para usar?
Não. Todo o trabalho é copiar um endereço numa tela do Takeoff e colar numa tela do assistente. Depois disso, a conversa é em português comum.
A IA pode apagar ou estragar meu orçamento?
A integração permite tanto ler quanto editar, então sim, uma alteração pedida é uma alteração feita de verdade. Peça mudanças grandes em partes, confira o resultado no Takeoff e, quando quiser experimentar sem risco, duplique o plano e trabalhe na cópia.
Preciso pagar o Claude ou o ChatGPT à parte?
Sim. A assinatura do assistente de IA é contratada por você, direto com o fornecedor dele. O Takeoff apenas fornece a ligação, incluída nos planos que têm integração.
Posso usar o mesmo endereço em mais de um computador?
Pode. O endereço é da sua conta, não da máquina. Só lembre que ele é sensível: quanto mais lugares, mais caminhos por onde vazar.
A IA enxerga os dados de outras empresas que usam o Takeoff?
Não. O acesso é restrito à sua empresa, com as mesmas permissões que você tem ao entrar pelo navegador.
Conectei, mas o assistente diz que não consegue fazer nada no Takeoff.
Quase sempre é a conversa antiga: abra uma conversa nova no assistente. Se continuar, volte à tela de Integrações, copie o endereço de novo e refaça a ligação — pode ser que a chave tenha sido rotacionada.
Meu painel do Power BI parou de atualizar do nada.
O motivo mais comum é alguém ter clicado em Rotacionar na tela de Integrações, o que troca a chave de todas as integrações. Copie os endereços novos do Power BI e atualize a conexão do painel.
Ficou alguma dúvida? Escreva para contato@b2builder.com.br.