# Использование 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 и подведи итог по основным командам для профилей браузера.
```