Como conectar o Hex a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o Hex a um agente de IA, crie sua conta no DoubleX Agentes, monte o agente pelo diagnóstico, abra a tela Conectores, adicione o Hex, escolha se a conexão é pessoal, do time ou da empresa e defina as ações permitidas. Depois, teste com uma pergunta sobre dados.
O Hex é uma plataforma onde equipes de dados organizam projetos e análises. Ligar o Hex a um agente de IA permite que alguém da área de negócio faça perguntas em linguagem comum e receba respostas baseadas nesses projetos, sem abrir a ferramenta. Este guia mostra o caminho completo no DoubleX Agentes, com atenção especial a permissões e ao escopo da conexão.
O que é o conector do Hex e o que o agente consegue fazer com ele?#
O conector do Hex é a ligação entre o Hex e a plataforma que permite ao agente pesquisar e rodar projetos e análises de dados. Conector é um sistema ligado ao DoubleX Agentes cujas ferramentas os agentes passam a usar.
Na prática, o agente pode:
- localizar um projeto ou análise existente no Hex;
- rodar essa análise quando você pedir;
- trazer o resultado em linguagem simples, ou entregá-lo como relatório na tela Artefatos;
- repetir o pedido em uma rotina agendada.
Para ver exemplos de pedidos e rotinas depois da conexão, consulte o guia Hex com agente de IA: pedidos e rotinas para análise de dados.
O que você precisa ter antes de conectar?#
Você precisa de uma conta no DoubleX Agentes, acesso à sua conta no Hex e pelo menos um projeto de análise já criado lá. O agente trabalha com o que existe no Hex; ele não substitui a construção das análises.
Antes de começar, confira:
| Item | Por que importa |
|---|---|
| Conta no DoubleX Agentes | Criar a conta é grátis, sem cartão |
| Acesso ao Hex | A conexão usa a sua autorização |
| Projetos no Hex | São o que o agente vai pesquisar e rodar |
| Papel na empresa | Dono ou administrador definem conexões da empresa |
| Decisão de escopo | Pessoal, do time ou da empresa (veja abaixo) |
Como conectar o Hex na tela Conectores?#
A conexão é feita na tela Conectores, escolhendo o Hex e autorizando o acesso. O fluxo completo no DoubleX Agentes é este:
- Crie a conta e informe o segmento da empresa, o que quer melhorar e onde estão as informações.
- Faça o diagnóstico e transforme o resultado em uma equipe de agentes. Se preferir, crie um agente na tela Agentes descrevendo o que precisa com suas palavras.
- Abra a tela Conectores e escolha o Hex, na categoria de dados.
- Escolha o escopo da conexão: pessoal, do time ou da empresa.
- Autorize o acesso ao Hex quando solicitado.
- Volte ao agente e selecione o Hex entre os sistemas que ele pode usar.
- Defina quais ações o agente pode executar (veja a última seção).
- Faça o primeiro pedido na tela Tarefas.
A documentação de Conectores detalha como gerenciar conexões também por API, e o Início rápido resume os primeiros passos na plataforma.
Conexão pessoal, do time ou da empresa: qual escolher?#
Escolha pelo princípio de quem deve poder usar aquele acesso ao Hex. Uma conexão pessoal vale só para você; as conexões do time e da empresa ficam disponíveis para mais gente.
| Escopo | Quando usar | Cuidado |
|---|---|---|
| Pessoal | Você usa seus próprios projetos e quer testar com calma | Só vale para a sua pessoa |
| Do time | Uma área, como Finanças ou Produto, compartilha as mesmas análises | Defina quem do time usa o agente |
| Da empresa | Várias áreas consultam as mesmas análises | Revise bem as ações permitidas |
Um caminho seguro é começar com a conexão pessoal, validar as respostas e só depois ampliar para o time ou a empresa.
Como testar com um primeiro pedido e conferir o histórico na tela Tarefas?#
Faça um pedido simples e de baixo risco, como rodar uma análise que você já conhece, e compare a resposta com o que vê no Hex. Cada pedido vira uma tarefa com histórico completo: o pedido, cada ferramenta usada e o resultado.
Exemplos de pedidos para copiar:
- "Pesquise no Hex os projetos de vendas e liste os nomes que encontrar."
- "Rode a análise de retenção mensal no Hex e resuma o resultado em cinco linhas."
- "Rode o projeto de receita por região e me entregue um relatório com os principais pontos."
- "Procure no Hex alguma análise sobre custo de aquisição e diga o que ela mostra."
Depois, abra a tela Tarefas e confira quem pediu, quais ações o agente executou no Hex e quando. Se algo vier diferente do esperado, ajuste as instruções do agente ou o pedido e repita.
Como controlar quais ações o agente pode executar no Hex?#
No 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 apenas em modo de leitura.
Boas práticas:
- libere primeiro só pesquisar e rodar análises;
- crie agentes separados por área, cada um com as próprias permissões;
- lembre que o agente pede confirmação antes de enviar, apagar ou alterar algo nos sistemas e mostra o passo a passo do que fez;
- revise o histórico na tela Tarefas com regularidade.
As senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM, e o conteúdo da empresa não é usado para treinar modelos. Para uma visão geral da plataforma, veja a Introdução. Se o seu fluxo envolve outros sistemas de arquivos, o guia Como conectar o Box a um agente de IA segue a mesma lógica.
Perguntas frequentes#
Preciso saber programar para conectar o Hex?#
Não. Você descreve o que precisa com as próprias palavras, conecta o Hex na tela Conectores e pede as análises em linguagem comum. Quem quiser ir além tem API REST, CLI e servidor MCP.
O agente pode alterar os meus projetos no Hex?#
Só se você permitir. Em cada sistema você escolhe as ações liberadas, e as que alteram dados podem ficar desligadas. Antes de alterar algo, o agente pede confirmação.
Posso usar o Hex em uma rotina agendada?#
Sim. Você pode agendar o agente para rodar num horário, como toda segunda de manhã. A rotina usa as permissões de quem a criou.
Como sei o que o agente fez no Hex?#
Tudo fica registrado na tela Tarefas: o pedido, cada ferramenta usada e o resultado, com quem pediu e quando.
Os dados da minha empresa treinam modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores que não usam o que recebem para treinamento. Cada empresa também tem o próprio banco de dados, separado das outras.
Guias relacionados
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.
- 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.