---
title: "Gắn GitHub repo và nhận Pull Request từ Cloud Agent"
description: "Cách gắn repo GitHub cho Cloud Agent trên TOSE, giới hạn push vào nhánh tose/<slug>/, cho phép mở Pull Request qua proxy và giữ quyền merge cho con người."
url: https://tose.sh/blog/cloud-agent-github-pull-request
lang: vi
category: "Hướng dẫn"
tags: ["cloud-agents", "github", "pull-request", "bao-mat"]
author: "TOSE"
published: 2026-11-13T12:49:25.180725Z
updated: 2026-11-13T12:49:25.18079Z
---

# Gắn GitHub repo và nhận Pull Request từ Cloud Agent

**TL;DR:** Agent dùng GitHub App của workspace qua proxy của TOSE, không bao giờ giữ token GitHub. Tối đa 10 repo mỗi agent, mặc định chỉ đọc; push và quản lý issue, Pull Request được bật riêng cho từng repo. Có thể giới hạn push vào nhánh tose/<slug>/…; agent không merge được.

> **info**
> **Loạt bài Cloud Agents trên TOSE** · Phần 4/5
> 1. [Giới thiệu](/blog/gioi-thieu-cloud-agents-tren-tose) · 2. [Tạo Cloud Agent đầu tiên](/blog/huong-dan-tao-cloud-agent-dau-tien) · 3. [Giao việc qua MCP](/blog/giao-viec-cho-cloud-agent-qua-mcp) · 4. **GitHub và Pull Request** (bài này) · 5. [Chi phí và tự động ngủ](/blog/chi-phi-cloud-agent-va-tu-dong-ngu)

[Video: Gắn GitHub repo, nhận Pull Request và tự động ngủ](https://cdn.tose.sh/blog/0bd75b7bfc1c2e8ea47e408db3e9ef2d.mp4)

Sau khi [giao việc qua MCP](/blog/giao-viec-cho-cloud-agent-qua-mcp), kết quả hữu ích nhất là một nhánh hoặc một Pull Request để review. Bài này hướng dẫn thiết lập điều đó một cách an toàn.

## Agent không giữ token GitHub

Agent sử dụng **GitHub App của workspace**, nhưng token không bao giờ nằm trong môi trường của agent:

• **Push** đi qua Git proxy của TOSE.

• **Issue và Pull Request** đi qua GitHub API proxy; agent gọi bằng `$TOSE_GITHUB_API` và `$TOSE_GIT_TOKEN`, là thông tin xác thực với proxy chứ không phải token GitHub.

![Agent kết nối GitHub qua proxy của TOSE](https://cdn.tose.sh/blog/452f657a6cc9763d09bf92ac9d810609.webp)

Nhờ vậy, quyền được giới hạn theo từng repo, và kể cả khi agent vô tình in biến môi trường, token GitHub cũng không bị lộ.

## Gắn repo

Gắn repo ở bước cấu hình khi triển khai, hoặc sau đó trong tab **Kho mã** của agent:

• Tối đa **10 repo** mỗi agent.

• Mỗi repo nằm trong thư mục riêng `/workspace/<tên>`.

• Mặc định agent **chỉ đọc**.

• Lưu thay đổi trong tab Kho mã sẽ **khởi động lại agent**; tránh thay đổi khi agent đang chạy tác vụ.

![Tab Kho mã của agent](https://cdn.tose.sh/blog/0dea7c3196ae5db9cc14172186ba2846.webp)

*Ảnh mockup tab Kho mã, dữ liệu minh họa.*

## Bật push và giới hạn nhánh

Push được bật riêng cho từng repo, với hai lựa chọn:

• **Mọi nhánh**; hoặc

• **Chỉ nhánh `tose/<slug>/…`**.

Chúng tôi khuyến nghị lựa chọn thứ hai. Khi agent push lên nhánh khác, git từ chối với thông báo `only tose/<slug>/* branches may be pushed`, nên các nhánh chính luôn được bảo vệ khỏi agent.

## Cho phép quản lý issue và Pull Request

Push không tự tạo Pull Request. Để agent mở Pull Request, bình luận hoặc gắn nhãn, hãy bật **"Cho phép agent quản lý issue và pull request"** cho repo trên trang agent.

• Quyền này chỉ bật được trên trang agent; kế hoạch triển khai không yêu cầu được. Vì vậy, một AI tạo agent qua MCP không thể tự cấp quyền này.

• Agent **không merge được**: yêu cầu merge bị từ chối với `GITHUB_API_ENDPOINT_NOT_ALLOWED`.

• Proxy giới hạn **4 yêu cầu đồng thời và 60 yêu cầu mỗi phút** cho mỗi repo.

## Một quy trình hoàn chỉnh

1. **Trao đổi với AI để chốt đề bài: bối cảnh, phạm vi, điều kiện hoàn thành.**
2. **AI giao tác vụ cho agent, kèm yêu cầu làm trên nhánh `tose/<slug>/fix-refresh-token`, push và mở Pull Request vào `main`.**
3. **Agent sửa code, chạy test, push và mở Pull Request.**
4. **Bạn review diff, kiểm tra CI và tự merge.**

Kết quả cuối cùng là một Pull Request, hình thức review code quen thuộc nhất với đội ngũ phát triển.

## Cấu hình khuyến nghị

| Tùy chọn | Khuyến nghị |
| --- | --- |
| Push | Bật, chỉ nhánh `tose/<slug>/…` |
| Quản lý issue và Pull Request | Bật khi cần nhận Pull Request; tắt nếu chỉ cần nhánh |
| Số repo | Chỉ gắn repo agent thực sự cần |
| Branch protection trên GitHub | Giữ nguyên như một lớp bảo vệ bổ sung |

*Cấu hình khuyến nghị*

**Phần trước:** [← Giao việc cho Cloud Agent qua MCP](/blog/giao-viec-cho-cloud-agent-qua-mcp) **Phần tiếp theo:** [Chi phí Cloud Agent và tự động ngủ →](/blog/chi-phi-cloud-agent-va-tu-dong-ngu)

## FAQ

### Cloud Agent có giữ token GitHub không?

Không. Push đi qua Git proxy và các lệnh issue, Pull Request đi qua GitHub API proxy của TOSE; agent chỉ có thông tin xác thực với proxy.

### Cloud Agent có merge Pull Request được không?

Không. Yêu cầu merge bị từ chối với GITHUB_API_ENDPOINT_NOT_ALLOWED. Việc merge luôn do con người thực hiện.

### Một agent gắn được bao nhiêu repo?

Tối đa 10 repo, mỗi repo nằm trong thư mục /workspace/<tên> riêng.
