AWS Bedrock · AgentCore · Production-ready

El manual del operador para agentes Bedrock que no exploten en producción

229 páginas sobre lo que la documentación de AWS no te dice: políticas Cedar, una arquitectura de referencia de once componentes, control determinístico y el playbook operativo para lanzar tu primer agente.

Portada de AgentCore in Production: The Operator's Playbook for AWS Bedrock Agents, por Gerardo Arroyo
Próximamente en Amazon

¿Llegaste desde el libro? El código está aquí.

Todos los listados de los doce capítulos viven en un repositorio público — las políticas Cedar, la arquitectura de referencia y los scripts de despliegue. Gratis, sin comprar nada y sin dejar tu correo.

¿Encontraste algo equivocado, o una errata? Abre un issue — es la vía más rápida para escribirme, y prefiero saberlo.

Abrir el repositorio codecr/agentcore-production-playbook

Tu agente funciona perfecto en el demo. Producción es otra historia.

Son las 2:37 AM. Tu teléfono no para de vibrar. El dashboard de on-call está en rojo. El agente DevOps que desplegaste la semana pasada — el mismo que funcionaba impecable en staging — acaba de borrar tres tablas de producción.

El agente no falló. Siguió las instrucciones perfectamente. El problema fue que nadie había definido qué no debía hacer. Sin policy. Sin guardrails para acciones destructivas. Sin un checkpoint entre el razonamiento del LLM y tu base de datos productiva.

Este libro es el manual que nadie escribió para ti. Es la diferencia entre un demo de AgentCore en YouTube y un agente en el que tu CTO confía en producción.

Cada senior engineer con el que he hablado sobre agentes Bedrock en producción tiene la misma historia: el demo los deslumbró, después la realidad les costó un fin de semana (o un cliente).

— Gerardo Arroyo

Diseñado para quienes ya eligieron AgentCore — o están por hacerlo.

Esto es para ti si eres…

  • Senior engineer o staff engineer construyendo agentes en Bedrock
  • Arquitecto cloud diseñando sistemas GenAI para una empresa
  • Tech lead responsable de pasar un agente por el review del CTO
  • DevOps/platform engineer desplegando agentes que tocan producción
  • Founder construyendo un producto IA sobre AWS y cansado de demos de juguete

Pasa de largo si…

  • No lees inglés técnico con comodidad — el libro está escrito en inglés
  • Estás empezando con AWS — busca material foundational primero
  • Quieres un tutorial de 30 minutos de LangChain — esto es profundidad, no amplitud
  • No has decidido entre Bedrock vs OpenAI/Azure — esto asume Bedrock
  • Esperas walkthroughs no-code de consola — esto es un manual, con código real

12 capítulos. 4 partes. 229 páginas de profundidad operacional.

Cada capítulo aterriza en un patrón production-grade con código funcional. Sin relleno, sin posts de blog reciclados haciéndose pasar por libro.

Los títulos aparecen en inglés porque el libro está escrito en inglés. Es el idioma en el que vive la documentación de AgentCore, y quería que los términos coincidieran línea por línea con lo que vas a leer en la consola de AWS.

Parte I · El marco

Por qué los prompts no son arquitectura, y la arquitectura de referencia que el resto del libro desarma.

  1. Why AgentCore Exists: The Real Problem with Agents in Production
  2. The Reference Architecture: Eleven Components, One Principle

Parte III · Estado, memoria y conocimiento

Lo que el agente conserva, lo que aprende y lo que lee.

  1. Session Storage: What the Agent Built, Between One Session and the Next
  2. AgentCore Memory: What the Agent Has Learned
  3. Bedrock Knowledge Bases: What the Agent Reads, and How It Finds It

Parte IV · Operación

Contratos, evaluación, gobernanza a escala de flota, y el día uno.

  1. Structured Outputs: From Probable Shape to Guaranteed Shape
  2. Evaluations: Knowing Whether the Agent Is Any Good
  3. The Registry and the Trace: Governing a Fleet You Cannot See
  4. The Operations Playbook: Day One, and the Frontier
  • Prefacio How to Read This Book
  • Apéndice The Eight Concerns, Mapped

No es un post largo. Es una referencia que vas a dejar abierta.

229 páginas en 12 capítulos y 4 partes — escritas como un solo argumento, no como una colección de tips

Una arquitectura de referencia de once componentes, y el único principio que la sostiene

Políticas Cedar leídas línea por línea: qué bloquea cada cláusula y qué deja pasar sin avisar

Código funcional en un repositorio público de GitHub — clónalo antes de comprar el libro si quieres

Un apéndice que mapea las ocho preocupaciones de producción a la feature de AgentCore que resuelve cada una

Notas de trinchera: los errores que me costaron noches, esos cuyo mensaje no menciona nada útil

Gerardo Arroyo

Gerardo Arroyo

Llevo varios años construyendo sobre AWS y escribiendo al respecto, la mayor parte de ese tiempo en el espacio donde la arquitectura cloud se cruza con la IA generativa. Tengo el AWS Golden Jacket, el reconocimiento que se otorga por mantener todas las certificaciones AWS activas a la vez. Soy AWS Community Builder, ex-AWS Ambassador y líder de un AWS User Group. Escribo en gerardo.dev desde 2016 y trabajo como consultor cloud independiente.

