Saltar al contenido

Guías para construir y operar agentes de IA

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

256 guías prácticas115 notas de referenciaVer cursos

Guías, página 8

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

package.json con packageManager pnpm pinneado y Corepack sirviendo ese binario
GuíaCoding Agents9 min

Corepack y packageManager: el agente usa el pnpm del repo, no el del PATH

Corepack puentea Node y el package manager del proyecto. El campo packageManager en package.json ([email protected]+hash) pinnea la versión. Un agente que llama el pnpm global puede ser otra major y reescribir el lock. Esta guía cubre corepack enable, el campo, y por qué Node 25 ya no lo trae de fábrica.

Leer guía
Un push forzado sobreescribe el tip remoto y deja commits huérfanos fuera de la rama
GuíaCoding Agents10 min

Force push y amend en coding agents: por qué el remoto pierde commits

git push --force puede borrar commits del remoto. --force-with-lease solo comprueba el valor esperado del ref y un fetch de fondo lo derrota. --amend reescribe el tip. Esta guía fija commit nuevo + push normal; nunca amend+force en un agente. Man pages git-push y git-commit.

Leer guía
Un shell con NODE_ENV production que un agente debe unset antes de next build
GuíaCoding Agents9 min

NODE_ENV y Next.js para agentes: no dejes production pegado en el shell

Next.js carga .env* y trata NODE_ENV como suyo: next build es production, next dev es development. Un harness que exporta NODE_ENV=production rompe tests y a veces el build. Esta guía cubre unset para next build, development para vitest, NEXT_PUBLIC_ y no commitear .env. Docs Next 16.

Leer guía
Varias llamadas a herramientas saliendo del mismo turno del modelo hacia handlers independientes
GuíaHerramientas10 min

Tool calling en paralelo: cuándo sí, cuándo no y cómo devolver resultados

Un turno del modelo puede pedir varias tools a la vez. OpenAI lo apaga con parallel_tool_calls: false; Claude con disable_parallel_tool_use. Gemini exige devolver todas las respuestas. Esta guía fija el loop, el lote de resultados y cuándo forzar una sola llamada.

Leer guía
Un mensaje de commit con type feat y una descripción corta, listo para un agente
GuíaCoding Agents9 min

Conventional Commits para coding agents: feat, fix y el ! que rompe SemVer

Un agente que commitea 'wip' y 'updates' rompe el changelog. Conventional Commits 1.0.0 fija type, scope opcional y BREAKING CHANGE. Esta guía traduce la spec a instrucciones de harness: una línea de subject, cero novels, feat/fix/docs/test, y cuándo usar !.

Leer guía
Una petición HTTP de una tool que se corta con AbortSignal al vencer el tiempo
GuíaAgentOps9 min

Timeouts en tools HTTP: AbortSignal.timeout, no un sleep eterno

Una tool de fetch sin signal cuelga el agente hasta el idle timeout del host. AbortSignal.timeout(ms) aborta con TimeoutError. Esta guía cubre fetch + signal, AbortSignal.any con cancelación del usuario, y por qué el timeout vive en la tool, no en un setTimeout olvidado. MDN + Node.

Leer guía
Flujo editorial de un webhook que se verifica con HMAC antes de entrar al loop del agente
GuíaSeguridad11 min

Verificar la firma de webhooks en un agente de IA

Un webhook sin firma es un endpoint público: cualquiera puede inventar un mensaje de Slack, Telegram o GitHub y disparar tools. Esta guía compara HMAC de GitHub, Slack, Meta y el secret_token de Telegram, con código Node, replay window y el error de hashear el JSON parseado.

Leer guía
Un agente eligiendo pnpm con lockfile congelado frente a npm que genera otro lock
GuíaCoding Agents9 min

pnpm para coding agents: frozen-lockfile, nunca npm install

En CI, pnpm install falla si el lockfile existe y habría que actualizarlo. Un agente que corre npm install crea package-lock.json y rompe el repo. Esta guía fija el contrato: pnpm i --frozen-lockfile, pnpm <script>, pnpm dlx; cero npm/npx. Docs oficiales de pnpm install.

Leer guía
Un archivo .env ignorado por Git pero todavía visible para el agente en el disco
GuíaCoding Agents9 min

gitignore no es un sandbox: qué ignora Git y qué sigue viendo el agente

Git ignora untracked files según .gitignore, info/exclude y core.excludesFile. Un coding agent con read_file no pregunta a Git: lee el disco. Esta guía cubre precedencia oficial de gitignore, archivos ya trackeados, y por qué .env gitignored sigue en el contexto del agente si no hay deny-list.

