Product Guides
Unblocked PR Failure Agent
Automatically analyze CI failures and get actionable fix suggestions
Overview
Debugging CI (Continuous Integration) failures in pull requests can be time-consuming and complex. Unblocked streamlines this process by automatically analyzing failure logs and providing actionable fix suggestions when it has high confidence in the root cause of the failure. When a CI job fails on a pull request, Unblocked will post a report as a comment in your pull request, helping you quickly identify and resolve the issue.Connecting CI Systems
Today Unblocked supports Bitbucket Pipelines, Buildkite, CircleCI, GitHub Actions, and GitLab Pipelines. Select the CI system you’d like to configure:Configuring Bitbucket Pipelines
To connect Bitbucket Pipelines to Unblocked, follow these steps:1
Add CI Data Source
In the left sidebar, click on Data Sources. Then click on Add another
data source and choose Continuous Integration.
2
Connect Bitbucket Pipelines
Click on the Bitbucket Pipelines tile. 
3
Enable PR Failure Agent
Click Select Repositories to choose the repositories
you want to enable PR Failure Agent on. 
4
Select Repositories
Toggle the repositories you want to enable by selecting them.
5
Create a Bot Account
CI reports from the PR Failure Agent need to be posted on behalf of a Bitbucket user account. We recommend
creating an Unblocked bot account for this specific purpose.
Already have a bot account?
Some teams already have a bot account they use for posting automated messages. If you already have a bot account that you can repurpose for posting CI analysis reports, select it and skip to the next step.
- Create a new account in Bitbucket with the following information:
- Name: Unblocked
- Avatar: download and use the Unblocked logo below
- Switch accounts and sign in to your Bitbucket Workspace as a Workspace admin.
- Click the gear icon in the top right of the navigation bar, and select User Management.
- Invite your new bot user to your workspace.
- Accept the email invitation that was sent to your bot account.
6
Select your Bot Account
Search for the Bot Account you just created and select it. You may be required
to authorize this account with Unblocked. 
7
Done
Click Save Settings to apply your changes. Now Unblocked will analyze CI
failures in the selected repositories and post reports to pull requests.
Configuring PR Failure Agent Reports in Personal Settings
By default, Unblocked will post reports for all developers in your organization when it has high confidence in the root cause of a CI failure. As a developer, you can control this behavior for your pull requests:- Navigate to Settings in your Unblocked dashboard
- Select Preferences under the Personal Settings section
- Locate the PR Failure Agent toggle and set it according to your preference
