Event Discovery Agent

Event Discovery Agent reviews the web Autocapture data your project already collects, identifies your core product flows, and suggests labeled events for the key interactions in them. It runs weekly and places its suggestions on the Agent-Suggested tab for review. Amplitude adds nothing to your taxonomy until someone accepts a suggestion.

Use Event Discovery Agent when you run web Autocapture and want to find the interactions worth tracking without defining each event by hand. Use Visual Labeling when you want to interactively select and name specific elements on your site yourself.

Event Discovery Agent is in Beta. If you have any questions, contact Amplitude Support. Contact your Amplitude representative to request access.

How Event Discovery Agent works

Each run, Event Discovery Agent reads the Autocapture events in your project, such as Page Viewed, Element Clicked, and Element Changed. From those events, it identifies the sequences of interactions that make up your core product flows. For each interaction worth tracking, it drafts a labeled event: a name, a description, a category, and a definition that matches the element on your site. It then checks how reliable that definition is likely to be and how much the event matters to your analysis.

Suggestions don't add to your event volume. A labeled event is a definition layered on top of Autocapture data you already collect, so accepting a suggestion labels existing events instead of sending new ones. For more on how labeled events relate to volume, go to Labeled events and event volume.

Run schedule

During the beta, Event Discovery Agent runs once a week. A run usually takes 1 to 2 hours. The agent creates suggestions only when it finds interactions worth tracking, so a run can finish with no new suggestions.

How the agent avoids duplicates

Before it suggests an event, Event Discovery Agent checks for overlap with:

• Events already in your taxonomy, including instrumented events, custom events, and labeled events.
• Suggestions that are still open on the Agent-Suggested tab.
• Suggestions someone dismissed.

The agent doesn't edit or delete existing events. If the agent finds more evidence for an interaction it suggested before, it can suggest a similar event in a later run, even if someone dismissed the earlier suggestion.

Requirements

Event Discovery Agent works with web Autocapture data from the Browser SDK. It reads page views and element interactions (Element Clicked and Element Changed). You can turn on element interactions and other Autocapture event types with remote configuration. For the events the agent reads, go to Web Autocapture Schema. The agent works best when your project has at least 10,000 web Autocapture events in the last 30 days.

To check your current Autocapture volume, use either method:

• In Amplitude Data, go to Events and check the 30 Day Volume column for web Autocapture events such as Page Viewed and Element Clicked.
• Build an Event Segmentation chart that measures event totals for the web Autocapture events over the last 30 days.

Permissions

What a user can do with Event Discovery Agent depends on their role in the project.

Open suggestions appear in event dropdowns only while Event Discovery Agent is on. When the agent is off, suggestions remain on the Agent-Suggested tab but don't appear in dropdowns for anyone.

Turn on Event Discovery Agent

Event Discovery Agent runs per project. To turn it on for a project:

1. In Amplitude Data, go to Event Discovery Agent.
2. Turn on Enable Event Discovery Agent.
3. Review the confirmation, then click Enable and start a run.

The first run starts immediately and usually takes 1 to 2 hours. After that, the agent runs weekly. If a run is already in progress, or a run finished successfully in the last 12 hours, turning on the agent doesn't start another run. The next run starts on the weekly schedule.

To turn the agent on for another project, switch to that project and repeat these steps.

When you turn off Enable Event Discovery Agent, Amplitude stops any run in progress and cancels future runs. It also turns off Show suggestions in event dropdowns before they are accepted. Suggestions you already received stay on the Agent-Suggested tab.

Control who sees suggestions outside Amplitude Data

The Show suggestions in event dropdowns before they are accepted setting controls whether open suggestions appear in event dropdowns across Amplitude, marked as agent-suggested.

• On: All users can find and use open suggestions in event dropdowns.
• Off: Members and viewers see suggestions only on the Agent-Suggested tab. Admins and managers can always use suggestions in event dropdowns to test them before wider rollout.

You can change this setting only while Event Discovery Agent is on.

Give the agent context about your product

Context is optional, but it helps the agent name events the way your team does and focus on the parts of your product that matter. Add or change context at any time. Saved context applies to future runs, not runs already in progress.

Event Discovery Agent reads context from these sources:

• Context instructions: Free text you enter on the Event Discovery Agent settings page, up to 10,000 characters. Amplitude recommends 1,000 to 3,000 characters.
• Context files: Files you upload, such as data dictionaries, naming guides, or product specs. Supported formats are TXT, MD, HTML, DOC, DOCX, PDF, CSV, XLS, and XLSX, up to 25 MB per file.
• AI Controls context: The organization and project context set in AI Controls.

Context instructions and files are project-scoped. Other Amplitude AI agents in the project can use them too. Amplitude can also use uploaded files to add descriptions and context to your existing events and properties. To manage uploaded files, go to AI Controls.

Naming conventions

To name suggested events, the agent uses the first of these sources that states a naming convention:

1. Your Event Discovery Agent context instructions and context files.
2. The naming convention in your Amplitude Data settings.
3. Your AI Controls context files, then project context, then organization context.
4. The convention most of your existing events already follow.
5. A product area followed by the object and a past-tense action, in Title Case, for example Projects | Project Created.

What to include in context instructions

Short, specific instructions work best. Useful topics include:

To add context instructions:

1. In Amplitude Data, go to Event Discovery Agent.
2. On the What should Event Discovery Agent know about your product and taxonomy? card, click Edit.
3. Enter your instructions in Markdown, or click Upload markdown file.
4. Click Save.

