Vercel Agent Investigation

When you get an error alert, Vercel Agent can investigate what's happening in your logs and metrics to help you figure out the root cause. Instead of manually digging through data, AI will do the detective work and display highlights of the anomaly in the Vercel dashboard.

Investigations happen automatically when an error alert fires. The AI digs into patterns in your data, checks what changed, and gives you insights about what might be causing the issue.

You'll need two things before you can use Agent Investigation:

1. An Observability Plus subscription
2. Sufficient credits to cover the cost of an investigation

To allow investigations to run automatically for every error alert, you should enable Vercel Agent Investigations for your team.

You can run an investigation manually if you want to investigate an alert that has already fired.

To run investigations automatically for every error alert, enable Vercel Agent Investigations in your team's settings:

1. Go to your team's Settings page.
2. In the General section, find Vercel Agent and under Investigations, switch the toggle to Enabled.
3. Select Save to confirm your changes.

Once enabled, investigations will run automatically when an error alert fires, provided you have sufficient credits. You'll need to make sure your team has enough credits to cover the cost of investigations.

When Agent Investigations are enabled, they run automatically when an error alert fires. The AI queries your logs and metrics around the time of the alert, looks for patterns that might explain the issue, checks for related errors or anomalies, and provides insights about what it found.

To view an investigation:

1. Go to your Vercel dashboard and navigate to Observability, then Alerts.
2. Find the alert you want to review and click on it.
3. The investigation results will appear alongside your alert details. You'll see the analysis stream in real time if the investigation is still running.

If you want to run the investigation again with fresh data, click the Rerun button.

If you do not have Agent Investigations enabled and running automatically, you can run an investigation manually from the alert details page.

1. Go to your Vercel dashboard and navigate to Observability, then Alerts.
2. Find the alert you want to review and click on it.
3. Click the Investigate (or Rerun) button to run an investigation manually.

Agent Investigation uses a credit-based system. Each investigation costs a fixed $0.30 USD plus token costs billed at the Agent's underlying AI provider's rate, with no additional markup. The token cost varies based on how much data the AI needs to analyze from your logs and metrics.

Pro teams can redeem a $100 USD promotional credit when enabling Agent. You can purchase credits and enable auto-recharge in the Agent tab of your dashboard. For complete pricing details, credit management, and cost tracking information, see Vercel Agent Pricing.

To disable Agent Investigation:

1. Go to the your team's Settings page.
2. In the General section, find Vercel Agent and under Investigations, switch the toggle to Disabled.
3. Select Save to confirm your changes.

Once disabled, Agent Investigation won't run automatically on any new alerts. You can re-enable Agent Investigation at any time from the same menu or run an investigation manually from the alert details page.