AI troubleshooting agent

The AI Troubleshooting Agent helps you diagnose and resolve pipeline failures directly from the Activity view. When a pipeline run fails, click Help Me Fix It next to the error to receive an AI-generated diagnostic report with actionable resolution steps — without opening a support ticket. Reports are generated on demand only; no report is created automatically when a pipeline fails.

Prerequisites

Enable AI troubleshooting feature.

note

To enable or disable AI troubleshooting feature for your organization, you must have the account admin role.

Using the AI Troubleshooting Agent

View a diagnostic report for a failed pipeline run

In the Activity view, click a failed run row. The run detail panel opens on the right, showing the table, duration, and any errors in the Warning/Error column.
In the Warning/Error column, click Help Me Fix It next to the error message.
note
If you have already requested a diagnostic report for this run, it appears instantly. Otherwise, a loading state displays while the agent generates the report.
Review the diagnostic report in the AI-Powered Assistant Solution panel. It includes:
- A header showing the source and target table path. For example, employees.employees_new.actor → testing_db.
- An error callout box with the error message.
- An Issue Summary with the flow type and root cause analysis.
- Action Steps with resolution instructions and credential or configuration details to verify.
- A note at the bottom reminding you to verify the accuracy of the AI-generated suggestions.

Enable or disable AI troubleshooting for your account

Account admins can turn the AI Troubleshooting on or off for all users in the account.

Navigate to Settings > Account Settings.
Locate the Enable AI Features toggle.
Set the toggle to ON or OFF:
- ON: The Help Me Fix It appears on failed pipeline runs.
- OFF: The Help Me Fix It is hidden and no data is transmitted to AI services.
Click Save.

The changes are reflected immediately.