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

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

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

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

Mockup form cấu hình Cloud Agent 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.

Trang Cloud Agents
Ảnh mockup trang Cloud Agents, dữ liệu minh họa.

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

Form cấu hình agent
Ảnh mockup form cấu hình, dữ liệu minh họa.

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.

CPU và RAM.
AgentCPURAM
Claude Code, Codex1, 2 hoặc 4 nhân2, 4 hoặc 8 GiB
Pi1 hoặc 2 nhân1, 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ó.

Màn hình xem lại kế hoạch
Ảnh mockup màn hình kế hoạch, dữ liệu minh họa.

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.

Trang tổng quan của agent
Ảnh mockup trang agent, dữ liệu minh họa.

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:

text
Đọ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ở.

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.