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.
| Tarefa | Como o agente ajuda | Dado consultado |
|---|---|---|
| Acompanhar um gráfico | Busca o gráfico e resume a variação | Gráficos |
| Entender uso do produto | Lista os eventos e compara períodos | Eventos |
| Comparar grupos de usuários | Descreve a coorte e o que a diferencia | Coortes |
| Avaliar um teste | Resume o andamento e o resultado | Experimentos |
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:
- 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.
- Abra a tela Conectores e procure o Amplitude, que está na categoria de dados.
- Inicie a conexão e autorize o acesso com a sua conta do Amplitude.
- Defina de quem é a conexão: pessoal, do time ou da empresa.
- 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:
- 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.
- Confira na tela Conectores se a conexão está ativa e se foi autorizada com uma conta que enxerga esses dados.
- Verifique as ações liberadas para o agente: se a ação necessária estiver desligada, ele não consegue executá-la.
- Reescreva o pedido com o nome exato do gráfico, evento, coorte ou experimento, e o período desejado.
- 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
- 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.