Leer guía
Flujo editorial de un agente que reutiliza el prefijo cacheado del prompt entre turnos
GuíaCostos11 min

Prompt caching para agentes de IA: cómo bajar costo y latencia

El prompt caching reutiliza el prefijo estático (tools, system, base de conocimiento) y cobra la relectura a una fracción del input. Esta guía compara OpenAI y Anthropic con precios públicos, el orden correcto del prompt, breakpoints y un ejemplo numérico de 10.000 conversaciones.

Leer guía
Canal de Microsoft Teams con un agente de IA que responde en el hilo tras un ack HTTP
GuíaMensajeria11 min

Cómo crear un bot de Microsoft Teams con IA (2026)

Un agente en Teams no es un chatbot suelto: es una app con un endpoint de mensajería, Activity de Bot Framework y ack HTTP 200 en menos de 15 segundos. Esta guía cubre @mention, hilos de canal, Adaptive Cards, mensajes proactivos y el checklist de producción.

Leer guía
Una tool de agente bajo un test unitario, el modelo fuera del recuadro
GuíaAgentOps9 min

Tests de tools de agentes sin LLM: Vitest primero, evals después

Si la tool de refund está mal, el modelo no la arregla. Esta guía separa tests deterministas de las funciones que el agente llama (Vitest, fixtures, nock) de los evals del loop. El LLM entra cuando las tools ya tienen verde. Menos tokens, fallos más baratos.

Leer guía
Un slash command de Discord que se acusa en 3 segundos y deja el trabajo del agente en una cola
GuíaMensajeria9 min

Bot de Discord con IA: Interactions, ack en 3 segundos y cola

Discord invalida el token de una Interaction si no respondes en 3 segundos. El modelo no cabe ahí. Esta guía cubre PING/PONG, DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE, el token de 15 minutos y por qué el agente corre después del ack, no en el HTTP handler. Docs oficiales de Receiving and Responding.

Leer guía
Espacio de trabajo de Slack conectado a un agente de IA que responde en un hilo
GuíaMensajeria11 min

Cómo crear un bot de Slack con IA paso a paso (2026)

Un bot de Slack con IA no es un chatbot suelto: es una app con Events API, token xoxb, ack en menos de 3 segundos y respuestas en hilo. Esta guía cubre Socket Mode vs HTTP, Bolt, tools, scopes mínimos y el checklist de producción.

Leer guía
Escritorio con laptop, tres tarjetas de decisión y un servidor pequeño para comparar dónde desplegar un agente
GuíaDeploy10 min

Dónde desplegar un agente de IA: Vercel, Cloudflare Workers o VPS

Guía para elegir dónde corre tu agente: Vercel Functions (hasta 300 s en Hobby, 800 s en Pro), Cloudflare Workers (CPU de 30 s por defecto y hasta 5 min en plan de pago) o un VPS. Tabla de decisión, límites oficiales, checklist de webhook y cuándo un proceso largo no cabe en serverless.

Leer guía
Diagrama de un agente supervisor repartiendo trabajo entre tres agentes especializados
GuíaArquitectura10 min

Orquestación multi-agente: cuándo sí y cuándo es un error

Guía de decisión para saber si tu sistema necesita varios agentes coordinados o un solo agente con buenas tools: señales de cuándo sí, los cinco patrones de orquestación que se repiten en producción, el costo real en tokens y latencia, y un checklist antes de añadir un segundo agente.

Leer guía
Agente principal delegando exploración de código a un subagente con ventana de contexto separada
GuíaCoding Agents10 min

Subagentes en coding agents: cuándo delegar (y cuándo no)

Qué es un subagente en Claude Code y Cursor, cómo ahorra contexto al devolver solo un resumen, subagentes built-in Explore y Plan, cuándo crear uno custom y la diferencia con orquestación multi-agente en producción.

Leer guía
Ventana de trabajo de un modelo con prefijo cacheado y cola de mensajes recortada
GuíaMemoria para Agentes10 min

Ventana de contexto para agentes: recortar, cachear y no pudrir el prompt

Cómo no reventar la ventana de un agente: context rot (Claude), prompt caching de OpenAI (hasta 90% en prefix) y de Claude (cache_control, TTL 5 min o 1 h), compaction server-side y qué mandar al modelo vs. qué dejar en tools/RAG.

Leer guía