# Sử dụng AI Agent

Trang này giải thích cách sử dụng `ml-cli` với các trợ lý lập trình AI như Codex, Claude Code, Cursor, Gemini CLI và các công cụ khác.

## Sao chép vào Agent

Sao chép văn bản bên dưới và dán vào trợ lý AI của bạn để tự động cài đặt MoreLogin CLI:

```text
This template's language is not my preference. Before your first substantive reply, detect and use my OS UI language (Windows: `Get-UICulture`, then `Get-Culture`); if unavailable, use my latest non-template message's language.

Follow the MoreLogin installation, verification, and `ml-cli` usage guide:
https://github.com/MoreLoginBrowser/morelogin-skills/blob/main/skills/morelogin-setup/install.md

Keep commands, paths, JSON/API fields, and original MoreLogin responses unchanged. Ask before permissions, login/security steps, downloads, installation, GUI launches, or state changes.
```

Bạn cũng có thể tạo cùng một văn bản từ CLI đã cài đặt:

```bash
ml-cli install-prompt
```

## Lệnh Agent Guide

Sau khi cài đặt, agent nên đọc hướng dẫn tích hợp:

```bash
ml-cli agent-guide
```

Hướng dẫn cho agent biết:

- khi nào sử dụng `ml-cli`
- cách khám phá định dạng lệnh
- cách ánh xạ ngôn ngữ tự nhiên thành lệnh
- khi nào cần xác nhận
- cách xử lý lỗi sandbox cục bộ như `connect EPERM 127.0.0.1:40000`


## Lệnh Doctor

Sử dụng `doctor` để xác minh kết nối API cục bộ:

```bash
ml-cli doctor
ml-cli doctor --output-json
```

`doctor` kiểm tra khám phá cổng và gọi endpoint trạng thái cục bộ của MoreLogin.

## Lệnh tiện ích cho hồ sơ trình duyệt

Sử dụng các lệnh này khi người dùng tham chiếu hồ sơ theo tên:

```bash
ml-cli env find --name P-1
ml-cli env find --keyword Amazon
ml-cli env open --name P-1
ml-cli env open --keyword "team-a"
ml-cli env open --name P-1 --exact
```

`env find --keyword` tìm kiếm tên môi trường, tên nhóm, tên thẻ và ghi chú qua API cục bộ của MoreLogin.
`env open` chỉ khởi động hồ sơ khi khớp chính xác một ứng viên. Nếu nhiều hồ sơ khớp, nó in danh sách ứng viên và thoát mà không khởi động gì.

## Lệnh tiện ích cho điện thoại đám mây

Sử dụng các lệnh này khi người dùng tham chiếu điện thoại đám mây theo tên:

```bash
ml-cli cloudphone find --name CP-1
ml-cli cloudphone find --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1
ml-cli --timeout 120 cloudphone open --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --headless false
ml-cli --timeout 30 cloudphone close --name CP-1
ml-cli --timeout 30 cloudphone close --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --exact
```

`cloudphone find --keyword` tìm kiếm tên điện thoại đám mây, tên nhóm, tên thẻ và ghi chú qua API cục bộ của MoreLogin.
`cloudphone open` và `cloudphone close` chỉ hoạt động khi khớp chính xác một ứng viên. Nếu nhiều điện thoại khớp, chúng in danh sách ứng viên và thoát mà không thay đổi trạng thái.
Đối với `--headless`, `false` hiển thị cửa sổ điện thoại đám mây và `true` không hiển thị. Giá trị mặc định của API là `true`.

## Ví dụ ngôn ngữ tự nhiên

Sau khi cài đặt, bạn có thể hỏi:

```text
Có bao nhiêu hồ sơ trình duyệt trên trang đầu tiên của MoreLogin?
```

```text
Hiển thị trang đầu tiên của hồ sơ trình duyệt MoreLogin, bao gồm tên, ID và trạng thái.
```

```text
Mở hồ sơ P-1.
```

```text
Kiểm tra xem hồ sơ P-1 đã chạy chưa.
```

```text
Đóng hồ sơ P-1.
```

```text
Tìm hồ sơ trình duyệt có tên chứa Amazon.
```

```text
Tìm hồ sơ có tên môi trường, nhóm, thẻ hoặc ghi chú chứa Amazon.
```

```text
Mở môi trường trình duyệt có nhóm hoặc thẻ chứa Amazon. Nếu có nhiều hơn một, hiển thị danh sách ứng viên trước.
```

```text
Khởi động hồ sơ trình duyệt đầu tiên và cho tôi biết cổng gỡ lỗi.
```

```text
Hiển thị tất cả các nhóm MoreLogin.
```

```text
Hiển thị tất cả các thẻ MoreLogin.
```

```text
Hiển thị trang đầu tiên của bản ghi proxy.
```

```text
Hiển thị danh sách điện thoại đám mây.
```

```text
Mở điện thoại đám mây CP-1.
```

```text
Tìm điện thoại đám mây có nhóm, thẻ hoặc ghi chú chứa Android.
```

```text
Mở điện thoại đám mây có tên, nhóm, thẻ hoặc ghi chú chứa CP-204 và hiển thị cửa sổ.
```

```text
Đóng điện thoại đám mây CP-1.
```

```text
Đọc trợ giúp ml-cli và tóm tắt các lệnh hồ sơ trình duyệt phổ biến.
```