Saltar al contenido

Guías para construir y operar agentes de IA

Código descargable y pruebas que puedes repetir, sin registro.

252 guías prácticas115 notas de referenciaVer cursos

Guías, página 6

252 tutoriales, comparativas y checklists para continuar según tu proyecto.

Candado de verificación delante de un webhook que llega a un agente
GuíaDeploy9 min

Firmar webhooks del agente IA: Telegram, Slack y GitHub

Cómo no ejecutar un POST anónimo como si fuera Telegram: secret_token de setWebhook, firma Slack v0, HMAC de GitHub y 401 si falta. El token del bot en env no verifica el inbound. Preview usa otro secret. Fuentes oficiales, 3 septiembre 2026.

Leer guía
Proceso de agente contra un techo de CPU y un reloj de duración
GuíaDeploy9 min

Límites de CPU de un agente IA: cgroup, Workers y maxDuration

Cómo no confundir RAM llena con CPU throttling: cpu shares de Docker, vCPU de Fly y Railway, 10 ms de Workers Free frente a 30 s Paid, y maxDuration de Vercel que corta el wall clock no el modelo. El 429 del proveedor no es un cgroup.

Leer guía
Volumen de disco al límite junto a un agente que ya no puede escribir
GuíaDeploy9 min

Disco lleno en un agente IA: volúmenes, sqlite y logs

Cómo no tumbar el bot porque el volumen de 1 GB se llenó de WAL, logs y adjuntos: tamaño de volúmenes en Fly y Railway, logs de Docker que no rotan, y qué hacer cuando sqlite crece más que el disco. Backup copia; esto evita el ENOSPC.

Leer guía
Contenedor de agente contra un techo de memoria y un proceso que se reinicia
GuíaDeploy9 min

Límites de memoria y OOM de un agente IA: Docker, Fly, Workers

Cómo no morir a mitad de un tool call: mem_limit de Docker, tamaño de Machine en Fly, RAM de Railway, 128 MB de Workers y --max-old-space-size de Node. El OOM del kernel no es el heap de V8. Mide RSS, no la fe.

Leer guía
Interruptor de corte de un agente frente a un webhook activo
GuíaDeploy10 min

Kill switch de un agente IA en producción: apagar sin borrar

Cómo silenciar el bot ya: deleteWebhook con drop_pending_updates, flag AGENT_DISABLED, fly scale count 0 (ojo: deploy desde cero reseeds) y réplicas de Railway. No es rollback del código. Corta el webhook y las llamadas al modelo en minutos, con un ensayo a las 2 AM.

Leer guía
Webhook público y base de datos solo en red privada junto a un agente
GuíaDeploy9 min

Red privada para un agente IA: Postgres y Redis fuera de internet

Cómo dejar el webhook público y la base oculta: private networking de Railway y Fly (IPv6 6PN), Service Bindings en Workers y Secure Compute de Vercel. El agente habla con el chat por HTTPS; la base no tiene hostname público.

Leer guía
Varias réplicas de un agente frente a un solo volumen de estado
GuíaDeploy10 min

Concurrencia y réplicas de un agente IA: cuándo no escalar

Cómo no clonar el sqlite ni disparar 200 llamadas al modelo a la vez: Fluid Compute de Vercel, límites de Workers (128 MB, conexiones), fly scale count, réplicas en Railway y Compose. Un webhook no es un stateless API: la réplica extra a veces duplica el bot.

Leer guía
Señal de apagado ordenado frente a un proceso de agente que termina un turno
GuíaDeploy9 min

Graceful shutdown de un agente IA: SIGTERM antes del kill

Cómo no cortar a mitad de un tool call cuando hay deploy: SIGTERM en Node, timeout de docker stop, kill_timeout en Fly, deploys de Railway y por qué Vercel Functions no te da el mismo hook. Cierra el webhook, termina el turno, luego muere.

Leer guía
Hostname estable y candado TLS delante de un agente con webhook
GuíaDeploy9 min

Dominio custom y TLS para un agente IA: webhooks que no se caen

Cómo poner un hostname estable (no *.vercel.app ni *.railway.app) delante del agente: DNS, certificados automáticos en Vercel, Railway, Workers y Fly, puertos que Telegram acepta, Custom Domains vs Routes, y por qué el preview no debe heredar el dominio de producción.

