# Instrucciones para el agente: Google ADK: desarrolla agentes y flujos en Python

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: intermedio
- Proyecto: https://github.com/google/adk-python (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/google-agent-devkit

---

## 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

Comprueba que tienes Python ≥3.11 y pip en tu entorno de proyecto. El README recomienda usar su archivo de restricciones para la versión concreta de Python; enlaza los archivos para 3.11–3.15. Instala el paquete documentado:

```bash
pip install google-adk
```

Crea el proyecto con el [inicio rápido oficial](https://adk.dev/get-started/python/):

```bash
adk create my_agent
```

Configura `GOOGLE_API_KEY` de AI Studio en `my_agent/.env` de forma privada. Sustituye `my_agent/agent.py` por el ejemplo de herramienta del tutorial:

```python
from google.adk.agents.llm_agent import Agent

def get_current_time(city: str) -> dict:
    """Returns the current time in a specified city."""
    return {"status": "success", "city": city, "time": "10:30 AM"}

root_agent = Agent(
    model="gemini-flash-latest",
    name="root_agent",
    description="Tells the current time in a specified city.",
    instruction="Use get_current_time to tell the current time in cities.",
    tools=[get_current_time],
)
```

Desde la carpeta que contiene `my_agent`, ejecuta `adk run my_agent` y pregunta la hora de Madrid. La herramienta de demostración devuelve siempre `10:30 AM`: comprueba su invocación y esa salida, que es simulada. El tutorial web aún dice Python ≥3.10; esta ruta conserva ≥3.11 del README y manifiesto actuales.

## Comprobación

Verifica entradas, herramienta utilizada y salida esperada en una tarea pequeña antes de añadir delegación.

## Si algo falla

Comprueba compatibilidad de Python y restricciones de dependencias de la versión instalada.