Como conectar o Amplitude a um agente de IA passo a passo

· DoubleX

Resposta rápida

Para conectar o Amplitude a um agente de IA, crie o agente, abra a tela Conectores, adicione o Amplitude e autorize o acesso com a sua conta. Depois escolha quais ações o agente pode usar e faça um pedido de teste. No DoubleX Agentes, o histórico da tarefa mostra o que foi consultado.

Quem trabalha com produto e dados costuma abrir o Amplitude várias vezes por semana só para responder perguntas parecidas: como foi o funil, qual coorte retém mais, como está o experimento. Um agente de IA conectado ao Amplitude pode buscar essas respostas por você. Este guia mostra o caminho de conexão, a escolha de permissões e um primeiro teste seguro.

O que o agente de IA consegue fazer com o Amplitude?#

Um agente conectado ao Amplitude consulta gráficos, eventos, coortes e experimentos e explica os resultados em linguagem de negócio. Ele lê os dados e responde; você decide o que fazer com a resposta.

TarefaComo o agente ajudaDado consultado
Acompanhar um gráficoBusca o gráfico e resume a variaçãoGráficos
Entender uso do produtoLista os eventos e compara períodosEventos
Comparar grupos de usuáriosDescreve a coorte e o que a diferenciaCoortes
Avaliar um testeResume o andamento e o resultadoExperimentos

Para exemplos de análises e rotinas prontas depois da conexão, veja o guia Amplitude com agente de IA: análises, rotinas e exemplos de pedidos.

O que preparar antes de conectar?#

Preparar o acesso antes evita travar no meio da conexão. Você precisa de três coisas:

  • Uma conta no DoubleX Agentes. Criar a conta é grátis e não pede cartão.
  • Um login no Amplitude que já enxergue os gráficos, coortes e experimentos que você quer consultar. O agente trabalha com o que a conexão permite ver.
  • Uma pergunta simples para o primeiro teste, como "quais eventos existem no projeto?".

Se ainda não sabe por onde começar, 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 é grátis, e o resultado pode virar uma equipe de agentes com um clique. O fluxo geral está no Início rápido.

Como conectar o Amplitude na tela Conectores?#

A conexão é feita na tela Conectores: você escolhe o Amplitude na lista e autoriza o acesso. Siga este passo a passo no DoubleX Agentes:

  1. Crie a conta e, se quiser, faça o diagnóstico para gerar um agente já com as instruções da sua empresa. Também é possível criar o agente na tela Agentes, descrevendo o que ele deve fazer com as suas palavras.
  2. Abra a tela Conectores e procure o Amplitude, que está na categoria de dados.
  3. Inicie a conexão e autorize o acesso com a sua conta do Amplitude.
  4. Defina de quem é a conexão: pessoal, do time ou da empresa.
  5. Volte à tela Agentes, abra o agente que vai analisar os dados e ative o Amplitude para ele.

Para quem quer automatizar a criação de conexões por código, a referência está em Conectores na API.

Como escolher quais ações o agente pode usar e quem acessa a conexão?#

Para cada agente, você escolhe quais sistemas ele usa e, dentro de cada sistema, quais ações pode executar. No caso do Amplitude, a conexão serve para consultar gráficos, eventos, coortes e experimentos, então vale liberar só o que a rotina do agente precisa.

Boas práticas:

  • Dê o Amplitude apenas aos agentes que de fato analisam produto, e não a todos.
  • Se alguma ação puder alterar dados, deixe desligada no começo, mantendo o agente em modo de leitura.
  • Use conexão do time quando várias pessoas dependem dos mesmos dados, e pessoal quando o acesso deve ficar restrito a você.
  • Lembre que papéis de dono, administrador e membro, além de times, controlam quem gerencia e quem usa cada conexão.

Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM. O conteúdo da empresa não é usado para treinar modelos.

Como testar com um primeiro pedido e conferir o histórico da tarefa?#

O melhor teste é um pedido pequeno, de leitura, cuja resposta você consegue conferir no próprio Amplitude. Cada pedido vira uma tarefa na tela Tarefas, com o pedido, cada ferramenta usada e o resultado.

Pedidos que você pode copiar:

  • "Liste os eventos disponíveis no Amplitude e diga quais parecem ligados ao cadastro de novos usuários."
  • "Busque o gráfico de usuários ativos da última semana e resuma o que mudou em relação à semana anterior."
  • "Mostre as coortes existentes e explique em uma frase o que cada uma representa."
  • "Quais experimentos estão em andamento? Resuma o status de cada um."

Depois da resposta, abra a tarefa e confira o histórico: veja quais ferramentas do Amplitude o agente chamou e compare os números com a tela do Amplitude. Se bater, o acesso está validado. Quando um agente for enviar, apagar ou alterar algo em outros sistemas, ele pede confirmação antes e mostra o passo a passo do que fez.

O que fazer se o agente não trouxer os dados esperados?#

Quando a resposta vem vazia ou diferente do esperado, o problema quase sempre está no acesso, no pedido ou no agente. Revise nesta ordem:

  1. Abra a tarefa e veja o histórico: o agente chegou a usar o Amplitude? Se não, o conector pode não estar ativado para aquele agente.
  2. Confira na tela Conectores se a conexão está ativa e se foi autorizada com uma conta que enxerga esses dados.
  3. Verifique as ações liberadas para o agente: se a ação necessária estiver desligada, ele não consegue executá-la.
  4. Reescreva o pedido com o nome exato do gráfico, evento, coorte ou experimento, e o período desejado.
  5. Se a conexão for pessoal, lembre que ela só vale para quem a criou; outras pessoas precisam de uma conexão do time ou da empresa.

Conectar outros sistemas segue o mesmo caminho. Veja, por exemplo, como conectar o Box ou o Jam.

Perguntas frequentes#

Preciso programar para conectar o Amplitude?#

Não. A conexão é feita na tela Conectores e o agente é criado descrevendo o que você precisa com as suas palavras. Quem quiser ir além pode usar a API REST, a CLI e o servidor MCP.

O agente pode alterar dados no Amplitude?#

O uso do Amplitude no produto é voltado a consultar gráficos, eventos, coortes e experimentos. Além disso, você escolhe as ações que cada agente pode executar e pode manter tudo em leitura.

Posso fazer o agente consultar o Amplitude todo dia?#

Sim. Você pode agendar uma rotina, por exemplo todo dia às 8h ou toda segunda, e ela roda com as permissões de quem a criou. Detalhes de automação estão em Gatilhos.

Quem na empresa vê a conexão com o Amplitude?#

Depende do tipo: pessoal, só para você; do time, para as pessoas do time; da empresa, para toda a empresa. Os papéis de dono, administrador e membro também definem o que cada pessoa gerencia.

Os dados do Amplitude 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. Há também a opção de retenção zero na tela Modelos.

Quanto custa testar a conexão?#

Criar a conta e fazer o primeiro diagnóstico é grátis, sem cartão. O uso da IA consome créditos, e cada empresa tem um limite; quando acaba, o uso para, sem conta surpresa.

Guias relacionados

Mais guias de Amplitude