Leer guía
Disco con copias de seguridad etiquetadas preview y producción junto a un agente
GuíaDeploy9 min

Backup y restore del estado de un agente IA: volúmenes, SQLite y S3

Cómo no perder la memoria del agente al redeployar: backups nativos de Railway (schedules, límite 50% del volumen), copia consistente de SQLite con .backup o WAL, snapshots de volúmenes Docker y Fly, restore sin pisar producción, y copia offsite a S3/R2 porque borrar el volumen borra los backups nativos.

Leer guía
Panel de alertas con icono de bot caído y notificación a Slack
GuíaDeploy9 min

Alertas y uptime para agentes IA: qué vigilar después del deploy

Healthcheck de deploy no es monitoreo continuo: cómo configurar anomaly alerts en Vercel (5xx y uso), webhooks y monitors de Railway (crashes, CPU/RAM), checks de servicio en Fly, y un ping externo al /health del agente para saber que el bot sigue vivo antes de que lo reporte un cliente.

Leer guía
Reloj y gráfica de latencia del primer request frente a requests calientes en serverless
GuíaDeploy9 min

Cold starts en agentes IA serverless: Vercel, Workers y Fly

Cómo diagnosticar y reducir la latencia del primer request en un agente serverless: Fluid Compute y bytecode cache en Vercel, límite de startup de 1 segundo en Workers (global scope), autostop/autostart y min_machines_running en Fly, y cuándo el cold start no es el problema (healthcheck, webhooks con timeout corto).

Leer guía
Dos entornos paralelos de un agente, preview a la izquierda y producción a la derecha
GuíaDeploy9 min

Preview vs Production para agentes IA: Vercel, Railway y Workers

Cómo aislar el agente de un PR para que no dispare el bot de Telegram de producción, no gaste la API key real ni pise la base: Preview de Vercel, environments de Railway (persistentes vs PR), env de Wrangler y secretos por entorno.

Leer guía
Dos versiones de un agente, la nueva en rojo y la anterior en verde lista para recibir tráfico
GuíaDeploy9 min

Rollback de un agente IA: Vercel, Railway, Fly y VPS

Cómo volver atrás cuando el deploy nuevo rompe el agente: Instant Rollback en Vercel, rollback de Railway (código del deployment elegido y retención del plan), estrategias canary/bluegreen en Fly, y git+compose en un VPS. El plan se escribe antes del incidente.

Leer guía
Terminal de logs en vivo junto a un panel de retención por plan de hosting
GuíaDeploy9 min

Logs de runtime para agentes IA: Vercel, Workers, Railway y Docker

Dónde mirar cuando el agente falla en producción: retención de Runtime Logs en Vercel (Hobby 1 hora, Pro 1 día), wrangler tail y sampling de Cloudflare, retención de Railway (Hobby 7 días, Pro 30), Fly search 7 días, docker logs sin rotación por defecto, y qué no imprimir nunca (secretos ni prompts de clientes).

Leer guía
Monitor de salud con un endpoint verde y otro rojo frente a un agente en producción
GuíaDeploy9 min

Healthchecks para agentes IA en producción: Docker, Fly, Railway

Cómo diseñar un endpoint /health que no mienta: liveness vs readiness para agentes, HEALTHCHECK en Docker, checks de Fly.io, healthchecks de Railway que solo corren en el deploy, y los errores que dejan tráfico en un proceso vivo pero sordo.

Leer guía
Máquinas en varias regiones conectadas a un agente que recibe tráfico global
GuíaDeploy9 min

Desplegar un agente IA en Fly.io: Machines, precios y dominio

Guía práctica para correr un agente de IA en Fly.io: fly launch, fly deploy, Machines shared-cpu, precios por segundo, certificados con fly certs add, autostop, health checks de servicio, y cuándo Fly gana frente a Railway, un VPS o Functions serverless.

Leer guía
Diagrama de una función en la nube que recibe un webhook y dispara un cron diario
GuíaDeploy9 min

Desplegar un agente IA en Vercel Functions: guía práctica

Tutorial paso a paso para correr un agente de IA en Vercel: Route Handler con maxDuration, Cron Jobs con CRON_SECRET, límites Hobby vs Pro (300s / 800s / 30 min beta) y cuándo Functions alcanza frente a Workers, Railway o un VPS.

Leer guía