# Використання AI-агента

На цій сторінці пояснюється, як використовувати `ml-cli` з помічниками кодування на основі ШІ, такими як Codex, Claude Code, Cursor, Gemini CLI та іншими.

## Скопіювати в агент

Скопіюйте текст нижче та вставте його у вашого ШІ-помічника для автоматичного налаштування 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.
```

Ви також можете згенерувати той самий текст із встановленого CLI:

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

## Команда Agent Guide

Після встановлення агенти повинні прочитати вбудований посібник:

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

Посібник повідомляє агенту:

- коли використовувати `ml-cli`
- як виявляти формати команд
- як зіставляти природну мову з командами
- коли запитувати підтвердження
- як обробляти помилки локальної пісочниці, такі як `connect EPERM 127.0.0.1:40000`


## Команда Doctor

Використовуйте `doctor` для перевірки підключення до локального API:

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

`doctor` перевіряє виявлення порту та викликає кінцеву точку статусу MoreLogin.

## Зручні команди для профілів браузера

Використовуйте ці команди, коли користувачі посилаються на профілі за іменем:

```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` шукає за назвою середовища, назвою групи, назвою тегу та приміткою через локальний API MoreLogin.
`env open` запускає профіль лише при точному збігу одного кандидата. Якщо збігаються кілька профілів, виводить список кандидатів і завершується без запуску.

## Зручні команди для хмарних телефонів

Використовуйте ці команди, коли користувачі посилаються на хмарні телефони за іменем:

```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` шукає за назвою хмарного телефону, назвою групи, назвою тегу та приміткою через локальний API MoreLogin.
`cloudphone open` та `cloudphone close` працюють лише при точному збігу одного кандидата. Якщо збігаються кілька телефонів, виводять список кандидатів і завершуються без зміни стану.
Для `--headless`: `false` відображає вікно хмарного телефону, `true` — не відображає. Значення API за замовчуванням — `true`.

## Приклади природною мовою

Після налаштування ви можете запитати:

```text
Скільки профілів браузера на першій сторінці в MoreLogin?
```

```text
Покажи мені першу сторінку профілів браузера MoreLogin, включаючи ім'я, ID та статус.
```

```text
Відкрий профіль P-1.
```

```text
Перевір, чи запущений профіль P-1.
```

```text
Закрий профіль P-1.
```

```text
Знайди профілі браузера, в іменах яких є Amazon.
```

```text
Знайди профілі, в назві середовища, групи, тегу або примітці яких є Amazon.
```

```text
Відкрий середовище браузера, група або тег якого містить Amazon. Якщо кілька — спочатку покажи кандидатів.
```

```text
Запусти перший профіль браузера і скажи мені порт налагодження.
```

```text
Покажи всі групи MoreLogin.
```

```text
Покажи всі теги MoreLogin.
```

```text
Покажи першу сторінку записів проксі.
```

```text
Покажи список хмарних телефонів.
```

```text
Відкрий хмарний телефон CP-1.
```

```text
Знайди хмарні телефони, група, тег або примітка яких містить Android.
```

```text
Відкрий хмарний телефон, ім'я, група, тег або примітка якого містить CP-204, і покажи вікно.
```

```text
Закрий хмарний телефон CP-1.
```

```text
Прочитай довідку ml-cli і підсумуй основні команди для профілів браузера.
```