Casi todo lo que está en este libro salió de incidentes en producción — algunos míos, otros de equipos a los que me llamaron a ayudar. Las aperturas narrativas del libro son composiciones: los detalles están cambiados, las formas no. Cada arquitectura que recomiendo aquí es una que desplegué, o que vi de cerca lo suficiente para saber por dónde se dobla.

Si algo en este libro resulta estar equivocado, prefiero saberlo. El repositorio de acompañamiento es la vía más rápida para escribirme.

Dos formatos, en Amazon, muy pronto.

El manuscrito está terminado y en revisión en Amazon. Deja tu correo y te aviso el día que salga — ningún otro correo, nada más.

Edición Kindle

Léelo donde sea, búscalo mientras programas.

  • Entrega inmediata a cualquier app o dispositivo Kindle
  • Búsqueda de texto completo en los 12 capítulos
  • Tamaño de letra ajustable para los listados largos de código
  • Incluido en Kindle Unlimited
Próximamente

Tapa blanda

229 páginas, 6 x 9, para el escritorio junto al teclado.

  • 229 páginas, formato 6 x 9 pulgadas
  • Diagramas y listados de código optimizados para impresión
  • Anótalo, dóblale las esquinas, llévalo al review de arquitectura
  • Envío desde tu Amazon local
Próximamente

Recibe el aviso de lanzamiento

Un correo, el día que el libro esté en Amazon. Entras a mi lista Cloud Chronicles, de la que puedes salir con un clic.

El código de acompañamiento es público y gratuito, con libro o sin libro: github.com/codecr/agentcore-production-playbook

Si estás dudando, probablemente esto lo aclara.

¿En qué idioma está el libro?

En inglés, únicamente. Es el idioma en el que vive la documentación de AgentCore, y quise que cada término del libro coincidiera exactamente con lo que vas a ver en la consola de AWS y en los mensajes de error. Si lees documentación técnica de AWS en inglés sin fricción, el libro te va a resultar cómodo. Si prefieres español, en este blog tengo las versiones cortas de varios capítulos, en español.

¿Kindle o tapa blanda? ¿Cuál conviene?

Kindle si vas a leerlo mientras trabajas: la búsqueda de texto completo sobre 229 páginas es difícil de superar cuando necesitas recordar en qué capítulo estaba ese detalle de Cedar. Tapa blanda si eres de anotar márgenes y de tener el libro abierto junto al teclado. Los diagramas y los listados de código están maquetados pensando en el papel, en formato 6 x 9.

¿Está incluido en Kindle Unlimited?

Sí. La edición Kindle está inscrita en KDP Select, así que si tienes Kindle Unlimited puedes leerlo sin costo adicional.

¿El código hay que comprarlo aparte?

No. El repositorio de acompañamiento es público y gratuito, con libro o sin libro: github.com/codecr/agentcore-production-playbook. El libro es el razonamiento — por qué cada pieza está donde está, qué trade-off estás aceptando, qué se rompe cuando eliges la otra opción.

¿Esto es una recopilación de tus posts del blog?

No. Varios capítulos nacieron de investigaciones que también publiqué en el blog, pero el libro está reescrito desde cero como un argumento continuo: cada capítulo depende del anterior y todos apuntan a la misma arquitectura de referencia. Un post responde una pregunta; el libro responde qué hacer el lunes cuando tienes que llevar un agente a producción. Son 63.000 palabras, la mayoría inéditas.

¿Necesito ser experto en AWS?

Necesitas fundamentos sólidos: IAM, Lambda, y haber tocado Bedrock alguna vez. Si ya desplegaste un agente Bedrock — aunque fuera básico y aunque no funcionara — eres exactamente la audiencia. Si recién empiezas con AWS, pasa primero por los learning paths oficiales.

¿Cubre las últimas features de AgentCore?

Cubre lo que está generally available a la fecha de publicación: AgentCore Policy con Cedar, Memory, Session Storage, Runtime, Evaluations, Agent Registry, Bedrock Guardrails, Automated Reasoning, Structured Outputs y Knowledge Bases. AWS se mueve rápido y el libro lo asume: el capítulo 12 cierra con la frontera, es decir, con lo que todavía no está resuelto.

¿Reemplaza la documentación de AWS?

No, la complementa. La documentación te dice qué hace cada feature. El libro te dice cuáles combinar, en qué orden, con qué patrones — y qué decisiones vas a lamentar tres meses después. Eso no está en ninguna documentación porque nadie lo escribe hasta que le pasa.

¿Hay una muestra para revisar antes de comprar?

Sí, la de Amazon: ‘Look Inside’ en la edición de tapa blanda y la muestra gratuita de Kindle, que incluye el prefacio y el arranque del capítulo 1. Además, el repositorio público te deja ver el nivel del código antes de decidir.

¿Puedo comprarlo desde Costa Rica, España o México?

Sí. Está disponible en las tiendas de Amazon donde KDP distribuye, y cada una define su propio precio y su propio envío para la tapa blanda. Usa el enlace de esta página y Amazon te llevará a tu tienda local.

¿Cómo puedo apoyar el libro?

Una reseña honesta en Amazon. Para un libro técnico autopublicado las reseñas son el único mecanismo real de distribución: son lo que decide si alguien más lo encuentra buscando ‘AgentCore production’. Tres líneas ayudan más de lo que parece.

El libro está terminado. Amazon lo está revisando.

Un correo el día que salga. Mientras tanto, el código de acompañamiento ya es público y el blog tiene las versiones cortas de varios capítulos.