# Instrucciones para el agente: Cloudflare Agents: agentes con estado persistente

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/cloudflare/agents (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/cloudflare-agents-sdk

---

## 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 Node.js 22.x ≥22.18.0 o ≥24.11.0, npm/npx y una cuenta de Cloudflare. La plantilla actual instala Babel 8, cuyo [manifiesto](https://www.npmjs.com/package/@babel/plugin-proposal-decorators/v/8.0.2) fija ese intervalo; también cubre Node ≥22 de create-cloudflare y Wrangler. El README crea un proyecto inicial con:

```sh
npm create cloudflare@latest -- --template cloudflare/agents-starter
```

Entra en el directorio creado por el asistente (por defecto `agents-starter`) y sigue el [inicio rápido de la plantilla](https://github.com/cloudflare/agents-starter#quick-start):

```sh
cd agents-starter
npm install
```

Autentica Wrangler desde una terminal interactiva con `npx wrangler login`, como indica la plantilla, usando el ejecutable de la dependencia local. Después, desde esa misma carpeta:

```sh
npm run dev
```

Abre `http://localhost:5173`. La plantilla usa Workers AI remoto incluso en desarrollo. Para un proyecto existente, como ruta alternativa, el README documenta:

```sh
npm install agents
```

Prueba primero el estado y la comunicación sin añadir acciones externas.

## Comprobación

Pide «Calcula 5000 por 3», el caso de aprobación del README de la plantilla. Comprueba que pide permiso y devuelve `15000` después de aprobar. Recarga la misma conversación y confirma que persiste su historial. Esto prueba la herramienta de cálculo y la persistencia de esa sesión; no presupone que la herramienta de tiempo de la demo consulte datos reales.

## Si algo falla

Si falla la conexión, revisa el enrutamiento al agente y los ajustes de la plantilla. Para errores de despliegue o almacenamiento, consulta la documentación de Agents y Durable Objects.

Consulta [el README oficial](https://github.com/cloudflare/agents#readme) para requisitos y variantes de instalación.