Revisiones de pull requests de GitHub

Haz que un agente revise pull requests, ya sea mediante el canal de chat de GitHub o desde GitHub Actions llamando a un webhook de rutina cuando una pull request está lista.

Veyra Docs TeamActualizado el 2 min de lecturaVersión 2 · Historial

Hay dos formas de llevar pull requests a un agente. Usa el canal de GitHub cuando las personas deban hablar con el agente en GitHub. Usa un webhook de rutina desde GitHub Actions cuando cada pull request lista deba recibir una revisión sin que nadie la pida.

Opción 1: el canal de GitHub

Conecta GitHub como canal de chat. GitHub enviará entonces los eventos de los repositorios que elijas a:

HTTP
POST https://intelligence-api.veyra.so/api/chat-webhooks/{publicId}/github

Cada entrega se verifica con el secreto de webhook de la GitHub App (X-Hub-Signature-256). Las menciones al agente y las solicitudes de revisión se convierten en tareas; el agente responde en la conversación de la pull request. El ID X-GitHub-Delivery de GitHub evita que las reentregas creen duplicados.

Opción 2: un webhook de rutina desde GitHub Actions

Un workflow de tu repositorio llama a un disparador de rutina cuando una pull request supera sus comprobaciones. El agente de la rutina la revisa y publica su recomendación en la tarea de la rutina.

Configura la rutina

  1. Crea una rutina con tu agente revisor. En su petición, di qué comprobar y qué publicar, por ejemplo: «Revisa la pull request {{pr_url}} en el commit {{head_sha}}. Vuelve a verificar head y base antes de empezar. Publica MERGE, HOLD o DO NOT MERGE con tus motivos. No apruebes, no fusiones ni comentes en GitHub.»
  2. Declara las variables de texto obligatorias pr_url, pr_number, head_sha y base_sha.
  3. Pon When a run overlaps en Always enqueue, para que pull requests distintas nunca se unan en una sola revisión.
  4. Añade un disparador webhook con el modo de firma bearer. Copia la URL y el secreto.

Configura GitHub

  1. En el repositorio, crea un entorno de Actions (por ejemplo pr-review) limitado a tu rama por defecto.
  2. Añade dos secretos de entorno: VEYRA_REVIEW_WEBHOOK_URL y VEYRA_REVIEW_WEBHOOK_TOKEN.
  3. Añade un workflow que se ejecute desde tu rama por defecto cuando terminen tus comprobaciones y que envíe solo identificadores, nunca código:
YAML
name: Ask Veyra for a review
on:
  workflow_run:
    workflows: [ci]
    types: [completed]
permissions:
  contents: read
  pull-requests: read
jobs:
  notify:
    if: github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.event == 'pull_request'
    runs-on: ubuntu-latest
    environment: pr-review
    steps:
      - name: Send the pull request to the review routine
        env:
          URL: ${{ secrets.VEYRA_REVIEW_WEBHOOK_URL }}
          TOKEN: ${{ secrets.VEYRA_REVIEW_WEBHOOK_TOKEN }}
          PR: ${{ toJSON(github.event.workflow_run.pull_requests[0]) }}
        run: |
          number=$(jq -r .number <<<"$PR")
          head=$(jq -r .head.sha <<<"$PR")
          base=$(jq -r .base.sha <<<"$PR")
          body=$(jq -n --arg n "$number" --arg h "$head" --arg b "$base" \
            --arg u "https://github.com/${{ github.repository }}/pull/$number" \
            '{variables: {pr_url: $u, pr_number: $n, head_sha: $h, base_sha: $b}}')
          curl --fail --silent --show-error --max-time 15 --proto '=https' \
            -X POST "$URL" \
            -H "Authorization: Bearer $TOKEN" \
            -H "Content-Type: application/json" \
            -H "Idempotency-Key: pr-$number-$head-$base" \
            --data "$body"

La clave de idempotencia hace que un evento repetido para la misma pull request, head y base no tenga efecto. Un commit nuevo o una base nueva reciben una revisión nueva.

Pruébalo

Crea primero el disparador en modo de prueba. Una entrega en modo de prueba se autentica y se registra sin iniciar ninguna revisión; desactiva el modo de prueba cuando pase.

Importante

El webhook transporta identificadores, no código. El agente debe tratarlos como no fiables, obtener la pull request por su cuenta y confirmar que head y base no han cambiado antes de recomendar nada.

EntrantesGitHubRutinasWebhooks