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 8

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

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
Flujo de una rama de agente que termina en un pull request, no en main
GuíaCoding Agents9 min

PRs con GitHub CLI para coding agents: nunca push a main

gh pr create imprime la URL del pull request. Un agente no interactivo debe pasar --title, --body y --head; si no, se queda en un prompt. Esta guía fija el contrato: rama propia, push, PR, cero merge y cero force. Extraído del manual de gh pr create.

Leer guía
Reloj y cola de trabajos programados disparando un agente una sola vez
GuíaDeploy9 min

Agentes programados: cron, colas y no duplicar el trabajo

Cómo disparar un agente cada N minutos sin correrlo dos veces: Cron Triggers de Cloudflare (scheduled(), UTC, 5/250 por cuenta), Cron Jobs de Vercel (hasta 100 por proyecto) y el patrón lock + cola. Qué no cabe en un cron serverless y checklist de idempotencia.

Leer guía
Tres capas: archivo local, secreto de CI y un modelo que no recibe la clave
GuíaSeguridad9 min

Secretos para agentes de IA: env, GitHub Actions y lo que nunca va al prompt

Un agente que lee .env y lo pega en el chat ya filtró la clave. Esta guía separa tres capas: archivos locales que no se commitean, secrets cifrados de GitHub Actions y el contrato de no inyectar secretos en el contexto del modelo. Checklist corto, sin un vault extra.

Leer guía
Capas de filtro a la entrada, a las tools y a la salida de un agente
GuíaSeguridad10 min

Guardrails para agentes de IA: input, output y tools

Cómo poner frenos reales a un agente: input/output/tool guardrails del Agents SDK (tripwires), API de Moderación de OpenAI (omni-moderation-latest, gratis), safety settings de Gemini y el mínimo de política propia. Qué bloquea el modelo y qué debes bloquear tú.

Leer guía
Flujo de plan mode: investigar, plan escrito y aprobación antes de editar archivos
GuíaCoding Agents9 min

Plan mode vs Agent mode: cuándo planificar antes de tocar código

Plan mode en Cursor y Claude Code frente a Agent mode: qué hace cada uno, cuándo usar planificación con preguntas y diff revisable, cuándo ir directo a editar, y un protocolo de 30 minutos para features medianas sin rehacer el PR tres veces.

Leer guía
Portátil con un daemon local sirviendo un modelo y un loop de agente con herramientas
GuíaFrameworks11 min

Agente de IA local con Ollama: loop, tools y API en tu máquina

Monta un agente local con Ollama: instalar el daemon en macOS o Linux, chat en localhost:11434, tool calling single-shot y paralelo, compatibilidad OpenAI en /v1, contexto por defecto de 4096 tokens y un loop mínimo en Python sin mandar datos a una API de pago.

Leer guía
Varios directorios de trabajo ligados al mismo repositorio Git, cada uno con su propia rama
GuíaCoding Agents9 min

Git worktrees para coding agents: un checkout por agente, no un caos

Git permite varios working trees en el mismo repo. Un agente que hace checkout -b en tu carpeta principal te secuestra HEAD. Esta guía cubre git worktree add, lock, prune, el error de rama ya checked out y un protocolo de 60 segundos para aislar cada sesión de Claude Code, Codex o Cursor CLI.

Leer guía