PR-Agent를 활용한 코드 리뷰 자동화 구성하기

새로운 사이드 프로젝트를 진행하는데 사내에서 해보지 못한 것들을 도입해보고자 고민하던 중, 링크드인에서 AI 코드 리뷰와 관련된 여러 글을 보았던 기억이 떠올랐다. 다양한 AI 코드 리뷰툴이 존재하지만 오픈소스로 개발되었고 설정이 매우 간단하다는 이유로 PR-Agent를 선택하게 되었다.

이번 글에선 PR-Agent를 프로젝트에 도입하여 코드 리뷰 자동화 환경을 구성한 내용을 기록해 보았다. 특히 Github Actions + Gemini API를 활용하여 PR 생성 시 코드 리뷰를 받을 수 있도록 구성하였다. 동작 방식이나 다양한 활용법 관련해서 Github 저장소나 공식 문서에서 자세히 확인할 수 있다.

Google AI Studio에서 Gemini API 생성하기

Github Actions 등록 시 LLM API가 필요하다. LLM으로 Gemini를 사용하였고, Gemini API는 Google AI Studio에서 쉽게 발급 받을 수 있다. Gemini를 사용한 이유는 한도 내에서 충분히 사용 가능할 것이라 생각해서다. 모델 별 Rate limit은 공식 문서에서 자세히 확인할 수 있다.

생성한 API키는 Github 저장소에 등록해둔다.

Github Actions 워크플로 구성하기

프로젝트 루트 디렉토리 아래에 .github/workflows/pr_agent.yml 설정 파일을 생성하고, 다음의 내용을 입력한다. 모델을 gemini-2.5-pro로 지정했는데, 다른 모델 사용을 원하면 해당 부분을 변경하면 된다. GOOGLE_AI_STUDIO.GEMINI_API_KEY의 값은 이전에 설정한 키 이름과 동일하게 지정한다.

name: PR Agent (Gemini)
on:
  pull_request:
    types: [opened, reopened, ready_for_review]
  issue_comment:
jobs:
  pr_agent_job:
    if: ${{ github.event.sender.type != 'Bot' }}
    runs-on: ubuntu-latest
    permissions:
      issues: write
      pull-requests: write
      contents: write
    steps:
      - name: PR Agent action step
        uses: qodo-ai/pr-agent@main
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          config.model: "gemini/gemini-2.5-pro"
          config.fallback_models: '["gemini/gemini-2.5-pro"]'
          GOOGLE_AI_STUDIO.GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
          github_action_config.auto_review: "true"
          github_action_config.auto_describe: "true"
          github_action_config.auto_improve: "true"

이처럼 구성하고 PR을 생성하면 다음과 같이 리뷰가 생성되는 것을 확인할 수 있다.