How to Connect Amplitude to an AI Agent: Step-by-Step Guide

· DoubleX

Quick answer

To connect Amplitude to an AI agent, open the Connectors screen in DoubleX Agentes, choose Amplitude, authorize access, then pick which agent can use it and which actions it may run. Validate the setup with a simple read-only request, such as asking for last week's key events, and check the task history.

Amplitude holds the product data your team checks again and again: events, charts, cohorts, and experiment results. An AI agent can read that data for you and turn it into answers, but only after you connect it properly. This guide walks you through the connection, the permissions, and a first test that confirms everything works before you rely on it.

What can an AI agent do with Amplitude?#

An AI agent connected to Amplitude can query charts, events, cohorts, and experiments and explain the results in plain language. Instead of opening dashboards and comparing tabs, you ask a question and the agent runs the lookup for you.

An AI agent is an assistant that uses a model, written instructions, and connected tools to complete a task in your systems. Here is how that looks with Amplitude:

TaskHow the agent helpsWhere the data comes from
Weekly product check-inPulls key events and summarizes changesAmplitude charts and events
Audience questionsLooks up cohorts and describes themAmplitude cohorts
Experiment reviewReads experiment results and drafts a summaryAmplitude experiments
ReportingDelivers the findings as a report or spreadsheetAmplitude plus an artifact

For deeper examples of requests and scheduled routines, see Amplitude with an AI Agent: Analytics Requests and Routines.

What should you prepare before connecting?#

Before connecting, make sure you have an Amplitude account you can sign in to and know which questions you want the agent to answer. Having both ready keeps the setup short and the permissions focused.

Use this checklist:

ItemWhy it matters
A DoubleX Agentes accountCreating it is free and needs no card
Access to your Amplitude accountThe connection uses the access you authorize
One or two target questionsHelps you choose the right permissions
A decision on who should use itConnections can be personal, for a team, or for the company

If you are new to the platform, the Quickstart shows how to create the account and run the first diagnostic. The diagnostic is a 5 to 10 minute conversation with the product's AI consultant about your routine, and it points out where AI helps most.

How do you connect Amplitude on the Connectors screen?#

You connect Amplitude from the Connectors screen by selecting it from the list and authorizing access to your account. After that, agents can use its tools.

  1. Create your account at DoubleX Agentes and, if you like, complete the diagnostic so the platform suggests a starting team of agents.
  2. Open the Connectors screen.
  3. Find Amplitude in the analytics and data options.
  4. Start the connection and authorize access with your Amplitude account.
  5. Choose the scope of the connection: personal, for a team, or for the company.
  6. Open the Agents screen and pick the agent that should use Amplitude, or create a new one by describing what it should do in your own words.
  7. Enable Amplitude for that agent and review its actions before you run anything.

If you want to manage connectors programmatically, the Connectors API reference covers it.

How do you choose which actions the agent can use and who can access the connection?#

You control access on two levels: which systems each agent can use, and which actions it may run inside each system. You also decide who can use the connection itself.

For Amplitude, most teams only need to read data, so keep the allowed actions to the lookup tools for charts, events, cohorts, and experiments. Actions that change data can stay switched off, which leaves the agent in read-only mode.

On sharing, think about who really needs the data:

  • Personal connection: only you can use it, which is a good choice while testing.
  • Team connection: the people on a team share it, useful for a product or growth group.
  • Company connection: available across the company, best for data that everyone is meant to see.

The platform also uses roles (owner, administrator, member) and lets you share by person, team, or company. Stored credentials and tokens are encrypted with AES-256-GCM, and your content is not used to train models.

How do you test with a first request and check the task history?#

Test with one simple, read-only question and then open the task to see exactly what the agent did. Every request becomes a task with a full history: the request, each tool the agent used, and the result.

Try one of these requests:

  • "Show me the top events in Amplitude for the last 7 days and summarize what changed."
  • "List the cohorts available in our Amplitude account."
  • "Which experiments are running right now, and what do the latest results show?"
  • "Pull the sign-up chart for last month and explain the trend in three sentences."

Then open the Tasks screen and check three things: that the agent called the Amplitude tools, that the numbers match what you see in Amplitude, and that nothing ran that you did not expect. Because the agent asks for confirmation before sending, deleting, or changing anything, a read-only test carries little risk.

Once the answers look right, you can ask for a report delivered as an artifact, or set up a recurring routine. See Triggers for how scheduled runs work.

What if the agent does not return the data you expected?#

If the data looks wrong or empty, first check the task history to see which Amplitude tool the agent called and what it received. Most problems come from access, a vague question, or a disabled action.

Work through these checks:

  1. Connection status: on the Connectors screen, confirm Amplitude is still authorized. Reconnect if needed.
  2. Agent permissions: make sure Amplitude and the lookup actions are enabled for that agent.
  3. Scope: a personal connection only works for the person who created it.
  4. The question itself: name the chart, event, cohort, or date range instead of asking something broad.
  5. Comparison: open the same view in Amplitude and compare it with the agent's answer.

If you are connecting other tools next, the steps are similar. For example, see How to Connect Jam to an AI Agent.

Frequently asked questions#

Do I need to write code to connect Amplitude?#

No. You connect it from the Connectors screen and describe what you need in your own words. APIs and a command line exist for people who want to go further.

Can the agent change my Amplitude data?#

You decide. For each system you choose which actions the agent can run, and actions that change data can stay off. Before sending, deleting, or changing anything, the agent asks for confirmation.

Who can use the Amplitude connection?#

It depends on the scope you pick: just you, a team, or the whole company. Start narrow and widen access once the results look right.

Can I run Amplitude checks on a schedule?#

Yes. Agents can work on a schedule, such as every day at 8 a.m. or every Monday, and the routine runs with the permissions of whoever created it.

Is my Amplitude data used to train AI models?#

No. Your content is not used to train models, and requests only go to AI providers that do not use what they receive for training. A zero-retention option is also available.

Related guides

More Amplitude guides