Como conectar o PostHog a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o PostHog a um agente de IA no DoubleX Agentes, abra a tela Conectores, adicione o PostHog e autorize o acesso. Depois, escolha quais agentes usam o conector e quais ações cada um pode executar. Teste com uma pergunta simples sobre eventos e confira o histórico da tarefa.
O PostHog guarda os eventos, os insights, as feature flags e os experimentos do seu produto. Quem precisa dessas informações muitas vezes depende de alguém para abrir o painel e montar a consulta. Conectar o PostHog a um agente de IA permite perguntar com as próprias palavras, mantendo você no controle do que o agente pode acessar.
Este guia cobre só a configuração. Para exemplos de análises e rotinas, veja o guia PostHog com agente de IA: exemplos de pedidos e rotinas.
O que o conector do PostHog permite ao agente fazer?#
O conector do PostHog permite que o agente consulte eventos, insights, feature flags e experimentos da sua conta. Conector é um sistema ligado à plataforma, cujas ferramentas os agentes passam a usar.
| O que o agente acessa | Para que serve |
|---|---|
| Eventos | Ver o que os usuários fizeram no produto |
| Insights | Ler gráficos e análises já criados |
| Feature flags | Conferir quais funcionalidades estão ligadas |
| Experimentos | Consultar testes em andamento ou encerrados |
O que o agente pode de fato executar depende das ações que você liberar, como mostramos mais abaixo.
O que preparar antes de conectar?#
Você precisa de uma conta no DoubleX Agentes e de acesso à sua conta do PostHog, com uma pessoa que possa autorizar a conexão. Criar a conta é grátis e não pede cartão.
Antes de começar, deixe separado:
- o e-mail e o acesso ao PostHog que serão usados na autorização;
- a definição de quem vai usar o conector (só você, o time ou a empresa);
- o nome do agente que vai consultar os dados, ou a intenção de criar um novo.
Se você ainda não tem agentes, faça o diagnóstico: uma conversa de 5 a 10 minutos com a consultora de IA do produto sobre a rotina da empresa. O primeiro diagnóstico é grátis e, com um clique, vira uma equipe de agentes pronta para testar. Veja mais no Início rápido.
Como adicionar o conector PostHog na tela Conectores?#
Você adiciona o PostHog na tela Conectores, escolhendo o conector na lista e autorizando o acesso à sua conta. O passo a passo no DoubleX Agentes:
- Entre na sua conta e abra a tela Conectores.
- Procure por PostHog, que está na categoria de dados.
- Inicie a conexão e autorize o acesso na sua conta do PostHog, se o fluxo pedir.
- Defina o alcance da conexão: pessoal (vale só para você), do time ou da empresa.
- Confirme e veja o PostHog aparecer como conectado na lista.
Os dados de acesso das conexões, como senhas, tokens e chaves, ficam criptografados com AES-256-GCM. Detalhes técnicos de conectores estão na documentação de Conectores.
Como escolher quais agentes usam o PostHog e quais ações podem executar?#
Na tela Agentes, você abre o agente desejado, ativa o PostHog entre os conectores dele e marca as ações permitidas. Para cada agente, a empresa escolhe quais sistemas ele usa e, em cada sistema, o que ele pode fazer.
- Abra a tela Agentes e selecione um agente existente, ou crie um novo descrevendo o que ele deve fazer.
- Na configuração dele, adicione o conector PostHog.
- Revise a lista de ações do conector e deixe ligadas só as necessárias.
- Mantenha desligadas as ações que alteram dados, se o objetivo é apenas consultar. Assim o agente fica em modo de leitura.
- Salve as alterações.
Uma boa prática é separar agentes por área: um agente de produto com acesso ao PostHog e um agente comercial sem esse acesso. Cada um tem as próprias instruções, sistemas e permissões. Saiba mais sobre papéis e compartilhamento na Introdução.
Como testar a conexão com uma primeira pergunta sobre eventos?#
Peça ao agente algo simples e fácil de conferir, como listar eventos recentes. Se ele responder com dados que batem com o PostHog, a conexão está funcionando.
Exemplos de pedidos para o primeiro teste:
- "Liste os eventos mais recentes registrados no PostHog."
- "Quais feature flags existem hoje no nosso projeto?"
- "Mostre os insights que temos salvos no PostHog."
- "Quais experimentos estão cadastrados e qual o status de cada um?"
Compare a resposta com o que você vê no próprio PostHog. Se algo não bater, volte à tela Conectores e confira se a conexão está ativa e se o agente tem o PostHog habilitado.
Como conferir o histórico da tarefa para ver o que o agente consultou?#
Cada pedido vira uma tarefa na tela Tarefas, com o pedido, cada ferramenta que o agente usou e o resultado. Dá para saber quem pediu, o que foi feito e quando.
Para conferir:
- Abra a tela Tarefas.
- Selecione a tarefa do seu teste.
- Veja quais ferramentas do PostHog o agente chamou e o que cada uma devolveu.
Esse registro ajuda a validar as permissões e a entender como o agente chegou à resposta. Com tudo configurado, siga para os exemplos de pedidos e rotinas com PostHog.
Perguntas frequentes#
Preciso saber programar para conectar o PostHog?#
Não. A conexão é feita na tela Conectores e o agente é montado a partir da descrição do que você precisa. Quem quiser ir além tem API REST, CLI e servidor MCP.
O agente pode alterar minhas feature flags sem eu saber?#
Só se você liberar ações que alteram dados. Você pode deixá-las desligadas e manter o agente em leitura. Antes de alterar algo, o agente pede confirmação e tudo fica no histórico da tarefa.
Os dados do PostHog são usados para treinar modelos?#
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.
Posso usar o mesmo conector PostHog em vários agentes?#
Sim. Você escolhe, agente por agente, se o PostHog fica ativo e quais ações cada um pode executar.
Quanto custa conectar o PostHog?#
Criar a conta e fazer o primeiro diagnóstico é grátis, sem cartão. O uso da IA consome créditos, conforme o plano da empresa, e quando o limite acaba o uso para, sem conta surpresa.
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.