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:

ItemPor que importa
Conta no DoubleX AgentesCriar a conta é grátis, sem cartão
Acesso ao HexA conexão usa a sua autorização
Projetos no HexSão o que o agente vai pesquisar e rodar
Papel na empresaDono ou administrador definem conexões da empresa
Decisão de escopoPessoal, 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:

  1. Crie a conta e informe o segmento da empresa, o que quer melhorar e onde estão as informações.
  2. 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.
  3. Abra a tela Conectores e escolha o Hex, na categoria de dados.
  4. Escolha o escopo da conexão: pessoal, do time ou da empresa.
  5. Autorize o acesso ao Hex quando solicitado.
  6. Volte ao agente e selecione o Hex entre os sistemas que ele pode usar.
  7. Defina quais ações o agente pode executar (veja a última seção).
  8. 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.

EscopoQuando usarCuidado
PessoalVocê usa seus próprios projetos e quer testar com calmaSó vale para a sua pessoa
Do timeUma área, como Finanças ou Produto, compartilha as mesmas análisesDefina quem do time usa o agente
Da empresaVárias áreas consultam as mesmas análisesRevise 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

Mais guias de Hex