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 9

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

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
Repositorio con AGENTS.md en la raíz y archivos de contexto para distintos coding agents
GuíaCoding Agents10 min

AGENTS.md: convenciones para coding agents en tu repo (2026)

Qué es AGENTS.md, cómo se diferencia de CLAUDE.md y de las rules de Cursor, qué poner en cada archivo, cuándo anidar en monorepos y un template copiable con comandos de build, estilo y seguridad para que Codex, Claude Code y Cursor sigan las mismas reglas.

Leer guía
Flujo de eventos SSE desde un modelo hacia un chat, con tools pausadas hasta el bloque completo
GuíaAgentes en Producción9 min

Streaming de respuestas en agentes de IA: SSE sin romper tools

Cómo streamear la respuesta de un agente con SSE (OpenAI stream=true, Claude messages.stream, Gemini streaming) sin pintar JSON a medias ni ejecutar una tool dos veces. Eventos, timeouts, errores mid-stream y checklist para el canal de chat.

Leer guía
Un teléfono con una conversación de Telegram conectada a un flujo de herramientas de un agente de IA
GuíaMensajeria10 min

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

Conecta el agente de inventario de Python a un bot de Telegram privado. Incluye el archivo completo, configuración de BotFather, autorización por chat y pruebas de mensajes largos. Empieza con polling local y descubre qué falta antes de abrirlo a usuarios: cola durable, deduplicación, cuotas y gestión de errores.

Leer guía
Agente pausado en un paso de aprobación con un humano que reanuda el flujo
GuíaAgentes en Producción10 min

Human-in-the-loop en agentes de IA: cuándo pausar y cómo reanudar

Guía práctica de HITL: qué acciones de un agente deben esperar a un humano, cómo pausar con interrupt() de LangGraph o needs_approval del Agents SDK, cómo reanudar sin perder estado y qué no conviene aprobar a ciegas. Checklist y anti-patrones.

Leer guía
Flujo de un webhook que llega dos veces y se absorbe en una clave de idempotencia antes de la cola del agente
GuíaAgentOps10 min

Idempotencia en webhooks de agentes: no cobres ni envíes dos veces

Stripe reintenta un evento hasta tres días; Telegram reenvía el Update si no respondes 2xx. Esta guía enseña a deduplicar por event.id o update_id, firmar el payload, devolver 200 rápido y mover el trabajo del agente a una cola. Sin eso, un timeout duplica cargos y mensajes.

Leer guía
Carpetas de skills junto a un agente que carga solo el procedimiento relevante
GuíaSkills para Agentes10 min

Skills para agentes de IA: SKILL.md, no un prompt eterno

Qué es un Agent Skill (SKILL.md + frontmatter), cómo se diferencia de un system prompt y de CLAUDE.md, progressive disclosure de Anthropic y cuándo crear un skill en Claude Code. Checklist, anti-patrones y el estándar agentskills.io.

Leer guía
Cola de peticiones con pausas y reintentos frente a un límite de tasa
GuíaAgentes en Producción10 min

Reintentos, timeouts y rate limits en agentes de IA

Cómo reintentar llamadas a OpenAI, Gemini y Claude sin duplicar acciones ni quemar cuota: qué códigos sí (429, 500, 503, 529), cuáles no (400, 401, 403), Retry-After, backoff con jitter, RPM/TPM y el patrón de cola para un agente en producción.

Leer guía
Escritorio con un editor IDE a la izquierda y una terminal a la derecha, dos superficies distintas para un agente de código
GuíaCoding Agents10 min

Cursor vs Claude Code: IDE con agente o CLI de terminal (2026)

Cursor Agent vive en el editor; Claude Code nació en la terminal. Compara superficies, permisos, checkpoints vs Git, CLI, planes Pro 20 USD frente a la suscripción Claude y un protocolo de 60 minutos para no mezclar un IDE con un CLI.

Leer guía
Tablero con tarjetas de modelos de IA conectadas a herramientas, representando la precisión de function calling de cada uno
GuíaModelos9 min

Mejores modelos para tool calling: cómo comparar con BFCL y pruebas propias

Elige modelos por tareas completadas, no por una clasificación copiada. Aprende a leer BFCL, distinguir function calling nativo de modo prompt y ejecutar una comparación con ocho casos descargables. Incluye una hoja de resultados vacía, criterios de descarte y cálculo de coste por éxito sin inventar un ganador universal.

Leer guía
Esquema de datos conectado a un agente que produce un objeto JSON validado
GuíaHerramientas10 min

Structured outputs: JSON confiable para agentes de IA

Cómo forzar JSON válido en un agente sin reintentos ni regex: structured outputs de OpenAI (json_schema + strict), Gemini (response_format con JSON Schema) y Claude (output_config.format). Tabla JSON mode vs schema, límites oficiales, Zod/Pydantic y cuándo no basta el prompt.

Leer guía
Flujo de un agente de soporte con IA: ticket entrante, respuesta con base de conocimiento y escalación a humano
+1
GuíaMensajeria10 min

Plantilla de agente de soporte con IA: el prompt, la escalación y el lanzamiento (2026)

Plantilla copiable para montar un agente de soporte con IA: el system prompt completo por bloques, la tabla de escalación a humano, las herramientas mínimas, la prueba previa y el checklist de lanzamiento. Copia, rellena los corchetes y publica sin empezar de cero.

Leer guía