AI AgentObservability
Lo que necesitas saber de observabilidad cuando vives entre agentes.
Pedirle a un asistente de IA que programe un agente en TypeScript toma 5 minutos. Saber por qué llamó 5 veces a la misma herramienta, inventó un reembolso o consumió 10 veces más tokens en producción requiere observabilidad.
Firebase Genkit
LangChain y LangSmith
OpenTelemetry (gen_ai.*)
Progress Observability PlatformEL PROTOTIPO DE 5 MINUTOS FUNCIONA.EL MINUTO 6 EN PRODUCCIÓN FALLA.
Cuando un endpoint REST tradicional falla, devuelve un error 500 y una traza de pila exacta. Cuando un agente de IA falla, devuelve un código 200 OK acompañado de una respuesta muy educada que acaba de inventar un precio o filtrar datos privados en tus logs.
El prototipo rápido con IA
Le pides a tu asistente de código un agente de soporte con herramientas. Pasa tres pruebas manuales en tu laptop.
El bucle silencioso
Un usuario real hace una pregunta ambigua. El agente llama 6 veces seguidas a la misma herramienta antes de agotar el tiempo.
La factura oculta de tokens
Los modelos de razonamiento consumen miles de tokens invisibles por turno. Tu factura mensual de API se triplica.
La ruleta de los prompts
Cambias dos líneas del prompt para corregir un caso y rompes sin darte cuenta otros tres flujos de herramientas.
DEJA DE DEPURAR AGENTES CON CONSOLE.LOG.
La observabilidad convierte una caja negra probabilística en un sistema de ingeniería medible: trazas distribuidas, evaluación automatizada con datasets, middlewares de privacidad y control de costos.
| Dimensión | Agente a Ciegas (console.log) | Agente Observable (Este Libro) |
|---|---|---|
| Visibilidad | Logs de texto plano que pierden relación padre-hijo entre llamadas asíncronas | Árbol completo de trazas (Spans y Runs) con latencia, herramientas y fragmentos RAG |
| Control de Costos y Tokens | Sorpresa en la factura a final de mes | Contabilidad por ejecución (entrada, salida, razonamiento) + middlewares de límites |
| Calidad y Cambios de Prompt | Probar 3 frases a ojo y cruzar los dedos | Golden Datasets repetibles + evaluadores de Fidelidad, Relevancia y Trayectoria |
| Privacidad y Seguridad | Correos, tarjetas de crédito y secretos guardados en texto plano en la nube | Middlewares de limpieza PII en cliente, validación Luhn y aprobación humana (HITL) |
| Asistente de Código IA | Genera agentes sin telemetría ni límites | Plantillas .cursorrules, CLAUDE.md y GEMINI.md listas para código observable desde el día 1 |
UN LIBRO. CUATRO TECNOLOGÍAS COMPLEMENTARIAS.
Firebase Genkit
Construye flujos tipados (defineFlow), herramientas (defineTool) y sistemas RAG observables (defineSimpleRetriever). Inspecciona cada paso en localhost:4000 y monitorea producción con Firebase Genkit Monitoring.
LangChain y LangSmith
Domina el bucle ReAct en createAgent, traza código con traceable y RunTree, aplica guardrails con middlewares y ejecuta datasets, colas de revisión humana y evaluadores online en vivo.
OpenTelemetry (gen_ai.*)
Instrumenta cualquier agente sin atarte a un proveedor usando las Convenciones Semánticas para IA Generativa (invoke_agent, chat, execute_tool), captura opt-in de prompts y BatchSpanProcessor.
Progress Observability Platform
Conecta tus trazas OTLP a una arquitectura de 3 capas con validación en colector, enriquecimiento automático de costos en USD, evaluación LLM-as-a-Judge, servidor MCP y memoria de agentes.
20 CAPÍTULOS + 3 APÉNDICES PRÁCTICOS
El agente que funciona... hasta que deja de funcionar
- ›01. Le pedí un agente a la IA y en 5 minutos funcionaba... hasta que dejó de funcionar
- ›02. Qué pasa realmente dentro de un agente: el mapa visual de un trace
Construir y ver tu agente por dentro en minutos
- ›03. Tu primer flujo observable en TypeScript con Firebase Genkit
- ›04. Herramientas, llamadas al modelo y la Developer UI de Genkit
- ›05. RAG y memoria con trazas: saber qué leyó tu agente antes de responder
- ›06. Cómo piensa un agente en LangChain: el bucle ReAct por dentro
- ›07. Tu agente en cámara lenta con LangSmith: traceable y RunTree
- ›08. Domar agentes rebeldes con Middlewares en LangChain
Un estándar para todos y evaluación antes de salir a producción
- ›09. OpenTelemetry sin dolor: un solo idioma (gen_ai.*)
- ›10. Progress Observability Platform y backends OTLP
- ›11. De probar a ojo a tener un Dataset: dejar de cruzar los dedos
- ›12. Fidelidad y Relevancia: detectar cuando tu agente inventa
- ›13. Evaluar al agente completo: evaluación de trayectoria de herramientas
Tu agente en el mundo real: producción, costos y privacidad
- ›14. Feedback de usuarios, tokens pre-firmados y Annotation Queues
- ›15. Encontrar la aguja en el pajar: filtros de errores y lentitud en producción
- ›16. Evaluación automática en vivo y alertas cuando tu agente falla
- ›17. Monitoreo en producción con Firebase Genkit Monitoring
- ›18. Privacidad y seguridad: evitar que datos privados terminen en tus trazas
- ›19. Arquitectura lista para producción y cómo elegir tu stack
- ›20. Cómo pedirle a tu asistente de IA un agente observable desde el día 1
ELIGE TU EDICIÓN.
Disponible tanto en Español como en Inglés (Plain International English). Código 100% TypeScript incluido.
Sample Gratis + Repositorio
Deja tu correo para desbloquear gratis la muestra de 3 capítulos (PDF + EPUB), además de acceso completo al código en TypeScript.
- Sample gratuito (Capítulos 1 al 3 en PDF + EPUB)
- 3 paquetes TypeScript independientes (genkit, langchain, otel)
- Tipado estricto verificado (tsc --noEmit)
- Plantillas .cursorrules, CLAUDE.md y GEMINI.md listas para copiar
Edición Digital (PDF + EPUB)
Los 20 capítulos + 3 apéndices en PDF y EPUB sin DRM, con muestra gratuita de 3 capítulos en Leanpub.
- Los 20 capítulos completos + Apéndices A, B y C
- Disponible en edición en Español y edición en Inglés
- PDF y EPUB sin DRM con tipografía Fira Sans
- Checklists de producción y hojas de referencia OpenTelemetry
- Incluye descarga gratuita de Sample (Capítulos 1 al 3)
Libro en Tapa Blanda
Edición física de escritorio en formato técnico ancho para leer bloques de código TypeScript con total comodidad.
- Formato ancho de manual técnico (7" x 10")
- Los 20 capítulos + 3 apéndices de referencia rápida
- Disponible en Español e Inglés en Amazon
- Envío internacional mediante Amazon KDP Print
Dany Paredes
Software Engineer · Google Developer Expert (Angular) · Progress Champion
Dany Paredes es ingeniero de software en Barcelona, Google Developer Expert (GDE) y Progress Champion. Ha publicado más de 230 artículos técnicos con más de 1.4 millones de lecturas sobre TypeScript, Angular, Agentes de IA y Observabilidad.