Guías para construir y operar agentes de IA

Empieza con un proyecto pequeño, conecta sus herramientas y comprueba sus límites antes de abrirlo a usuarios. Encontrarás código descargable, datos de ejemplo y pruebas que puedes repetir.

249 guías prácticas115 notas de referenciaVer cursos

Guías, página 3

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

Un dial de sampling junto a un agente que elige el siguiente token con un contrato fijo
GuíaAgentOps10 min

Temperatura y sampling en agentes: el knob no es creatividad

Temperatura, top_p y top_k cambian cómo el modelo elige el siguiente token, no la personalidad del agente. OpenAI recomienda tocar temperatura o top_p, no ambos (rango 0–2). Anthropic deprecó temperature/top_p/top_k después de Opus 4.6. Gemini aplica topP/topK y luego temperatura. Cero no es determinista. Distinto de reasoning.effort y de structured outputs.

Leer guía
Un agente corre dos versiones en paralelo: la de control sirve y la candidata solo observa
GuíaAgentOps10 min

Shadow, canary y feature flags en agentes: soltar sin redeploy

Shadow corre el candidato sin servir; canary sirve un porcentaje; el flag libera sin redeploy. Distinto de preview, de kill switch y de fallback de modelo. Cloudflare Gradual Deployments, Vercel Flags y AWS AppConfig. Cero side-effects en shadow. Canary con afinidad de versión y rollback. Flags no son secretos ni config de arranque.

Leer guía
Cola principal de un agente que desvía mensajes irrecuperables a una cola muerta con alarma
GuíaAgentOps10 min

Dead-letter queue en agentes: el mensaje que no debe reintentarse

El retry es por llamada; la DLQ es por mensaje cuando el presupuesto de reintentos se agotó o el payload es veneno. maxReceiveCount, DeadLetterReason y redrive humano. Distinto del circuit breaker y de la ejecución durable. AWS SQS, Azure Service Bus, Cloudflare Queues y RabbitMQ DLX.

Leer guía
Cadena de tres modelos donde el primario falla y el segundo responde al agente
GuíaAgentOps10 min

Fallback de modelos en agentes: otro modelo, no el mismo 429

Un fallback cambia de modelo o de proveedor cuando el primario no responde. Distinto de reintentos (misma llamada) y del circuit breaker (cortar la dependencia). Vercel AI Gateway models[] + Cloudflare Universal endpoint y cf-aig-step. Cero fallback en 401/403 ni en spend limit. El modelo que contestó va al log, no al prompt.

Leer guía
Cuatro indicadores de un agente frente a un presupuesto de error que se consume con burn rápido y lento
GuíaAgentOps10 min

SLO y error budget en agentes: 4 SLIs, burn rápido/lento y política 50/100

La observabilidad te dice qué pasó; el SLO contrata qué es aceptable. Cuatro SLIs de agente (entrega, tools, latencia, calidad), error budget = 1 − SLO, alertas de burn rápido y lento, y una política 50 % / 100 % que congela features antes de que el presupuesto se acabe. Distinto de dashboards y de evals.

Leer guía
Ciclo de un fallo de producción que entra al dataset y cierra el merge en CI
GuíaAgentOps10 min

De error de producción a eval: el flywheel que alimenta el dataset

Las evals iniciales arman el dataset. El flywheel lo alimenta: captura el fallo con traza, triage semanal a casos dorados, dataset vivo versionado y CI que bloquea el merge. Un error visto una vez se convierte en un test que corre siempre. Distinto de armar la suite y de calibrar el juez.

Leer guía
Cliente A2A hablando con un agente remoto opaco a través de un Agent Card, sin compartir tools ni memoria
GuíaArquitectura10 min

Consumir agentes externos con A2A: comprar, no criar

Criar un segundo agente no es lo mismo que comprar uno. A2A (Linux Foundation) es el contrato agent-to-agent: Agent Card en /.well-known/agent-card.json, SendMessage/GetTask/CancelTask, estados SUBMITTED→WORKING→COMPLETED. Filtro build-vs-buy, wrapper tipado y evals como si el remoto fuera un proveedor. Distinto de orquestar los tuyos y de MCP.

Leer guía
Tres caminos de una imagen hacia el agente: píxeles recortados, caption corto y texto OCR
GuíaAgentes Multimodales10 min

Entradas multimodales en agentes: imagen cruda, caption u OCR, no el PDF entero

Un screenshot o un PDF no es un string. OpenAI tokeniza por parches 32×32, Claude por 28×28 y Gemini cobra 258 tokens por tile. Esta guía fija tres representaciones —píxeles, caption, texto extraído—, resize antes de enviar, PDFs por índice de páginas y PII visual fuera del prompt.

Leer guía
Índice RAG con tenants aislados, ACL en la query y reindex incremental
GuíaAgentOps11 min

RAG en producción: permisos en la query, frescura e índices por tenant

El chunking arma el índice. En producción el fallo es otro: el tenant sale del auth, no del prompt; cada query va a un namespace o with_tenant(); el filtro de metadata no es un ACL; y un documento vive hasta que lo reindexas. Pinecone, Weaviate y OpenAI Retrieval, verificados el 6 de septiembre de 2026.

