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.
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:
POST https://intelligence-api.veyra.so/api/chat-webhooks/{publicId}/githubCada 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
- 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.»
- Declara las variables de texto obligatorias
pr_url,pr_number,head_shaybase_sha. - Pon When a run overlaps en Always enqueue, para que pull requests distintas nunca se unan en una sola revisión.
- Añade un disparador webhook con el modo de firma
bearer. Copia la URL y el secreto.
Configura GitHub
- En el repositorio, crea un entorno de Actions (por ejemplo
pr-review) limitado a tu rama por defecto. - Añade dos secretos de entorno:
VEYRA_REVIEW_WEBHOOK_URLyVEYRA_REVIEW_WEBHOOK_TOKEN. - 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:
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.