{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Uso del agente de IA","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-del-agente-de-ia","__idx":0},"children":["Uso del agente de IA"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Esta página explica cómo usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli"]}," con asistentes de codificación de IA como Codex, Claude Code, Cursor, Gemini CLI y otros."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"copiar-al-agente","__idx":1},"children":["Copiar al agente"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copie el siguiente texto y péguelo en su asistente de IA para configurar MoreLogin CLI automáticamente:"]},{"$$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":["También puede generar el mismo texto desde una CLI ya 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":["Después de la instalación, los agentes deben leer la guía integrada:"]},{"$$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":["La guía le dice al agente:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cuándo usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cómo descubrir formatos de comandos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cómo mapear lenguaje natural a comandos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cuándo pedir confirmación"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cómo manejar errores 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 la conectividad de la 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 la resolución del puerto y llama al endpoint de estado local de MoreLogin."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comandos-de-conveniencia-para-perfiles-de-navegador","__idx":4},"children":["Comandos de conveniencia para perfiles de navegador"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use estos comandos cuando los usuarios se refieran a perfiles por nombre:"]},{"$$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"]}," busca en el nombre del entorno, nombre del grupo, nombre de la etiqueta y comentarios a través de la API local de MoreLogin."," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["env open"]}," inicia el perfil solo cuando coincide exactamente un candidato. Si coinciden varios perfiles, imprime los candidatos y sale sin iniciar nada."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comandos-de-conveniencia-para-teléfonos-en-la-nube","__idx":5},"children":["Comandos de conveniencia para teléfonos en la nube"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use estos comandos cuando los usuarios se refieran a teléfonos en la nube por nombre:"]},{"$$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"]}," busca en el nombre del teléfono en la nube, nombre del grupo, nombre de la etiqueta y comentarios a través de la API local de MoreLogin."," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudphone open"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudphone close"]}," operan solo cuando coincide exactamente un candidato. Si coinciden varios teléfonos, imprimen los candidatos y salen sin cambiar el estado."," ","Para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--headless"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," muestra la ventana del teléfono en la nube y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," no la muestra. El valor predeterminado de la API es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ejemplos-de-lenguaje-natural","__idx":6},"children":["Ejemplos de lenguaje natural"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Después de la configuración, puede preguntar:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"¿Cuántos perfiles de navegador hay en la primera página de MoreLogin?\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Muéstrame la primera página de perfiles de navegador de MoreLogin, incluyendo nombre, ID y estado.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre el perfil P-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Comprueba si el perfil P-1 ya está en ejecución.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Cierra el perfil P-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Busca perfiles de navegador cuyos nombres contengan Amazon.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Busca perfiles donde el nombre del entorno, grupo, etiqueta o comentario contenga Amazon.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre el entorno de navegador cuyo grupo o etiqueta contenga Amazon. Si hay más de uno, muestra los candidatos primero.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Inicia el primer perfil de navegador y dime el puerto de depuración.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Muéstrame todos los grupos de MoreLogin.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Muéstrame todas las etiquetas de MoreLogin.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Muéstrame la primera página de registros de proxy.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Muéstrame la lista de teléfonos en la nube.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre el teléfono en la nube CP-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Busca teléfonos en la nube cuyo grupo, etiqueta o comentario contenga Android.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Abre el teléfono en la nube cuyo nombre, grupo, etiqueta o comentario contenga CP-204 y muestra la ventana.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Cierra el teléfono en la nube CP-1.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Lee la ayuda de ml-cli y resume los comandos comunes de perfiles de navegador.\n","lang":"text"},"children":[]}]},"headings":[{"value":"Uso del agente de IA","id":"uso-del-agente-de-ia","depth":1},{"value":"Copiar al agente","id":"copiar-al-agente","depth":2},{"value":"Comando Agent Guide","id":"comando-agent-guide","depth":2},{"value":"Comando Doctor","id":"comando-doctor","depth":2},{"value":"Comandos de conveniencia para perfiles de navegador","id":"comandos-de-conveniencia-para-perfiles-de-navegador","depth":2},{"value":"Comandos de conveniencia para teléfonos en la nube","id":"comandos-de-conveniencia-para-teléfonos-en-la-nube","depth":2},{"value":"Ejemplos de lenguaje natural","id":"ejemplos-de-lenguaje-natural","depth":2}],"frontmatter":{"seo":{"title":"Uso del agente de IA"}},"lastModified":"2026-07-06T01:44:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/cli/agent","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}