# Instrucciones para el agente: Inkeep Agents: edita agentes con un lienzo y TypeScript

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

---

## 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: crea el proyecto

Comprueba con `node --version`, `pnpm --version` y `docker --version` que tienes Node.js ≥22 y pnpm ≥10. Arranca Docker Desktop o el servicio Docker antes de continuar. La guía indica:

```bash
npx @inkeep/create-agents my-agents
cd my-agents
pnpm setup-dev
pnpm dev
```

### Paso 2: abre el editor

Deja `pnpm dev` activo mientras pruebas. Accede a `http://localhost:3000` con `INKEEP_AGENTS_MANAGE_UI_USERNAME` e `INKEEP_AGENTS_MANAGE_UI_PASSWORD` de la configuración local generada; consúltalas en privado. Abre **Activities Planner** y pide actividades para una ciudad conocida, como indica el inicio rápido. Si la preparación solicita credenciales del proveedor, complétalas antes de la prueba. Prueba el agente de ejemplo y estudia después la guía de push/pull antes de editarlo desde dos lugares.

## Comprobación

El editor debe abrirse y el agente de ejemplo debe responder. Tras un cambio pequeño, comprueba su representación en el editor y en el código sincronizado.

## Si algo falla

Si la preparación falla, revisa Docker y las versiones de Node y pnpm. Si no puedes acceder al editor, usa las credenciales de tu instalación sin copiarlas a mensajes ni repositorios.