To add context files:

1. On the Upload context files card, click Upload file.
2. Choose a file, then click Upload.

Monitor runs

The Recent runs table on the Event Discovery Agent settings page lists runs from the last 30 days and the next scheduled run time. Each run shows one of these statuses:

Click a run to view its progress through each step and download its reports.

To stop a pending or running run, click Cancel run on its row, then confirm. Amplitude keeps the steps the run already completed and their saved reports.

Run reports

Each completed run produces reports you can download from the run's details. The reports explain what the agent found and why. Use them to review suggestions in bulk or to share the suggested events with your engineering team.

You can preview some reports in Amplitude before you download them.

Get notified about new suggestions

Amplitude doesn't send notifications about Event Discovery Agent by default. To get an email or Slack message when new suggestions are available to review, opt in:

1. Go to Settings > Notifications.
2. Under Updates about my data, find New Event Discovery Agent suggestions are available for review.
3. Select Email, Slack, or both.

Review suggestions

Each suggestion includes a description, a category, a definition, an analytical value rating, and a verdict on how reliable its definition is likely to be. Review each suggestion, edit it if needed, then accept the ones you want in your taxonomy and dismiss the rest.

Find suggestions

1. In Amplitude Data, go to Events.
2. Click the Agent-Suggested tab.

The Open view lists suggestions waiting for review. The Dismissed view lists suggestions someone dismissed. A sparkle icon next to each name marks the event as agent-suggested.

For each suggestion, the table shows its name, category, analytical value, whether it's safe to accept, its occurrences in the selected date range, and when the agent created it. The list sorts by analytical value, highest first. To export open suggestions as a CSV file, click Download.

Review a suggestion

Click a suggestion to open its details panel. The panel includes:

• Analytical value: The rating and why the agent assigned it.
• Verdict note: Whether the suggestion is safe to accept and why.
• Description: What triggers the event, the user journey it belongs to, and how you might use it in analysis.
• Category: An existing category from your taxonomy that fits, or a new one the agent proposes.
• Occurrences: How often the event occurred in the last 30 days.
• Screenshot / GIF: A visual of the interaction, when available.
• Definition: The Autocapture event and the element selector the labeled event matches.

Use the agent's evidence and verdict as a starting point. Then confirm that the description and definition accurately capture the interaction you want.

To build a screenshot or GIF, the agent loads the public page where the event occurs and highlights the control. If that doesn't work, for example because the page requires a login, it uses a frame from a Session Replay recording, labeled Inferred event match. Some suggestions have no visual. Visuals are approximate representations of the event, so check the definition to confirm it tracks what you want.

Analytical value

Analytical value is the agent's estimate of how much an interaction is likely to matter for your analysis, based on how central it is to your core product flows.

Safe to accept

Each suggestion's definition relies on identifiers your site exposes, such as attributes, IDs, or classes on an element. Some identifiers are more stable than others. The Safe to Accept? column shows how well the definition matches the event it names and how likely it is to keep working as your site changes.

The agent checks two things:

• Durability: Whether the identifier is likely to survive changes to your site.
• Accuracy: Whether the definition counts only the control the event name describes.

In the details panel, the verdict appears as Safe to accept or Check before accepting, with a note that explains the reason in plain language. When the agent flags a suggestion, the note also suggests a fix, such as asking your engineering team to add a fixed identifier to the control.

A definition is more durable when it uses an identifier that's specific to the element and unlikely to change:

Accuracy issues usually mean the definition is broader than the name. For example, the name calls the control a button, but the agent recorded the click on a container around it.

A Yes verdict reflects your site at the time the agent reviewed it. The verdict can't guarantee long-term reliability, because changes to your site's code can still affect the definition. If an accepted event stops collecting data, go to Repair a labeled event.

Edit and test a suggestion

Before you accept a suggestion, you can update its name, description, category, and definition directly in the details panel.

To check the data before you accept a suggestion, click Create Chart in the details panel. Amplitude opens a chart with the suggested event so you can confirm the volume and trend match what you expect. Volume far above or below what you expect can mean the definition matches a different element.

Admins and managers can always chart a suggestion before it's accepted. Other users can chart it only when the Show suggestions in event dropdowns before they are accepted setting is on.

Accept or dismiss a suggestion

• Accept: Click Accept in the details panel. Amplitude adds the event to your Labeled Events tab and no longer marks it as agent-suggested.
• Dismiss: Click Dismiss. The suggestion moves to the Dismissed view.

To restore a dismissed suggestion, open it from the Dismissed view, click Restore, and confirm. The suggestion returns to the Open view for review.

The agent checks dismissed suggestions so it doesn't suggest the same event again right away. If a later run finds more evidence for the interaction, the agent can suggest a similar event.

To work through a long list, click Add Filter to narrow the Open view by category, 30 Day Occurrences, 30 Day Queries, Analytical Value, Safe to Accept?, or Created Date. For example, filter to High analytical value and Yes to review the most valuable, most reliable suggestions first. To dismiss several suggestions at once, select them in the list, then click Dismiss.

Share feedback

Amplitude's product team reads all feedback to shape Event Discovery Agent.

• Rate a suggestion: In the suggestion's details panel, click the thumbs icon and choose Good suggestion, Neutral suggestion, or Not a good suggestion. Add a comment, then click Submit feedback.
• Share overall feedback: On the Agent-Suggested tab, click Give feedback and answer the short survey about what's working and what isn't.