{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/pt/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Uso do AI Agent","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"uso-do-ai-agent","__idx":0},"children":["Uso do AI Agent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Esta página explica como usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli"]}," com assistentes de codificação de IA como Codex, Claude Code, Cursor, Gemini CLI e outros."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"copiar-para-o-agente","__idx":1},"children":["Copiar para o agente"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copie o texto abaixo e cole-o no seu assistente de IA para configurar o MoreLogin CLI automaticamente:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Set up MoreLogin CLI for me, then use it whenever I ask you to operate MoreLogin.\n\nOfficial docs:\nhttps://guide.morelogin.com/cli\n\nGoal:\n- Install or update `ml-cli`.\n- Verify MoreLogin Desktop local API access.\n- Read the built-in agent package and guide.\n- After setup, ask what MoreLogin task I want to automate first.\n\nFirst detect my OS and CPU architecture, then run the matching install command.\n\nWindows x64 PowerShell:\n\n```powershell\n$dir = \"$env:USERPROFILE\\.morelogin\\bin\"\nNew-Item -ItemType Directory -Force -Path $dir | Out-Null\nInvoke-WebRequest -Uri \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_window_x64_cli/2.6.3/MoreLogin_AirDrop_window_x64_cli_2.6.3.0.exe\" -OutFile \"$dir\\ml-cli.exe\"\n$userPath = [Environment]::GetEnvironmentVariable(\"Path\", \"User\")\nif ($userPath -notlike \"*$dir*\") { [Environment]::SetEnvironmentVariable(\"Path\", \"$userPath;$dir\", \"User\") }\n& \"$dir\\ml-cli.exe\" --version\n```\n\nmacOS Intel x64:\n\n```bash\nmkdir -p \"$HOME/.local/bin\"\ncurl -L \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_darwin_x64_cli/2.6.3/MoreLogin_AirDrop_darwin_x64_cli_2.6.3.0\" -o \"$HOME/.local/bin/ml-cli\"\nchmod +x \"$HOME/.local/bin/ml-cli\"\nexport PATH=\"$HOME/.local/bin:$PATH\"\nml-cli --version\n```\n\nmacOS Apple Silicon arm64:\n\n```bash\nmkdir -p \"$HOME/.local/bin\"\ncurl -L \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_darwin_arm64_cli/2.6.3/MoreLogin_AirDrop_darwin_arm64_cli_2.6.3.0\" -o \"$HOME/.local/bin/ml-cli\"\nchmod +x \"$HOME/.local/bin/ml-cli\"\nexport PATH=\"$HOME/.local/bin:$PATH\"\nml-cli --version\n```\n\nLinux x64:\n\n```bash\nmkdir -p \"$HOME/.local/bin\"\ncurl -L \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_linux_x64_cli/2.6.3/MoreLogin_AirDrop_linux_x64_cli_2.6.3.0\" -o \"$HOME/.local/bin/ml-cli\"\nchmod +x \"$HOME/.local/bin/ml-cli\"\nexport PATH=\"$HOME/.local/bin:$PATH\"\nml-cli --version\n```\n\nAfter installation, run:\n\n```bash\nml-cli --help\nml-cli doctor --output-json\nml-cli agent-bootstrap\nml-cli agent-package\nml-cli agent-guide\n```\n\nFor long-term use, install persistent rules for my AI agent:\n\n```bash\nml-cli agent-list\nml-cli agent-init --agent <agent> --scope user --dry-run\nml-cli agent-init --agent <agent> --scope user --write\n```\n\nUse the correct `<agent>` value for my AI client. Supported values are listed by `ml-cli agent-list`, including `codex`, `claude-code`, `cursor`, `gemini`, `qwen-code`, `opencode`, `openclaw`, `trae`, `hermes`, `qclaw`, `easyclaw`, and `workbuddy`.\n\nUse `ml-cli` for MoreLogin browser profiles, environment lists, cloud phones, proxies, groups, tags, schedules, and local API status.\n\nDo not guess IDs, payload fields, or command formats. If unsure, inspect help first:\n\n```bash\nml-cli env --help\nml-cli cloudphone --help\nml-cli proxy --help\nml-cli schedule --help\n```\n\nOperation timing:\n- `env start` / `env open` takes 3-5 seconds; use `--timeout 30`.\n- `cloudphone power-on` / `cloudphone open` takes 30-90 seconds; always use `--timeout 120`.\n- All other commands complete within the default `--timeout 15`.\n\nNatural language routing rules:\n- \"How many browser profiles are on the first page?\" -> run `ml-cli env list --page-no 1 --page-size 20`, then count `data.dataList`.\n- \"Open P-1\" -> run `ml-cli --timeout 30 env open --name P-1`.\n- \"Find browser profiles by group, tag, name, or remark containing Amazon\" -> run `ml-cli env find --keyword Amazon`.\n- \"Open the profile whose group, tag, name, or remark contains Amazon\" -> run `ml-cli --timeout 30 env open --keyword Amazon`.\n- \"Open cloud phone CP-204 and show the window\" -> run `ml-cli --timeout 120 cloudphone open --keyword CP-204 --headless false`.\n- \"Close cloud phone CP-204\" -> run `ml-cli --timeout 30 cloudphone close --keyword CP-204`.\n- \"Create a new browser profile\" -> run `ml-cli env create-quick`.\n- \"Delete browser profile P-1\" -> find it first with `ml-cli env find --name P-1`, confirm with the user, then run `ml-cli env delete --env-ids <id>`.\n- \"Create a proxy\" -> run `ml-cli proxy create --proxy-ip <ip> --proxy-port <port> --proxy-provider 0`.\n- \"Show all tags\" -> run `ml-cli tag list`.\n- \"Create a group called test\" -> run `ml-cli group create --group-name test`.\n- \"Set proxy for profile P-1\" -> find the profile first, then run `ml-cli env set-proxy --env-ids <id> --proxy-ip <ip> --proxy-port <port> --proxy-type 0 --proxy-provider 0`.\n\nCandidate selection rule:\n- `env open`, `cloudphone open`, and `cloudphone close` may operate only when exactly one candidate matches.\n- If zero or multiple candidates match, show the candidates and ask me which one to operate.\n\nLocal access rule:\nMoreLogin CLI connects to `127.0.0.1:<port>`, usually `127.0.0.1:40000`. Started browser profiles may expose `127.0.0.1:<debugPort>`.\nIf Codex, Claude Code, Cursor, or another AI client reports `connect EPERM 127.0.0.1:40000`, `connect EPERM 127.0.0.1:<debugPort>`, `connection refused`, `request timeout`, or `Could not detect MoreLogin port`, treat it as local sandbox/permission first. Request local access approval or elevated execution and rerun the same command. Do not repeatedly start the same profile after an EPERM error; check status first.\n\nWhen a command fails, show the original MoreLogin response. Do not redact proxy passwords, phone numbers, device identifiers, or other fields unless I explicitly ask you to. For scripts, add `--fail-on-business-error` when a non-zero top-level JSON `code` should fail the command.\n\nFuture updates:\n- To update `ml-cli`, run `ml-cli self-update`. Or rerun this setup prompt and overwrite the existing binary with the newest official download.\n- To update persistent agent rules, rerun `ml-cli agent-init --agent <agent> --scope <scope> --write`.\n- Restart the AI agent if it only loads memory/rules files on startup.\n\nAfter verification, tell me:\n- install path\n- `ml-cli --version`\n- `ml-cli doctor --output-json` result\n- available top-level commands\n\nThen ask me what MoreLogin task I want to automate first.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você também pode gerar o mesmo texto a partir de uma CLI já instalada:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli install-prompt\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comando-agent-guide","__idx":2},"children":["Comando Agent Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Após a instalação, os agentes devem ler o guia integrado:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli agent-guide\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O guia informa ao agente:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["quando usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["como descobrir formatos de comandos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["como mapear linguagem natural para comandos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["quando pedir confirmação"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["como lidar com erros de sandbox local como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connect EPERM 127.0.0.1:40000"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comando-doctor","__idx":3},"children":["Comando Doctor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["doctor"]}," para verificar a conectividade da API local:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli doctor\nml-cli doctor --output-json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["doctor"]}," verifica a resolução de porta e chama o endpoint de status local do MoreLogin."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comandos-de-conveniência-para-perfis-de-navegador","__idx":4},"children":["Comandos de conveniência para perfis de navegador"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use estes comandos quando os utilizadores se referirem a perfis por nome:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli env find --name P-1\nml-cli env find --keyword Amazon\nml-cli env open --name P-1\nml-cli env open --keyword \"team-a\"\nml-cli env open --name P-1 --exact\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["env find --keyword"]}," pesquisa no nome do ambiente, nome do grupo, nome da etiqueta e observações através da API local do MoreLogin."," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comandos-de-conveniência-para-telefones-na-nuvem","__idx":5},"children":["Comandos de conveniência para telefones na nuvem"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use estes comandos quando os utilizadores se referirem a telefones na nuvem por nome:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli cloudphone find --name CP-1\nml-cli cloudphone find --keyword \"android-test\"\nml-cli --timeout 120 cloudphone open --name CP-1\nml-cli --timeout 120 cloudphone open --keyword \"android-test\"\nml-cli --timeout 120 cloudphone open --name CP-1 --headless false\nml-cli --timeout 30 cloudphone close --name CP-1\nml-cli --timeout 30 cloudphone close --keyword \"android-test\"\nml-cli --timeout 120 cloudphone open --name CP-1 --exact\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudphone open"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--headless"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," exibe a janela do telefone na nuvem e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," não a exibe. O valor padrão da API é ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"exemplos-de-linguagem-natural","__idx":6},"children":["Exemplos de linguagem natural"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Após a configuração, pode perguntar:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Quantos perfis de navegador existem na primeira página do MoreLogin?\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Mostra-me a primeira página de perfis de navegador do MoreLogin, incluindo nome, ID e estado.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre o perfil P-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Verifica se o perfil P-1 já está em execução.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Fecha o perfil P-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Procura perfis de navegador cujos nomes contenham Amazon.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Procura perfis onde o nome do ambiente, grupo, etiqueta ou observação contenha Amazon.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre o ambiente de navegador cujo grupo ou etiqueta contenha Amazon. Se houver mais de um, mostra os candidatos primeiro.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Inicia o primeiro perfil de navegador e diz-me a porta de depuração.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Mostra-me todos os grupos do MoreLogin.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Mostra-me todas as etiquetas do MoreLogin.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Mostra-me a primeira página de registos de proxy.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Mostra-me a lista de telefones na nuvem.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre o telefone na nuvem CP-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Procura telefones na nuvem cujo grupo, etiqueta ou observação contenha Android.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre o telefone na nuvem cujo nome, grupo, etiqueta ou observação contenha CP-204 e mostra a janela.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Fecha o telefone na nuvem CP-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Lê a ajuda do ml-cli e resume os comandos comuns de perfis de navegador.\n","lang":"text"},"children":[]}]},"headings":[{"value":"Uso do AI Agent","id":"uso-do-ai-agent","depth":1},{"value":"Copiar para o agente","id":"copiar-para-o-agente","depth":2},{"value":"Comando Agent Guide","id":"comando-agent-guide","depth":2},{"value":"Comando Doctor","id":"comando-doctor","depth":2},{"value":"Comandos de conveniência para perfis de navegador","id":"comandos-de-conveniência-para-perfis-de-navegador","depth":2},{"value":"Comandos de conveniência para telefones na nuvem","id":"comandos-de-conveniência-para-telefones-na-nuvem","depth":2},{"value":"Exemplos de linguagem natural","id":"exemplos-de-linguagem-natural","depth":2}],"frontmatter":{"seo":{"title":"Uso do AI Agent"}},"lastModified":"2026-07-06T01:44:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt/cli/agent","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}