VibeCloud cho AI agent

Giao phần deploycho Claude hoặc Codex.

Trang này chỉ cho Claude hoặc Codex cách đưa một repository lên VibeCloud: đọc agent guide, dùng API token, chọn VPS và database, theo dõi job rồi deploy ứng dụng. Người dùng giữ quyền tạo token và nạp tiền bằng VietQR; agent xử lý phần hạ tầng qua API.

Sao chép prompt Mở agent-guide.md

GET /api/packages · /api/prices

POST /api/lxc · /api/databases

GET /api/jobs/:id

POST /api/services/:id/start

DELETE /api/services/:id

Authorization: Bearer vc_live_*

Prompt copy-paste

Cho agent một yêu cầu có điểm dừng

Prompt yêu cầu agent báo giá và chờ duyệt trước khi tạo service. Token, private key và thao tác xoá đều có ranh giới rõ.

deploy-with-vibecloud.txt

Đọc https://vibecloud.vn/agent-guide.md trước khi làm.

Mục tiêu: deploy repository hiện tại lên VibeCloud.
1. Phân tích runtime, port, lệnh build/start và database của app.
2. Dùng VIBECLOUD_API_URL=https://api.vibecloud.vn và VIBECLOUD_API_TOKEN do tôi cung cấp.
3. Gọi GET /api/packages và GET /api/prices, rồi đề xuất CPU, RAM, Disk cùng chi phí theo giờ.
4. Chờ tôi duyệt trước khi POST tạo VPS hoặc database.
5. Poll GET /api/jobs/:id tới trạng thái cuối; nếu succeeded, dùng credential trong result để deploy.
6. Kiểm tra app, báo URL, cấu hình, chi phí theo giờ và những secret tôi cần tự lưu.

Không nạp tiền, không in token hay private key vào log, không xoá service nếu chưa có xác nhận.

Luồng làm việc

4 chặng từ code tới app đang chạy

API tách bước tạo service khỏi bước hoàn tất. Agent nhận job, theo dõi trạng thái và chỉ dùng credential sau khi job thành công.

Đọc guide và app

Agent tải bản Markdown raw, sau đó kiểm tra framework, port, biến môi trường và database.

Báo cấu hình và giá

Agent đọc package cùng đơn giá, đề xuất tài nguyên rồi chờ người dùng xác nhận.

Tạo và poll job

Lệnh POST trả job; agent gọi endpoint job tới trạng thái succeeded, failed hoặc cancelled.

Deploy và bàn giao

Agent lưu credential cục bộ, deploy app, kiểm tra service và báo lại URL cùng chi phí.

Agent làm được

Thao tác hạ tầng qua token

Liệt kê package và giá public.
Tạo VPS LXC hoặc database.
Đọc job, service và credential.
Start, stop, resize, rebuild hoặc xoá service khi được giao.

Người dùng làm

Giữ token và ngân sách

Đăng nhập để tạo API key.
Nạp số dư bằng VietQR.
Duyệt cấu hình trước khi tạo.
Sao lưu dữ liệu trước khi xoá.

Endpoint cốt lõi

Agent cần 6 nhóm lệnh

Chi tiết request, response, lỗi và credential nằm trong agent guide song ngữ. Bảng này chỉ để nhìn nhanh trước khi giao prompt.

Việc	Endpoint	Ghi chú
Xem package	`GET /api/packages`	Public, không cần token
Xem giá	`GET /api/prices`	Public, không cần token
Tạo VPS	`POST /api/lxc`	Dùng package hoặc custom sizing
Tạo database	`POST /api/databases`	MongoDB, PostgreSQL, MySQL
Theo dõi job	`GET /api/jobs/:id`	Đọc result khi succeeded
Quản lý service	`/api/services/:id/*`	Get, start, stop, rebuild, delete

Thời gian provision: thường 60–180 giây tùy cấu hình — agent vẫn nên poll theo trạng thái job (xem §7 agent guide) thay vì cố định thời gian hoàn tất.

5 câu về quyền của agent

Cho AI cầm token tới đâu?

Claude hoặc Codex có tự deploy app được không?

Có. Agent đọc /agent-guide.md, dùng API token do người dùng tạo, xem package, tạo VPS hoặc database, theo dõi job và dùng credential trả về để deploy. Người dùng vẫn kiểm soát token, ngân sách và quyết định tạo hoặc xoá service.

Lấy API token cho agent ở đâu?

Đăng nhập VibeCloud, mở mục API Keys và tạo key cho agent automation. Key có prefix vc_live_. Lưu key trong .env_vibecloud, không commit lên Git và không dán vào nội dung công khai.

Agent nên đọc tài liệu nào trước?

Cho agent đọc https://vibecloud.vn/agent-guide.md trước khi deploy. Đây là bản Markdown raw song ngữ, gồm host API, endpoint, mẫu curl, job polling, credential, cách quản lý service và lỗi thường gặp.

API token của agent có nạp tiền được không?

Không. Token vc_live_* dùng cho thao tác hạ tầng như tạo, đọc, start, stop, resize, rebuild và xoá service. Kiểm tra số dư, nạp VietQR và quản lý API key cần phiên đăng nhập của người dùng.

Nếu job tạo VPS chưa xong thì agent làm gì?

Lệnh tạo trả về một job. Agent gọi GET /api/jobs/:id cho tới khi trạng thái là succeeded, failed hoặc cancelled; nếu succeeded thì đọc result để lấy service và credential. Thời gian provision đang chờ số đo thật.

Bắt đầu từ app đang có

Đọc guide raw trước, tạo service sau khi đã duyệt giá

Agent guide dùng API host https://api.vibecloud.vn. Người dùng tạo token trong tài khoản và nạp VND bằng VietQR.

Đọc agent guide Tạo tài khoản