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 3

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

Un prompt de chain-of-thought visible frente a un knob de thinking interno en un agente
GuíaAgentOps10 min

CoT vs thinking models: no pidas ‘piensa paso a paso’ al modelo que ya piensa

El chain-of-thought visible es un prompt. El thinking de OpenAI, Claude y Gemini es un knob de runtime: tokens internos, cobrados como output, no se ven en crudo. OpenAI pide evitar ‘think step by step’. Claude deja CoT solo si thinking está off. Gemini cobra total_thought_tokens. Distinto de temperatura y de few-shot.

Leer guía
Tres ejemplos de entrada y salida anclados al system prompt de un agente, con el mismo formato
GuíaHerramientas10 min

Few-shot en agentes: tres ejemplos de oro, no veinte clones

El few-shot no es rellenar el prompt. OpenAI lo pone en el mensaje developer con entradas diversas. Claude pide 3–5 ejemplos en tags XML, relevantes y distintos. Gemini recomienda few-shot siempre, formato idéntico y avisa overfitting. Distinto de prompt engineering y de structured outputs.

Leer guía
Una misma clave de idempotencia absorbe tres reintentos de una tool y deja un solo efecto
GuíaAgentOps10 min

Idempotencia en tools de agentes: una clave, un efecto

El retry de una tool no es un segundo cobro. La clave se genera antes del POST, se reusa en el timeout y se rechaza si el payload cambió. Stripe Idempotency-Key, AWS ClientToken e IETF 400/422/409. Distinto de webhooks, de retry y de ejecución durable.

Leer guía
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