# Instrucciones para el agente: ARTEMIS: controla Android con instrucciones y recoge evidencias

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/google/artemis (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/artemis-android

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: conecta un dispositivo de prueba

Comprueba que Git está disponible y que Python ≥3.12 puede usarse en el entorno. Conecta un Android de prueba con depuración USB o un emulador y acepta su autorización. Lee Quick Start del README y revisa las instalaciones de herramientas y configuraciones globales que propone el script.

### Paso 2: inicia ARTEMIS

Caso macOS/Linux del README:

```bash
git clone https://github.com/google/artemis.git && cd artemis
./start.sh
```

En Windows sigue el caso PowerShell del README con `.\start.bat`. Revisa las propuestas de MCP y reglas antes de aceptarlas.

### Paso 3: configura una tarea pequeña

Abre http://localhost:8000 y sigue el asistente de conexión del dispositivo y del proveedor. Puedes empezar con la consulta de batería documentada:

```bash
uv run artemis run "Abre Ajustes, busca Batería y dime el nivel actual" --profile flash
```

### Paso 4: conecta MCP si lo necesitas

Lee MCP Setup en el README. Para obtener una configuración específica de tu cliente, usa el procedimiento `mcp --generate-config <client>` que documenta el proyecto, sustituyendo el marcador por el cliente correspondiente.

## Comprobación

Contrasta la respuesta sobre batería con la pantalla real y revisa la traza. Comprueba que el agente actuó en el dispositivo correcto y recogió evidencia del resultado.

## Si algo falla

Revisa autorización de depuración, dispositivo seleccionado y proveedor. Si la web abre pero no hay acciones, empieza por el asistente de conexión. Si falla una posición de pantalla, inspecciona la captura y los elementos disponibles antes de repetir coordenadas.