Hướng dẫn tạo Cloud Agent đầu tiên trên TOSE

Tóm tắt
Cần một workspace có ví trả trước còn số dư, vai trò chủ sở hữu hoặc quản trị viên, và khóa API của nhà cung cấp. Cloud Agents → chọn agent → Triển khai → cấu hình → Xem lại kế hoạch → Duyệt kế hoạch → nhập khóa → Mở agent. Ổ đĩa tăng được nhưng không giảm được; nên bắt đầu với cấu hình nhỏ nhất.
Phần 1 giải thích khi nào nên giao việc cho Cloud Agent. Bài này hướng dẫn từng bước dựng agent đầu tiên.
Chuẩn bị
• Một workspace TOSE có ví trả trước còn số dư. Agent tính phí compute theo giờ và lưu trữ theo tháng.
• Vai trò chủ sở hữu hoặc quản trị viên của workspace.
• Khóa API của nhà cung cấp: ANTHROPIC_API_KEY cho Claude Code, OPENAI_API_KEY cho Codex, PI_API_KEY cho Pi. Riêng Claude Code có thể dùng gói Claude (Pro hoặc Max) thay cho khóa API, đăng nhập sau khi triển khai hoặc bằng /login trong console.
TOSE không tính phí sử dụng mô hình; chi phí token vẫn do nhà cung cấp tính như khi chạy trên máy cá nhân.
Bước 1: Chọn agent
Trên dashboard, mở menu Cloud Agents. Phía trên là các agent của workspace, phía dưới là mục Agent có sẵn gồm Claude Code, Codex và Pi. Chọn một agent và bấm Triển khai.

Bước 2: Cấu hình

Tên ứng dụng. Nên đặt tên phản ánh công việc, ví dụ codex-dashboard.
Nhà cung cấp và mô hình. Chọn mô hình agent sẽ sử dụng.
CPU và RAM.
| Agent | CPU | RAM |
|---|---|---|
| Claude Code, Codex | 1, 2 hoặc 4 nhân | 2, 4 hoặc 8 GiB |
| Pi | 1 hoặc 2 nhân | 1, 2 hoặc 4 GiB |
Cấu hình nhỏ nhất đủ cho phần lớn việc sửa code. Tăng lên khi cần build nặng hoặc chạy nhiều test.
Ổ đĩa workspace. /workspace có các mức 5 GiB (mặc định), 10, 20 hoặc 50 GiB, kèm 1 GiB cho /home/agent. Ổ đĩa tăng được nhưng không giảm được, vì vậy nên bắt đầu ở mức nhỏ.
Kho mã. Gắn tối đa 10 repo GitHub qua GitHub App của workspace. Mặc định agent chỉ đọc. Xem phần 4 để bật push và Pull Request.
Tự động ngủ. Mặc định là Tắt. Nên chọn 30 phút cho agent đầu tiên. Xem phần 5.
Mạng. Agent truy cập được Internet công khai. Các địa chỉ mạng riêng, link-local và metadata bị chặn.
Bước 3: Xem lại và duyệt kế hoạch
Bấm Xem lại kế hoạch. TOSE chưa tạo gì ở bước này mà lập một kế hoạch gồm tài nguyên sẽ tạo, trần chi phí compute mỗi giờ, giá lưu trữ theo tháng và các điểm chặn nếu có.

Nếu mọi thứ phù hợp, bấm Duyệt kế hoạch. Kế hoạch chỉ được thực hiện khi có người duyệt, kể cả khi do một AI khác tạo qua MCP.
Bước 4: Cài đặt và nhập khóa
Ở bước Cài đặt, nhập khóa API của nhà cung cấp. Khóa được mã hóa và chỉ agent sử dụng; bạn không cần đưa khóa vào repo hay tệp .env.
Bước 5: Mở agent
Sau khi cài xong, bấm Mở agent. Trang agent có năm tab: Tổng quan, Tác vụ, Kho mã, Cài đặt, Hoạt động.

Console chạy trong trình duyệt và là riêng tư: không có địa chỉ công khai, chỉ chủ sở hữu và quản trị viên workspace mở được.
Chạy thử một việc nhỏ
Nên bắt đầu bằng một việc kiểm tra được trong vài phút, chẳng hạn:
Đọc README và cấu trúc thư mục của repo.Chạy bộ test hiện có và liệt kê các test bị lỗi.Không sửa tệp nào.Nếu agent thực hiện và báo cáo đúng, agent đã sẵn sàng nhận việc thật.
Lưu ý
• Không nâng cấp tại chỗ. Khi có bản phát hành mới, hãy cài thành một agent mới và chuyển công việc sang bằng git.
• Giao việc qua MCP cần bản có hỗ trợ tác vụ: Claude Code 1.1.0, Codex 1.1.0 hoặc Pi 1.2.0.
• Khi ngủ, agent giữ tệp và thông tin đăng nhập nhưng mất phiên tmux. Đánh thức bằng nút Đánh thức và mở.
Phần trước: ← Giới thiệu Cloud Agents Phần tiếp theo: Giao việc cho Cloud Agent qua MCP →
Câu hỏi thường gặp
Cần gì để tạo Cloud Agent trên TOSE?
Một workspace có ví trả trước còn số dư, vai trò chủ sở hữu hoặc quản trị viên, và khóa API của nhà cung cấp mô hình.
Có thể giảm dung lượng ổ đĩa sau khi tạo không?
Không. Ổ đĩa /workspace chỉ tăng được, vì vậy nên bắt đầu với 5 GiB.
Làm sao nâng cấp agent lên bản phát hành mới?
TOSE không nâng cấp tại chỗ. Hãy cài bản mới thành một agent mới và chuyển công việc sang bằng git.