# Instrucciones para el agente: Gemini Deep Research: solicita informes mediante la API de Google

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
- Guía completa: https://lab.wisd.ai/hub/google-deep-research-api

---

## 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: prepara el proyecto de API

Para la ruta Python, comprueba Python ≥3.10 y pip, según el [manifiesto del SDK](https://github.com/googleapis/python-genai/blob/main/pyproject.toml). Instala `google-genai` con `pip install -U google-genai` y configura `GEMINI_API_KEY` en tu entorno privado con una clave de AI Studio autorizada para el agente.

### Paso 2: inicia una pregunta pública de prueba

Guarda este ejemplo de la guía oficial como `investigar.py`:

```python
import time
from google import genai

client = genai.Client()
interaction = client.interactions.create(
    input="Research the history of Google TPUs.",
    agent="deep-research-preview-04-2026",
    background=True,
)
print(f"Research started: {interaction.id}")
while True:
    interaction = client.interactions.get(interaction.id)
    if interaction.status == "completed":
        print(interaction.steps[-1].content[0].text)
        break
    elif interaction.status == "failed":
        print(f"Research failed: {interaction.error}")
        break
    time.sleep(10)
```

Ejecuta `python investigar.py` desde esa carpeta. Conserva el ID impreso para consultar esa ejecución si interrumpes el proceso. El agente devuelve un informe sobre la historia de las TPU. Segundo plano requiere almacenamiento: conserva el valor predeterminado de `store` y no lo desactives.

## Comprobación

La interacción debe alcanzar un estado final y entregar un informe. Abre varias citas y comprueba que respaldan las afirmaciones correspondientes.

## Si algo falla

Si la solicitud falla, revisa acceso al agente, identificador y requisito de almacenamiento para segundo plano. No vuelvas a iniciar una investigación si solo necesitas consultar la interacción ya creada.