Chuyển đến nội dung chính

Tất cả bài viếtHướng dẫn

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

Tác giả TOSEĐăng ngày Cập nhật 4 phút đọc

Agent kết nối GitHub qua proxy của TOSE

Tóm tắt

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.

Sau khi giao việc 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

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
Ả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ị

Cấu hình khuyến nghị
Tùy chọnKhuyến nghị
PushBật, chỉ nhánh `tose/<slug>/…`
Quản lý issue và Pull RequestBật khi cần nhận Pull Request; tắt nếu chỉ cần nhánh
Số repoChỉ gắn repo agent thực sự cần
Branch protection trên GitHubGiữ nguyên như một lớp bảo vệ bổ sung

Câu hỏi thường gặp

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.