Correção automática de builds de CI com falha

Não quer configurar isso manualmente? Cole um link para esta página em uma sessão do Devin e peça para ele configurar tudo para você.

Armazene sua chave da API do Devin no GitHub

The workflow calls Devin’s v3 API to create sessions programmatically. Create a service user and store its token as a GitHub Actions secret:

Go to app.devin.ai > Settings > Devin API > Service users and create a service user with a role that includes the Use Devin sessions (UseDevinSessions) permission — creating sessions requires this permission, and ManageOrgSessions alone does not grant it
Copy the API token shown after creation — it’s only displayed once
In your GitHub repo, navigate to Settings > Secrets and variables > Actions
Add two secrets: DEVIN_API_KEY (the token) and DEVIN_ORG_ID (your organization ID, shown at the top of the Settings > Devin API page)

Certifique-se de que o repositório já está configurado na Máquina do Devin para que o Devin possa cloná-lo, compilá-lo e fazer push para ele.

Adicione o arquivo de workflow

Create .github/workflows/devin-ci-fix.yml. This workflow fires whenever your existing CI workflow completes with a failure, extracts the failing job names, and calls the Devin API to start a fix session:

name: Auto-fix CI with Devin

on:
  workflow_run:
    workflows: ["CI"]
    types: [completed]

jobs:
  trigger-devin-fix:
    if: >
      github.event.workflow_run.conclusion == 'failure' &&
      github.event.workflow_run.pull_requests[0]
    runs-on: ubuntu-latest
    steps:
      - name: Get failure details
        id: failure
        uses: actions/github-script@v7
        with:
          script: |
            const run = context.payload.workflow_run;
            const pr = run.pull_requests[0];
            const jobs = await github.rest.actions.listJobsForWorkflowRun({
              owner: context.repo.owner,
              repo: context.repo.repo,
              run_id: run.id
            });
            const failed = jobs.data.jobs
              .filter(j => j.conclusion === 'failure')
              .map(j => j.name);
            core.setOutput('pr_number', pr.number);
            core.setOutput('branch', pr.head.ref);
            core.setOutput('failed_jobs', failed.join(', '));
            core.setOutput('run_url', run.html_url);

      - name: Trigger Devin session
        run: |
          curl -s -X POST "https://api.devin.ai/v3/organizations/${{ secrets.DEVIN_ORG_ID }}/sessions" \
            -H "Authorization: Bearer ${{ secrets.DEVIN_API_KEY }}" \
            -H "Content-Type: application/json" \
            -d "{
              \"prompt\": \"CI failed on PR #${{ steps.failure.outputs.pr_number }} in ${{ github.repository }}. Failed jobs: ${{ steps.failure.outputs.failed_jobs }}. Run: ${{ steps.failure.outputs.run_url }}. Branch: ${{ steps.failure.outputs.branch }}. Read the CI logs, identify the root cause, and push a fix to the branch.\"
            }"

Substitua "CI" no array workflows pelo name: exato do seu arquivo de workflow de CI existente (por exemplo, "Tests", "Build & Test").Use o campo tags no corpo da requisição (por exemplo, "tags": ["ci-fix", "pr-312"]) para rastrear quais falhas de CI já acionaram sessões e evitar duplicatas.

O que acontece quando o CI falha

When a PR’s CI run fails, the Action extracts failure details and passes them to Devin as a session prompt. Here’s a typical auto-fix flow:

Reads the CI logs — Devin opens the run URL and parses the error output, stack traces, and test results from the failing jobs
Traces the error to code — Locates the relevant file and line on the PR branch (e.g., UserList.tsx:34) and reads the surrounding code and recent diff
Pushes a fix — Commits a targeted change directly to the PR branch, which re-triggers CI automatically
Comments on the PR — Posts a summary explaining the root cause and what was changed

Example PR comment from Devin:

CI failure in test-unit — fixed

Root cause: `UserList.tsx:34` calls `.map()` on `props.users`, which is
undefined when the API returns an empty response body instead of `[]`.

Fix: Added a fallback — `const users = props.users ?? [];`
Added a test case for the empty-response scenario.
All 312 tests passing.

Direcione para as falhas certas

Nem toda falha em CI se beneficia de uma correção automática — timeouts de infraestrutura e problemas de build do Docker não serão resolvidos por uma alteração de código. Adicione uma condição para que apenas falhas de jobs relevantes acionem o Devin:

      - name: Trigger Devin session
        if: >
          contains(steps.failure.outputs.failed_jobs, 'test') ||
          contains(steps.failure.outputs.failed_jobs, 'lint') ||
          contains(steps.failure.outputs.failed_jobs, 'typecheck')
        run: |
          curl -s -X POST "https://api.devin.ai/v3/organizations/${{ secrets.DEVIN_ORG_ID }}/sessions" \
          ...

Mantenha as correções revisáveis

Devin faz push de um commit de correção, mas o PR ainda requer revisão humana antes de ser mesclado. Trate correções automáticas como um ponto de partida para o desenvolvedor, não como um substituto para a revisão de código. Se Devin não conseguir resolver a falha, ele comenta no PR explicando o que encontrou, para que um engenheiro possa continuar a partir daí.

Get Started

Essential Guidelines

Onboarding Devin

Working with Devin

Product Guides

Integrations

Admin

Release Notes

Mantenha as correções revisáveis