Leer guía
Escritorio de desarrollador con editor de código, sugerencias de autocompletado y una terminal ejecutando un agente
GuíaProductividad IA12 min

GitHub Copilot para trabajo: cómo usarlo en código real (LATAM, 2026)

Guía práctica de GitHub Copilot para developers en LATAM: cuándo usar autocompletado, chat con agent mode, CLI o el cloud agent, cómo gastar bien los créditos de cada plan, qué no pegar de clientes, y un flujo de 30 minutos para pasar de un ticket a un PR que sí puedes mandar a review.

Leer guía
Cola de aprobaciones humanas con lote, timeout fail-closed y un presupuesto de interrupciones
GuíaAgentOps10 min

Aprobaciones humanas en agentes: lotes, timeout fail-closed y presupuesto de interrupciones

Cómo pedir aprobación a un humano sin ahogarlo: lotes en vez de un ping por tool, timeout fail-closed (default-deny), presupuesto de interrupciones por run y payload con acción, blast radius y undo. Distinto de HITL (qué pausar) y de guardrails (qué bloquear en código). LangGraph interrupt() espera indefinido; el timeout lo pones tú.

Leer guía
Diagrama de un pipeline de agente donde un escudo filtra datos personales antes del modelo y antes de los registros
GuíaSeguridad de Agentes10 min

PII en agentes de IA: detectar y redactar datos sensibles en entrada y salida

Cómo evitar que tu agente de IA filtre datos personales: detecta emails, teléfonos, tarjetas e IBAN con regex y validación Luhn, redacta con máscaras o bóveda de tokens con TTL, y aplica el filtro en ambas direcciones —antes del LLM y antes de logs y memoria. Incluye patrones listos, código TypeScript mínimo, tabla de decisiones, checklist y FAQ.

Leer guía
Fachada de pocas tools de intención delante de una API REST con decenas de endpoints
GuíaHerramientas10 min

API existente como tools de agentes: fachada de intención, no 200 endpoints

Un OpenAPI con 80 paths no es un toolset. Contrato para envolver una API que ya tienes: 5–12 tools de intención, un adapter que valida y recorta, auth fuera del contexto y el generador OpenAPI solo como borrador. Incluye matriz REST vs tool, checklist y el error de volcar el spec crudo al modelo.

Leer guía
Escritorio de investigación con PDFs impresos, audífonos y una laptop abierta para contrastar fuentes
GuíaProductividad IA12 min

NotebookLM: guía práctica para investigar con fuentes (LATAM, 2026)

Guía práctica de NotebookLM (Gemini Notebook) en español: cómo armar un cuaderno con fuentes, preguntar con citas, generar un Audio Overview y no tratar el podcast como verdad. Incluye límites oficiales, un flujo LATAM de 40 minutos y cuándo pasar de un notebook a un agente.

Leer guía
Tres techos de presupuesto por tenant — minuto, día y mes — con una escalera de degradación antes del corte
GuíaAgentOps10 min

Presupuestos y cuotas por tenant en agentes: tres techos, degradar antes de cortar

Un agente multi-tenant no se frena con el spend limit del proveedor. Tres techos por tenant (minuto, día, mes) anclados al precio real, escalera de degradación antes del 429 y el tenant sale de auth, no del prompt. Distinto de rate limits, del kill switch y de la noticia de spend limits de Cloudflare.

Leer guía
Escritorio de oficina con laptop, cuaderno de tareas y un teléfono listo para enviar un correo de trabajo
GuíaProductividad IA12 min

Gemini para trabajo: cómo usarlo en tareas reales (LATAM, 2026)

Guía práctica de Gemini para trabajo en español LATAM: cuándo usar la app, Gems o el panel de Workspace en Gmail y Docs, cómo pedir un entregable revisable, qué no pegar de clientes, y un flujo de 30 minutos para un mail o brief que sí puedes mandar.

Leer guía
Un agente consulta primero un cache exacto y luego uno semántico con umbral alto antes de llamar al modelo
GuíaAgentOps10 min

Cache semántico en agentes LLM: exact-match primero, umbral alto, clave con tenant

El cache semántico reusa la respuesta de un prompt parecido; el prompt caching reusa el prefijo KV del proveedor. Contrato: hash exacto primero, umbral alto (LiteLLM 0.8), clave con tenant/modelo/versión, TTL corto y cero hits en tools con efecto. Distinto de RAG y de recortar tool_results.

Leer guía
Pantalla de consentimiento OAuth entre un usuario y un agente que pide scopes concretos
GuíaAgentOps10 min

Agentes en nombre del usuario: OAuth, consentimiento y tokens que no viven en el prompt

Un agente que lee el calendario o manda un correo no es el usuario: es un cliente OAuth. Authorization code + PKCE, scopes mínimos, consentimiento visible y tokens fuera del contexto. Contrato para MCP y plugins, distinto de HITL y de secretos de servicio.

Leer guía