> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/vietnamese-documentation/dien-thoai-dam-may/control-cloud-phones-from-scripts.md).

# Điều khiển điện thoại đám mây từ các kịch bản và khách hàng AI

Liệt kê, khởi động, dừng và kết nối với điện thoại đám mây từ các script của bạn với API REST cục bộ hoặc Incogniton CLI, hoặc từ một khách hàng AI thông qua MCP.

Bật API REST cục bộ trong **Cài đặt > Tự động hóa** (bật **Bật API tự động hóa** và nhấn **Lưu**). Script của bạn và Incogniton CLI sau đó có thể liệt kê điện thoại đám mây của bạn, khởi động và dừng chúng, và nhận địa chỉ ADB cho chúng. Khách hàng AI kết nối với **MCP token** có thể liệt kê, khởi động, dừng và tạo điện thoại đám mây.

Trang này nói về việc điều khiển điện thoại từ bên ngoài ứng dụng. Đối với các tác vụ sẵn có mà bạn chạy trên điện thoại trong Incogniton, xem **Tự động hóa điện thoại** trong [Quản lý điện thoại đám mây](https://docs.incogniton.com/documentation/vietnamese-documentation/dien-thoai-dam-may/manage-cloud-phones.md#automation).

### Những gì bạn cần

* API REST cục bộ đã được bật trong **Cài đặt > Tự động hóa**. Xem [Sử dụng API REST cục bộ](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/local-rest-api.md). API tự động hóa là một tính năng trả phí.
* Incogniton mở và đăng nhập trên cùng máy tính với script của bạn. API lắng nghe trên `127.0.0.1`, cổng 35000 theo mặc định.
* Trong một nhóm, quyền điện thoại đám mây đúng: **Sử dụng điện thoại đám mây (nguồn, khởi động lại, kết nối)** để liệt kê, khởi động và dừng điện thoại, và **Quản lý điện thoại đám mây (chỉnh sửa, proxy, đặt lại, phiên bản Android, ADB, root, ứng dụng, tự động hóa, di chuyển)** để bật ADB.

### Những gì bạn có thể làm với API REST cục bộ

| Hành động                                                                                               | Endpoint                         | Lệnh CLI                   |
| ------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------- |
| Liệt kê điện thoại đám mây của nhóm bạn với ID, tên, nhóm, trạng thái, phiên bản Android và địa chỉ ADB | `GET /cloudphone/list`           | `cloudphone-list`          |
| Khởi động điện thoại mà không mở màn hình của chúng (cho ADB, ứng dụng và tự động hóa)                  | `POST /cloudphone/start`         | `cloudphone-start`         |
| Khởi động điện thoại và mở màn hình của từng cái trong một cửa sổ trong Incogniton                      | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Tắt nguồn điện thoại                                                                                    | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Bật ADB trên một điện thoại đang chạy và nhận địa chỉ cục bộ của nó                                     | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Khởi động và dừng nhận một danh sách từ 1 đến 100 ID điện thoại từ danh sách điện thoại. Mỗi điện thoại được kiểm tra riêng (phút còn lại, đăng ký hoạt động, proxy đã đặt, không đặt lại), vì vậy một số điện thoại có thể khởi động trong khi những cái khác bị từ chối; câu trả lời đưa ra lý do cho từng điện thoại.

Một điện thoại khởi động theo cách này sẽ tiếp tục chạy, và sử dụng phút, cho đến khi bạn dừng nó. Dừng một điện thoại cũng đóng cửa sổ của nó và kết nối ADB cục bộ trong Incogniton.

Hành động ADB trả về một địa chỉ cục bộ như `127.0.0.1:6555`. Kết nối với nó bằng `adb connect`, chính xác như địa chỉ từ **Sao chép lệnh ADB** trong ứng dụng. Điện thoại phải đang chạy. Xem [Kết nối với điện thoại đám mây bằng ADB](https://docs.incogniton.com/documentation/vietnamese-documentation/dien-thoai-dam-may/connect-to-a-cloud-phone-with-adb.md).

Bạn không thể chỉnh sửa, khởi động lại hoặc đặt lại một điện thoại đám mây thông qua API REST cục bộ. Làm điều đó trong ứng dụng: xem [Chỉnh sửa, khởi động lại hoặc đặt lại điện thoại đám mây](https://docs.incogniton.com/documentation/vietnamese-documentation/dien-thoai-dam-may/edit-restart-and-reset-cloud-phones.md).

### Sử dụng Incogniton CLI

Mỗi hành động trên đều có một lệnh CLI tương ứng. Nhấn **Tải xuống CLI** trên tab **Tự động hóa** để cài đặt nó; trong khi nó được cài đặt, nó tự cập nhật khi ứng dụng khởi động. Chạy `incogniton-cli cloudphone-list` để xem điện thoại của bạn và ID của chúng. Xem [tài liệu CLI](https://api-docs.incogniton.com/cli) để biết cách các lệnh, cờ và đầu ra hoạt động.

### Điều khiển điện thoại đám mây từ một khách hàng AI (MCP)

Khi bạn kết nối một khách hàng AI như Claude hoặc Cursor với một MCP token (**Cài đặt > Tự động hóa > Tạo MCP Token**, xem [Kết nối khách hàng AI với MCP](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/connect-ai-clients-mcp.md)), khách hàng AI có thể:

* **Liệt kê** điện thoại đám mây của bạn với trạng thái của chúng và liệu ADB có bật hay không.
* **Khởi động** điện thoại mà không có màn hình, cho ADB, ứng dụng đã cài đặt và tự động hóa.
* **Dừng** điện thoại.
* **Tạo** một điện thoại đám mây mới với một proxy từ Thư viện Proxy của bạn.

Các công cụ MCP chạy trên máy chủ của Incogniton, vì vậy chúng cũng hoạt động khi ứng dụng Incogniton đóng. Chúng không thể mở màn hình của điện thoại: để xem điện thoại, mở nó trong ứng dụng (**Điện thoại đám mây**, sau đó **Bật nguồn** hoặc **Kết nối**). Một điện thoại khởi động thông qua MCP tiếp tục chạy cho đến khi nó bị dừng, hoặc cho đến khi ứng dụng Incogniton của bạn đóng trong khi **Dừng điện thoại đám mây của tôi khi Incogniton đóng** đang bật (điện thoại đang chạy một tác vụ tự động hóa tiếp tục chạy).

{% hint style="info" %}
Tài liệu dành cho nhà phát triển tại [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) bao gồm các endpoint hồ sơ, cookie và tự động hóa. Nếu bạn có câu hỏi về việc tự động hóa điện thoại đám mây, liên hệ với [bộ phận hỗ trợ của chúng tôi](https://incogniton.com/contact/).
{% endhint %}
