PR-Agent: Công cụ review code AI mã nguồn mở
/pr-agent
PR-Agent là công cụ review code AI mã nguồn mở, chạy như GitHub Action hoặc CLI, hỗ trợ GitHub, GitLab, Bitbucket và Azure DevOps. Nó sinh mô tả PR, review code, gợi ý cải thiện, và trả lời câu hỏi bằng GPT, Claude, Gemini hoặc DeepSeek — bạn chỉ trả tiền cho các lệnh gọi API. Đáng dùng nếu bạn cần tự động hóa PR self-hosted, tùy chỉnh được; bỏ qua nếu bạn muốn giải pháp hosted dùng ngay không cần cấu hình.
PR-Agent là gì?
PR-Agent là công cụ review PR bằng AI mã nguồn mở, gắn vào repository GitHub, GitLab, Bitbucket, Azure DevOps hoặc Gitea của bạn và tự động review pull request. Nó phản hồi các lệnh slash như /describe, /review, /improve và /ask, sinh mô tả PR, phản hồi về bảo mật và chất lượng, gợi ý cải thiện code, và hỏi đáp tự do về diff. Công cụ chỉ gọi LLM một lần mỗi thao tác (~30 giây) và mặc định nạp quy ước AGENTS.md của dự án vào model từ bản v0.39.0, nên nó bắt được phong cách của team mà không cần cấu hình thêm.
Tool và khả năng cốt lõi
- ✓Bốn tool lệnh slash: /describe (tiêu đề PR, tóm tắt, walkthrough, nhãn), /review (phát hiện, bảo mật, ước lượng công sức), /improve (gợi ý sửa code), và /ask (hỏi đáp tự do về diff)
- ✓Hỗ trợ đa nền tảng: GitHub, GitLab, Bitbucket, Azure DevOps và Gitea
- ✓Hỗ trợ đa provider AI: OpenAI GPT, Anthropic Claude, Google Gemini, DeepSeek, Mistral, và bất kỳ model nào qua LiteLLM (Azure OpenAI, AWS Bedrock, Vertex AI, Ollama, OpenRouter)
- ✓Chiến lược nén PR xử lý diff lớn bằng cách cắt context thông minh để vừa giới hạn token
- ✓Quy ước dự án qua AGENTS.md, SKILL.md và cấu hình cấp tổ chức — tự động nạp vào model từ v0.39.0
- ✓Prompting dựa trên JSON và cấu hình TOML để tùy chỉnh toàn diện category review, định dạng output và tool được bật
- ✓Linh hoạt triển khai: GitHub Actions, CLI, Docker, GitHub App/webhook, hoặc webhook self-hosted
- ✓Cơ chế tự phản chiếu (self-reflection) để giảm hallucination và tăng độ nhất quán khi review
Khi nào nên chạy PR-Agent trên pull request
- •Review code tự động ở lượt đầu cho mọi pull request để bắt lỗi, vấn đề bảo mật và chất lượng code trước khi con người review
- •Sinh mô tả PR và changelog nhất quán mà không cần viết tay
- •Hỏi về một diff lớn — ví dụ 'PR này thay đổi gì về kiến trúc?' — mà không cần đọc toàn bộ codebase
- •Áp quy ước team qua file AGENTS.md tùy chỉnh mà model tự động đọc trong mỗi lần review
- •Team đa nền tảng dùng nhiều git provider khác nhau giữa các dự án nhưng muốn một công cụ review duy nhất
- •Team quan tâm chi phí muốn review có AI hỗ trợ mà không phải trả SaaS theo đầu người
Cài đặt PR-Agent làm GitHub Action
Với GitHub Actions, thêm file workflow tại `.github/workflows/pr-agent.yml` kích hoạt theo sự kiện `pull_request` (loại opened và synchronize). Đặt `OPENAI_KEY` và `GITHUB_TOKEN` làm biến môi trường — token được GitHub tự động cung cấp. Tham chiếu action bằng `uses: the-pr-agent/pr-agent@main`. Để dùng CLI cục bộ, cài qua `pip install "pr-agent @ git+https://github.com/The-PR-Agent/[email protected]"` (bản PyPI tạm thời chưa cập nhật kịp). Thiết lập Docker và webhook được ghi tài liệu cho GitLab, Bitbucket và Azure DevOps.
Chạy PR-Agent từ CLI
Trên GitHub, comment `/describe`, `/review`, `/improve`, hoặc `/ask "câu hỏi của bạn"` trực tiếp trên PR. Từ CLI: `pr-agent --pr_url https://github.com/owner/repo/pull/123 review` (thay `review` bằng `describe`, `improve`, `ask` tùy nhu cầu). Biến môi trường `OPENAI_KEY` và `GITHUB_TOKEN` phải được đặt để dùng CLI. Cấu hình nằm ở `pr_agent/settings/configuration.toml` cho prompt, category và bật/tắt tool tùy chỉnh.
Điểm mạnh của PR-Agent
- ✓Kiểm soát dữ liệu hoàn toàn — bạn tự cung cấp API key AI và dữ liệu review không rời khỏi hạ tầng của bạn
- ✓Đa nền tảng sẵn có: GitHub, GitLab, Bitbucket, Azure DevOps và Gitea với cùng bộ công cụ
- ✓Chỉ gọi LLM một lần mỗi thao tác giữ chi phí thấp: khoảng 30 giây và một request API cho mỗi lần dùng tool
- ✓Quy ước AGENTS.md được tự động đưa vào prompt từ bản v0.39.0, không cần cấu hình thêm
- ✓Tùy chỉnh sâu qua cấu hình TOML và prompting dựa trên JSON — đổi category, thêm kiểm tra riêng, hoặc đổi model
- ✓Có provider plain-diff cho diff không vừa giới hạn token chuẩn, kèm nạp context từ artifact CI
Hạn chế và điều cần cân nhắc
- △Self-hosted nghĩa là bạn tự quản lý credential API, chi phí và uptime — không có gói managed kèm SLA
- △/help_docs bị tắt từ bản v0.36.1 do đang chờ sửa vấn đề lộ credential (issue #2445)
- △Tùy chỉnh toàn diện đòi hỏi sửa file cấu hình TOML và hiểu mô hình prompting — không thực sự zero-config
- △Việc chuyển namespace Docker Hub ở v0.34.2 yêu cầu cập nhật tham chiếu image đã ghim từ `codiumai/pr-agent` sang `pragent/pr-agent` khi nâng cấp
- △Publish lên PyPI tạm thời chưa cập nhật kịp — `pip install pr-agent` cài bản 0.39.0 thay vì bản v0.42.0 hiện tại, nên phải cài trực tiếp từ GitHub để có bản mới nhất
Lựa chọn thay thế PR-Agent
Ai nên dùng PR-Agent
PR-Agent phù hợp với team cần review code có AI hỗ trợ nhưng vẫn kiểm soát toàn bộ dữ liệu và không trả phí theo đầu người. Nó hợp với maintainer mã nguồn mở, doanh nghiệp quan tâm quyền riêng tư, và team dùng nhiều git provider khác nhau. Tổ chức có quy ước coding rõ ràng hưởng lợi nhiều nhất từ tính năng tự nạp AGENTS.md. Team muốn thiết lập trong 5 phút không cần cấu hình nên tìm giải pháp hosted khác.
Câu hỏi thường gặp
Bản thân PR-Agent cấp phép MIT và miễn phí. Bạn cần tự cung cấp API key AI — OpenAI, Anthropic, hoặc bất kỳ provider tương thích LiteLLM nào — và trả phí theo mức per-token của họ. Self-host nghĩa là bạn kiểm soát hoàn toàn chi phí.
Anthropic Claude (gồm Opus 5 và Sonnet 5), Google Gemini (3.6), DeepSeek và Mistral được hỗ trợ trực tiếp. Bất kỳ model nào truy cập được qua LiteLLM cũng dùng được — Azure OpenAI, AWS Bedrock, Vertex AI, Ollama và OpenRouter là các ví dụ được liệt kê.
Thêm API key làm secret ở cấp repository hoặc organization (ví dụ OPENAI_KEY), tham chiếu nó trong block env của GitHub Actions, và đặt GITHUB_TOKEN thành Secrets.GITHUB_TOKEN. Restricted mode trong configuration.toml giảm bớt quyền GitHub cần thiết để bảo mật chặt hơn.
Có. Thiết lập webhook GitLab và cài app Bitbucket được ghi trong docs.pr-agent.ai. Cả hai đều hỗ trợ 4 tool /describe, /review, /improve và /ask. Riêng /ask theo dòng cụ thể chỉ có trên GitHub và GitLab.
Chiến lược nén PR của nó cắt bớt context diff một cách thích ứng để vừa giới hạn token, xử lý được cả PR nhỏ lẫn lớn chỉ trong một lần gọi LLM. Có sẵn provider plain-diff cho diff không vừa context chuẩn, kèm khả năng nạp thêm context từ artifact CI.
Có. Prompting dựa trên JSON và file cấu hình TOML tại pr_agent/settings/configuration.toml kiểm soát category nào được kiểm tra, cách phản hồi được cấu trúc, và tool nào được bật. Cài đặt cấp tổ chức cùng file AGENTS.md cho phép mã hóa quy ước của team theo từng repo.
Repo liên quan
pr-agent có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về pr-agent.