Ofrenda en la Nube Un altar de Día de Muertos, construido con un agente

Antes del evento

Veinte minutos de tu tiempo que te ahorran la primera media hora del taller.

Hazlo en casa con calma. El wifi de un evento no es el lugar donde quieres estar creando cuentas.

Antes de instalar, confirma dos cosas: debes ser mayor de edad y tu laptop debe permitirte instalar software. Si usas una laptop administrada por tu empresa o escuela y no tienes permisos, planea trabajar en pareja.

1. Cuenta de AWS

Necesitas un proyecto en el plan Free de la nueva experiencia de AWS. Abre el registro de AWS, sigue el flujo y termina la verificación antes del evento.

Cuando la tengas, entra a AWS Settings y apunta tu Región: View all projects → tu proyecto → Overview → Additional Info → Region.

La Región no cambia aunque actualices tu dirección de contacto. Para usar otras Regiones tendrías que activar funciones avanzadas, algo que no hacemos en este workshop. Todo lo que construyas aquí vive en la Región que aparece en AWS Settings.

2. Cuenta de GitHub

Si no tienes, créala en github.com. La necesitas para dos cosas: hacer tu copia del starter y para que Amplify publique tu altar desde tu repo.

3. Node 24.11 o más nuevo

Windows (PowerShell)

winget install OpenJS.NodeJS.LTS

macOS o Linux: instala nvm, que te deja cambiar de versión de Node sin pelearte con permisos.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash

Cierra la terminal, abre una nueva y con nvm instala Node 24:

nvm install 24
nvm alias default 24
La terminal nueva dice nvm: command not found

El instalador agrega nvm al archivo de configuración de tu shell, y si ese archivo no existía no tuvo dónde escribir. En macOS la terminal usa zsh: crea el archivo, vuelve a correr el instalador y abre otra terminal.

touch ~/.zshrc

En Linux con bash, el archivo es ~/.bashrc.

Para comprobarlo, igual en los tres sistemas:

node --version

Si imprime v24.11 o una versión más nueva de la línea 24, vas bien. Node 24 es la versión LTS usada tanto por Amplify como por las Lambdas del workshop. Si tienes Node 22, 23 o una versión anterior de 24, actualiza antes de continuar.

⚠️ Si acabas de instalar, cierra la terminal

Y vuelve a abrirla. En Windows sobre todo: el instalador cambia el PATH y la terminal que ya estaba abierta no se enteró.

4. Git

Windows (PowerShell)

winget install Git.Git

macOS: normalmente ya viene. Compruébalo con git --version y si te ofrece instalar las herramientas de desarrollador, acepta.

Linux: instala Git con el gestor de paquetes de tu distribución y comprueba con git --version.

Si nunca has usado Git, lee Git y GitHub por primera vez. Son cinco minutos y te va a evitar el atorón del módulo 1.

Antes de continuar: elige una ruta

Las dos rutas terminan con AWS CLI, el perfil ofrenda, AWS MCP Server, las skills y las reglas de la nueva experiencia configuradas. Elige una sola; no hagas las dos.

Pero antes instala Kiro desde kiro.dev/downloads y abre la app una vez. Las dos rutas lo necesitan.

  • Ruta A, configuración manual. Sigue los pasos 5, 6 y 7 si quieres ejecutar y comprobar cada comando tú mismo.
  • Ruta B, configuración con Kiro. Es la recomendada para el workshop. Kiro instala y configura todo siguiendo las instrucciones oficiales.

Abre únicamente la ruta que elegiste.

Ruta A: configuración manual, pasos 5, 6 y 7

5. AWS CLI 2.35.0 o superior

Este workshop usa AWS CLI para iniciar sesión y configurar el Agent Toolkit. Instálala desde la guía oficial, eligiendo las instrucciones de Windows, macOS o Linux.

Para comprobar la versión, igual en Windows, macOS y Linux:

aws --version

La salida debe empezar con aws-cli/2.35 o una versión más nueva.

6. Inicia sesión en tu proyecto de AWS

aws login abre el navegador y configura credenciales temporales que se actualizan automáticamente. Igual en Windows, macOS y Linux:

aws configure set region TU-REGION --profile ofrenda
aws login --region TU-REGION --profile ofrenda
aws sts get-caller-identity --profile ofrenda

Cambia TU-REGION por la Región que apuntaste en AWS Settings. El último comando debe imprimir un Account y un Arn; eso confirma que CDK ya puede usar el perfil ofrenda.

7. Configura Kiro con Agent Toolkit for AWS

Instala el Agent Toolkit siguiendo la guía oficial. El asistente de configuración instala las skills de AWS y configura la conexión con AWS MCP Server:

Igual en Windows, macOS y Linux:

aws configure agent-toolkit

Ese comando necesita AWS CLI 2.35.0 o superior. Cuando termine, reinicia Kiro para que cargue la configuración y pregunta qué skills de AWS tiene disponibles.

💡 Qué configura por debajo

Para Kiro, el Agent Toolkit agrega el servidor aws-mcp mediante mcp-proxy-for-aws, apuntando a https://aws-mcp.us-east-1.api.aws/mcp, e instala las skills del repositorio oficial con npx skills add. No ejecutes esos pasos por separado si el asistente de AWS CLI terminó correctamente.

Las skills y la búsqueda de documentación funcionan sin autenticación. Las llamadas a APIs de AWS necesitan el perfil que validaste en el paso 6. El Agent Toolkit no tiene un cargo adicional; sí consumen créditos los recursos que Kiro cree en tu proyecto.

Puedes revisar el detalle en la página oficial del Agent Toolkit y en su repositorio de GitHub.

Ruta B: configuración con Kiro, recomendada

Si elegiste esta ruta, no ejecutes los pasos 5, 6 y 7 de la Ruta A. Pega el siguiente prompt y deja que Kiro complete el mismo recorrido:

Te toca: pégale este prompt a Kiro en el chat

Set up Agent Toolkit for AWS by following these instructions:
https://raw.githubusercontent.com/aws/agent-toolkit-for-aws/refs/heads/main/setup-instructions/setup.md

El prompt también instala las reglas de la nueva experiencia de AWS. Esas reglas le indican a Kiro que use la Región de tu proyecto, que hable de proyectos y miembros del equipo, y que respete los servicios disponibles en tu plan.

¿Qué son MCP, las skills y las reglas?

MCP es el protocolo que Kiro usa para conectarse con herramientas y documentación de AWS. Las skills son guías para tareas específicas, y las reglas ponen límites, por ejemplo usar únicamente la Región del proyecto. No necesitas configurarlas una por una: el Agent Toolkit lo hace por ti.

Cuando Kiro pregunte, usa estas respuestas:

  • Profile name: ofrenda.
  • AWS experience: la nueva experiencia, con un proyecto.
  • Region: la Región que apuntaste en AWS Settings.
  • Help level: high, para que explique cada paso, sugiera alternativas y marque buenas prácticas.

Cuando termine, reinicia Kiro para que cargue AWS MCP Server, las skills y las reglas nuevas.

Si algo no te salió

Si algo no quedó listo, llega 30 minutos antes del slot y termina estos pasos en la mesa de ayuda.