# Computer Control API
SUMMARY: Điều khiển từ xa các máy tính đã đăng ký — xếp hàng lệnh, chụp ảnh màn hình, chạy script trên máy từ xa.

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

Computer Control API
Computer Control API cho phép bạn điều khiển từ xa các máy tính đã đăng ký.
Một agent nhỏ () chạy trên máy đích, poll các lệnh, thực
thi chúng và gửi kết quả trở lại. Điều này cho phép tự động hóa GUI điều khiển
bởi LLM.
Kiến trúc
[CODE BLOCK]
Endpoint phía người dùng (Mind Key hoặc JWT)
GET /computers/list
Liệt kê tất cả máy tính đã đăng ký.
[CODE BLOCK]
GET /computers/:id
Lấy thông tin chi tiết của một máy tính.
[CODE BLOCK]
POST /computers/install-code
Tạo một mã cài đặt để đăng ký máy tính mới.
[CODE BLOCK]
Phản hồi: 
POST /computers/:id/commands
Xếp hàng một lệnh để agent từ xa thực thi.
[CODE BLOCK]
Phản hồi: 
GET /computers/:id/command (qua query)
Xếp hàng một lệnh qua GET (cho các trường hợp đơn giản).
[CODE BLOCK]
GET /computers/:id/commands
Liệt kê các lệnh gần đây của một máy tính.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Lấy trạng thái + kết quả của một lệnh cụ thể.
[CODE BLOCK]
GET /computers/:id/screenshot
One-shot: xếp hàng lệnh chụp ảnh màn hình và đợi tối đa 30 giây để nhận kết quả.
[CODE BLOCK]
POST /computers/:id/disable
Vô hiệu hóa một máy tính (thu hồi token, vẫn giữ bản ghi cho mục đích kiểm toán).
[CODE BLOCK]
DELETE /computers/:id
Xóa vĩnh viễn một máy tính.
[CODE BLOCK]
Endpoint phía agent (Computer Token)
Các endpoint này được sử dụng bởi  chạy trên máy đích.
Chúng sử dụng Computer Token (trả về bởi ), không phải
Mind Key.
POST /computers/register
Đổi mã cài đặt lấy Computer Token.
[CODE BLOCK]
Phản hồi: 
> [!CRITICAL]
> Hãy lưu  — nó chỉ hiển thị một lần và là bắt buộc cho tất
> cả các endpoint phía agent.
GET /computers/me/poll
Long-poll các lệnh mới. Agent gọi endpoint này trong một vòng lặp.
[CODE BLOCK]
Trả về ngay lập tức nếu có lệnh đang chờ, hoặc sau  giây nếu không.
POST /computers/me/commands/:cid/result
Gửi kết quả thực thi của một lệnh.
[CODE BLOCK]
Các loại lệnh
| Loại | Payload | Mô tả |
|------|---------|-------------|
|  |  | Chụp màn hình dạng PNG (base64) |
|  |  | Nhấp tại tọa độ |
|  |  | Di chuyển chuột đến tọa độ |
|  |  | Nhập văn bản tại vị trí con trỏ |
|  |  | Nhấn tổ hợp phím |
|  |  | Cuộn wheel |
|  |  | Kéo và thả |
Mẫu phổ biến: Tự động hóa GUI điều khiển bởi LLM
[CODE BLOCK]
Bước tiếp theo
- Browser Proxy — dịch vụ riêng cho tự động hóa trình duyệt
- Hướng dẫn Self-Hosted Agents