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 acessaPara que serve
EventosVer o que os usuários fizeram no produto
InsightsLer gráficos e análises já criados
Feature flagsConferir quais funcionalidades estão ligadas
ExperimentosConsultar 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:

  1. Entre na sua conta e abra a tela Conectores.
  2. Procure por PostHog, que está na categoria de dados.
  3. Inicie a conexão e autorize o acesso na sua conta do PostHog, se o fluxo pedir.
  4. Defina o alcance da conexão: pessoal (vale só para você), do time ou da empresa.
  5. 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.

  1. Abra a tela Agentes e selecione um agente existente, ou crie um novo descrevendo o que ele deve fazer.
  2. Na configuração dele, adicione o conector PostHog.
  3. Revise a lista de ações do conector e deixe ligadas só as necessárias.
  4. Mantenha desligadas as ações que alteram dados, se o objetivo é apenas consultar. Assim o agente fica em modo de leitura.
  5. 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:

  1. Abra a tela Tarefas.
  2. Selecione a tarefa do seu teste.
  3. 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

Mais guias de PostHog