# Uso do AI Agent

Esta página explica como usar `ml-cli` com assistentes de codificação de IA como Codex, Claude Code, Cursor, Gemini CLI e outros.

## Copiar para o agente

Copie o texto abaixo e cole-o no seu assistente de IA para configurar o MoreLogin CLI automaticamente:

```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.
```

Você também pode gerar o mesmo texto a partir de uma CLI já instalada:

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

## Comando Agent Guide

Após a instalação, os agentes devem ler o guia integrado:

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

O guia informa ao agente:

- quando usar `ml-cli`
- como descobrir formatos de comandos
- como mapear linguagem natural para comandos
- quando pedir confirmação
- como lidar com erros de sandbox local como `connect EPERM 127.0.0.1:40000`


## Comando Doctor

Use `doctor` para verificar a conectividade da API local:

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

`doctor` verifica a resolução de porta e chama o endpoint de status local do MoreLogin.

## Comandos de conveniência para perfis de navegador

Use estes comandos quando os utilizadores se referirem a perfis por nome:

```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` pesquisa no nome do ambiente, nome do grupo, nome da etiqueta e observações através da API local do MoreLogin.
`env open` inicia o perfil apenas quando corresponde exatamente a um candidato. Se vários perfis corresponderem, imprime os candidatos e sai sem iniciar nada.

## Comandos de conveniência para telefones na nuvem

Use estes comandos quando os utilizadores se referirem a telefones na nuvem por nome:

```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` pesquisa no nome do telefone na nuvem, nome do grupo, nome da etiqueta e observações através da API local do MoreLogin.
`cloudphone open` e `cloudphone close` operam apenas quando corresponde exatamente a um candidato. Se vários telefones corresponderem, imprimem os candidatos e saem sem alterar o estado.
Para `--headless`, `false` exibe a janela do telefone na nuvem e `true` não a exibe. O valor padrão da API é `true`.

## Exemplos de linguagem natural

Após a configuração, pode perguntar:

```text
Quantos perfis de navegador existem na primeira página do MoreLogin?
```

```text
Mostra-me a primeira página de perfis de navegador do MoreLogin, incluindo nome, ID e estado.
```

```text
Abre o perfil P-1.
```

```text
Verifica se o perfil P-1 já está em execução.
```

```text
Fecha o perfil P-1.
```

```text
Procura perfis de navegador cujos nomes contenham Amazon.
```

```text
Procura perfis onde o nome do ambiente, grupo, etiqueta ou observação contenha Amazon.
```

```text
Abre o ambiente de navegador cujo grupo ou etiqueta contenha Amazon. Se houver mais de um, mostra os candidatos primeiro.
```

```text
Inicia o primeiro perfil de navegador e diz-me a porta de depuração.
```

```text
Mostra-me todos os grupos do MoreLogin.
```

```text
Mostra-me todas as etiquetas do MoreLogin.
```

```text
Mostra-me a primeira página de registos de proxy.
```

```text
Mostra-me a lista de telefones na nuvem.
```

```text
Abre o telefone na nuvem CP-1.
```

```text
Procura telefones na nuvem cujo grupo, etiqueta ou observação contenha Android.
```

```text
Abre o telefone na nuvem cujo nome, grupo, etiqueta ou observação contenha CP-204 e mostra a janela.
```

```text
Fecha o telefone na nuvem CP-1.
```

```text
Lê a ajuda do ml-cli e resume os comandos comuns de perfis de navegador.
```