Как подключить PR-Agent к GitHub Actions: пошаговая настройка AI-ревью

01Что именно делает PR-Agent и как он устроен

Идея проекта — не «умный чат про код», а набор узких инструментов, каждый из которых делает одну работу за один вызов модели. /describe пишет заголовок и описание PR, /review выдаёт замечания и оценку риска, /improve предлагает конкретные правки по строкам, /ask отвечает на свободный вопрос по изменению, /similar_issue ищет похожие issue. Авторы оценивают один прогон примерно в 30 секунд — это важно для бюджета: не «агент думает десять минут», а один короткий вызов на инструмент.

Ключевая инженерная деталь — сжатие PR. Большой diff не влезает в контекст модели целиком, поэтому PR-Agent применяет стратегию компрессии: разбивает изменение на части, отбрасывает неинформативное и поднимает лимит токенов через max_model_tokens. Без этого на PR в несколько тысяч строк вы получите либо обрезанное ревью, либо ошибку провайдера.

02Шаг 1. Ключ модели в секретах репозитория

PR-Agent не приносит свою модель: он ходит к провайдеру через LiteLLM, поэтому подходит почти любой OpenAI-совместимый endpoint. Для начала положите ключ в секреты репозитория: Settings → Secrets and variables → Actions → New repository secret. Имя секрета выбирайте по провайдеру — в примерах документации это OPENAI_KEY; для собственного шлюза задаются OPENAI__API_BASE и OPENAI__KEY, для Anthropic-совместимого — ANTHROPIC_API_BASE и ANTHROPIC__KEY.

Name: OPENAI_KEY
Value: sk-...

python3 --version

03Шаг 2. Workflow-файл в GitHub Actions

Минимальный вариант — из README проекта. Он запускается на открытие PR и на каждое обновление ветки, то есть ревью обновляется вместе с кодом.

name: PR Agent
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  pr_agent_job:
    runs-on: ubuntu-latest
    steps:
      - name: PR Agent action step
        uses: the-pr-agent/pr-agent@main
        env:
          OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Практика добавляет к этому две вещи. Первая — явные права токена: в новых репозиториях GITHUB_TOKEN по умолчанию только читает, и тогда Action отработает, но не сможет оставить комментарий. Вторая — permissions для issues: часть инструментов публикует результат именно туда.

permissions:
  contents: read
  pull-requests: write
  issues: write

04Шаг 3. Настройка .pr_agent.toml

Поведение агента настраивается файлом .pr_agent.toml в корне репозитория. Имена секций и ключей стоит сверять с pr_agent/settings/configuration.toml в репозитории: файл большой (больше 650 строк) и он единственный надёжный источник — документация отстаёт от релизов.

[config]
model = "deepseek/deepseek-reasoner"
fallback_models = ["openai/gpt-6.1-sol"]
max_model_tokens = 32000

[pr_reviewer]
require_score_review = false
extra_instructions = "Пиши замечания по-русски, коротко, без воды. Игнорируй стиль форматирования."

[pr_description]
publish_description_as_comment = false

[github]
publish_as_check_run = false

Для OpenRouter модели адресуются с префиксом openrouter/…, ключ берётся из переменной openrouter__key или .secrets.toml. Для локальной Ollama переменные окружения задаёт сама Ollama, а контекст ограничивается OLLAMA_CONTEXT_LENGTH — на 8K окно мало для среднего PR, поэтому локальный вариант имеет смысл только с моделью на 32K и больше.

05Инструменты и когда их вызывать

Инструменты работают двумя способами: автоматически из workflow или вручную комментарием в PR — достаточно написать /review в обсуждении. Второй режим удобен, когда не хочется тратить токены на каждый коммит.

06Три способа запуска: Action, Docker, CLI

GitHub Actions — рекомендованный путь, но не единственный. Если репозиторий живёт в GitLab, Bitbucket, Azure DevOps или Gitea, PR-Agent ставится вебхуком или в собственном контейнере: поддерживаются все четыре платформы плюс Gitea. Локальный CLI удобен, чтобы прогнать ревью до пуша и не светить черновик в PR.

pip install "pr-agent[github]"

export OPENAI_KEY=sk-...
pr-agent --pr_url <PR_URL> review

Для self-hosted варианта есть официальный образ pragent/pr-agent в Docker Hub: с версии 0.34.2 образы публикуются только там, старый namespace codiumai/pr-agent заморожен. Если в ваших workflow или compose-файлах закреплён старый путь, после обновления его надо поменять, иначе вы останетесь на архиве.

07Ограничения и подводные камни

• Это не замена ревью человеком. Один вызов модели на инструмент даёт быстрый первый проход, но архитектурные и продуктовые решения агент не оценит.
• Данные уходят провайдеру модели. При self-hosted варианте diff отправляется в API выбранной модели; при использовании облачного провайдера это надо согласовать с политикой компании.
• Большие PR режутся. Без настройки max_model_tokens и без понимания стратегии компрессии ревью будет неполным — особенно на PR с генерацией кода и миграциями.
• Проект community-уровня. 52 открытых issue на 2 125 форков, а сам PR-Agent — legacy-ветка: новая разработка Qodo идёт в закрытом продукте, открытая кодовая база живёт на поддержке сообщества.
• Шум в комментариях. По умолчанию агент публикует и «замечаний нет»; чтобы этого не было, в конфиге есть отдельные флаги публикации без предложений.
• Стоимость плавает. Цена прогона = токены × ставка провайдера; на PR с большим diff она выше, и предсказать её без замера нельзя.