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

Explora por tema

Tres hubs de referencia para encontrar la guía correcta según lo que estás construyendo o decidiendo.

Guías de construcción de agentes

Aquí viven las guías para pasar de idea a agente funcionando: arquitectura, frameworks, MCP, RAG, herramientas, automatización y agentes especializados. Cada artículo prioriza lo que se puede implementar hoy: qué instalar, qué configurar, qué límites conocer y cómo validar que el agente hace lo que promete. Si estás empezando, empieza por los artículos de arquitectura y herramientas; si ya tienes un prototipo, los de memoria, skills y agentes especializados te ayudan a convertirlo en algo operativo. También cubrimos los canales donde vive un agente (WhatsApp, Telegram, mensajería), los modelos locales y los datos que necesita para ser útil. Las revisamos cuando cambian modelos, SDKs o buenas prácticas, y cada una enlaza a las siguientes lecturas según tu nivel y tu stack.

Explorar hub

Comparativas y decisiones

Las guías para elegir sin adivinar: comparativas de modelos, benchmarks, plataformas y ecosistemas de agentes con criterios explícitos. En lugar de listas genéricas, cada artículo explica qué medir, qué diferencia hay en la práctica y en qué caso conviene cada opción. Si estás decidiendo entre proveedores, modelos o arquitecturas, estas piezas te dan el marco para comparar con datos y no con ruido. Incluyen benchmarks oficiales, análisis de plataformas como OpenAI, Google Gemini, Claude, AWS, Vercel o Cloudflare, y lecturas del ecosistema para entender hacia dónde va la industria sin depender de un solo anuncio. El criterio de elección siempre conecta con el caso de uso: presupuesto, latencia, privacidad y mantenimiento son parte de la ecuación, no solo el nombre del modelo.

Explorar hub

Seguridad, coste y operación

Lo que separa una demo de un agente que aguanta producción: seguridad, costes, despliegue, observabilidad, evals y gobernanza. Cada guía cubre un riesgo concreto —fugas de datos, prompts maliciosos, memoria indebida, fallos silenciosos, presupuestos que se disparan— y cómo mitigarlo con permisos, human-in-the-loop, métricas y revisiones. También encontrarás costes reales de operación, infraestructura de despliegue y las prácticas de AgentOps que mantienen un agente sano a largo plazo. Si tu agente ya funciona pero no confías del todo en él, este hub es el siguiente paso. Y si estás planificando un despliegue nuevo, las guías de esta sección te ahorran los errores caros: qué medir antes de escalar, qué automatizar y qué dejar siempre con supervisión humana.

Explorar hub

Guías prácticas

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

Capas de build planas con una franja de secret mount y un recorte omit
GuíaDeploy10 min

Build secrets Docker para un agente IA: el token no va en el layer

Cómo instalar un paquete privado en el build del agente sin hornear el token: RUN --mount=type=secret, --secret id= en Buildx y secrets/secret-envs/secret-files en GitHub Actions. Distinto de Compose secrets (runtime) y de .dockerignore. Default /run/secrets/<id>, required=true.

Leer guía
Tipografía copilot con prompt ❯ y cuatro líneas de comandos genéricos
GuíaCoding Agents9 min

GitHub Copilot CLI: guía práctica del agente de IA en la terminal

Guía práctica de GitHub Copilot CLI en 2026: instalación con npm, Homebrew, WinGet o script, autenticación OAuth /login, tokens y BYOK, modo headless con -p, permisos --allow-all-tools, sandbox local o --cloud, instrucciones AGENTS.md y un checklist para usarlo sin soltar el repo.

Leer guía
Grafo de nodos conectados con estado compartido para un agente IA
GuíaFrameworks de Agentes11 min

LangGraph: guía práctica de grafos con estado para agentes en Python

Guía práctica de LangGraph en 2026: instalar langgraph 1.2.11 con Python 3.10+, modelar estado con TypedDict y StateGraph, conectar nodos con add_edge y add_conditional_edges entre START y END, persistir con checkpointer y thread_id, pausar para aprobación humana con interrupt, y abanicar trabajo con Send. Cuándo un grafo le gana a un crew de roles.

Leer guía
Escáner de seguridad revisando las capas de una imagen Docker antes del despliegue
GuíaDeploy9 min

Trivy para tu agente IA: escanear la imagen Docker antes de desplegar

Tu imagen del agente arrastra CVEs de la base y de las librerías aunque tu código esté limpio. Esta guía muestra cómo escanearla con Trivy en local y en CI: instalación, severidades, exit-code como puerta de deploy, SARIF en GitHub y qué hacer con cada hallazgo. Distinto de SBOM, de pin digest y de dockerignore.

Leer guía
Tres bandas planas etiquetadas allow, ask y deny con exit 2
GuíaCoding Agents9 min

Hooks en Claude Code: automatiza y bloquea acciones del agente en el punto exacto

Guía práctica de hooks en Claude Code para agentes de IA: configuración por evento y matcher en settings.json, JSON que llega por stdin, códigos de salida que bloquean de verdad (exit 2), decisiones allow, deny y ask con hookSpecificOutput, y un ejemplo real para frenar comandos destructivos sin tocar el turno del modelo.

Leer guía
Equipo de agentes IA con roles distintos colaborando en una misma tarea
GuíaFrameworks de Agentes11 min

CrewAI: guía práctica de crews multi-agente en Python con roles

Guía práctica de CrewAI en 2026: instalar crewai 1.15.20 con Python 3.10+ crear Agents con rol objetivo y backstory, Tasks con expected_output, Crews secuenciales o jerárquicas con memoria, tools con el decorador @tool, y Flows con @start y @listen para orquestación con estado. Cuándo elegir crews de roles frente a LangGraph o Pydantic AI.

Leer guía
Marco de terminal plano con el prompt ❯ gemini y cinco líneas de comandos
GuíaCoding Agents9 min

Gemini CLI: guía práctica del agente de IA en la terminal

Guía práctica de Gemini CLI en 2026: instalación por npm, Homebrew o npx, tres formas de autenticación (Google OAuth con free tier, API key de AI Studio o Vertex AI), modo headless con -p y --output-format para scripts, sandbox con -s, contexto con GEMINI.md, servidores MCP y qué hacer tras el anuncio de migración a Antigravity CLI.

Leer guía
Varios bloques a la izquierda que convergen en un recuadro :4000 y un agente
GuíaAgentOps10 min

LiteLLM proxy para agentes: un gateway OpenAI frente a 100+ modelos

Guía práctica de LiteLLM como AI Gateway self-hosted para agentes: SDK completion(), proxy en :4000, config.yaml, virtual keys con Postgres, load balancing, fallbacks y Docker Compose. Distinto de Vercel/Cloudflare AI Gateway (managed) y del fallback en el código del agente.

Leer guía
Nombre kimi, prompt ❯ kimi -p y tres bloques /login /compact /fork
GuíaCoding Agents10 min

Kimi Code CLI: guía práctica del agente de IA en la terminal

Guía práctica de Kimi Code CLI para trabajar como agente de IA desde la terminal: instalación por script o npm, primer arranque con /login (OAuth o API key), sesiones con /compact y /fork, configuración multi-proveedor en config.toml, modo headless con kimi -p y un checklist para operarlo sin romper tu repo.

Leer guía
Rectángulo sólido con la palabra app, sin cromo de producto
GuíaMensajeria9 min

Telegram Mini App con IA: cómo crear el agente dentro del chat

Una Telegram Mini App es una web app que corre dentro de Telegram: el bot lanza la interfaz, la app recibe el usuario por initData y el backend valida la firma antes de llamar al LLM. Esta guía práctica cubre cómo configurar la Mini App con BotFather, los siete mecanismos de lanzamiento, el patrón bot + backend + modelo con Telegram.WebApp.initData, los límites de la WebView, y un checklist para poner el agente en producción sin romper la validación.

Leer guía
ARG de build a la izquierda y ENV de runtime a la derecha en la imagen de un agente
GuíaDeploy10 min

ARG vs ENV en un agente IA: build-time no es runtime

Cómo no hornear el token ni perder NODE_ENV: ARG es --build-arg y no vive en el contenedor; ENV sí persiste y docker inspect lo muestra. Scope por stage, ENV pisa ARG del mismo nombre, cache miss en el primer uso. Distinto de build secrets y de NODE_ENV en producción.

Leer guía
Diagrama de un agente TypeScript Mastra con tools, workflows y Studio local
GuíaFrameworks de Agentes10 min

Mastra: guía práctica de agentes TypeScript con Studio

Guía práctica de Mastra en 2026: instalar @mastra/core 1.64.0 y el CLI mastra 1.27.3 con Node 22.13+, crear un Agent con model en formato provider/model, tools con createTool y execute(inputData, context), registrarlas en new Mastra(), y probarlas en Studio en localhost:4111. Distinto de Pydantic AI, LangGraph y de un coding agent de terminal.

Leer guía
Un tag de imagen con dos manifiestos: linux/amd64 y linux/arm64 para el mismo agente
GuíaDeploy10 min

Buildx multi-platform para un agente IA: amd64 y arm64 en un tag

Cómo publicar un agente que corre en Mac ARM y en VPS x86 con un solo tag: docker buildx --platform linux/amd64,linux/arm64, driver docker-container, QEMU vs nodos nativos vs cross-compile, y GitHub Actions con setup-qemu + setup-buildx. Distinto de Bake, de cache y de pin digest.

Leer guía
Un agente envía una llamada a OpenRouter y el router elige proveedor o modelo de respaldo
GuíaAgentOps9 min

OpenRouter para agentes IA: una API, fallbacks y créditos

OpenRouter es un proxy OpenAI-compatible hacia cientos de modelos: una key, credits, models[] para fallback y provider para enrutar. Distinto de LiteLLM (lo operas tú) y de AI Gateway de Vercel/Cloudflare. 402 no es 429. :free son 20 RPM y 50 RPD sin créditos. La key vive fuera del prompt.

Leer guía
Dos mitades planas: Chat a la izquierda y Agent a la derecha
GuíaCoding Agents10 min

Continue.dev: guía práctica del agente open source en VS Code

Continue.dev es el agente de código open source que vive en VS Code, JetBrains y la CLI cn. Esta guía cubre instalación, modos Chat/Plan/Agent, config.yaml, reglas en .continue/rules, headless cn -p y el checklist para usarlo después del freeze 2.0.0 del repo.

Leer guía
Tres columnas planas etiquetadas spdx, syft y provenance
GuíaDeploy10 min

SBOM y attestations Docker para un agente IA: qué hay dentro, cómo se construyó

BuildKit adjunta provenance mode=min por defecto. El SBOM no va solo: --sbom=true, SPDX in-toto y Syft. Escanea el stage final salvo ARG BUILDKIT_SBOM_SCAN_STAGE. mode=max filtra ARG; secretos van en mounts. Docs Docker attestations, SBOM y GitHub Actions, 7 sep 2026.

Leer guía
Cuatro tiles planos: webhook, worker, inherits y matrix
GuíaDeploy10 min

Docker Bake para un agente IA: un archivo, varios targets, cero CLI eterno

Bake de Docker Buildx declara el build en HCL: group, target, inherits y matrix. Un docker buildx bake construye webhook y worker en paralelo; --print antes de CI; --load local y --push al registry. Distinto de cache de capas y de compose watch. Docs Bake, 7 sep 2026.

Leer guía
Tres filas de esquema plano: name, ok y tool
GuíaFrameworks de Agentes10 min

Pydantic AI: guía práctica para agentes tipados en Python

Guía práctica de Pydantic AI en 2026: instalar pydantic-ai 2.40.0 con Python 3.10+, Agent con output_type validado, tools con @agent.tool y RunContext, deps_type para inyectar clientes sin meter secretos en el prompt, y cuándo no sustituye a LangGraph ni a un coding agent de terminal.

Leer guía

Referencia para coding agents

Consulta un comando concreto de Git o GitHub Actions, sus riesgos y las comprobaciones antes de ejecutarlo con un agente de código.

git pickaxe: encontrar el commit que introdujo una línea con git log -S y -Ggit LFS para coding agents: track, pull y modelos fuera del repogit show-branch para coding agents: el grafo semi-visual de 26 puntasgit show-index para coding agents: dump del .idx, no verify-packgit multi-pack-index para coding agents: un índice de packs, no gcgit check-mailmap para coding agents: canónico, no reescrituragit commit-graph para coding agents: índice de historia, no gcgit replace para coding agents: refs locales que mienten el SHA, no reescrituragit var para coding agents: una variable lógica, no el configgit stripspace para coding agents: limpia el mensaje, no el parchegit interpret-trailers para coding agents: parse, no reescribir el mensajegit patch-id para coding agents: huella del diff, no del SHAgit merge-file para coding agents: merge a tres vías de un archivo, no de la historiagit difftool para coding agents: GUI humana, no el diffgit mergetool para coding agents: GUI humana, no resolver conflictosgit replay para coding agents: objects nuevos, refs intactasgit diff-tree para coding agents: dos trees, no el discogit diff-files para coding agents: working tree vs index, no el parchegit diff-index para coding agents: tree vs disco o indexgit checkout-index para coding agents: index al disco, no checkoutgit mktree para coding agents: tree desde ls-tree, no desde el indexgit commit-tree para coding agents: commit sin mover HEADgit read-tree para coding agents: carga el índice, no el discogit write-tree para coding agents: tree del index, no un commitgit update-index para coding agents: plumbing del index, no addgit checkout para coding agents: dos modos, cero autónomogit prune-packed para coding agents: borrar sueltos ya empaquetados, no housekeepinggit unpack-objects para coding agents: stdin a loose, no explode el object storegit index-pack para coding agents: idx de un .pack, no unpack ni --stdin a ciegasgit verify-pack para coding agents: validar un pack, no volcar el object databasegit pack-objects para coding agents: plumbing de packs, no compactar el repogit update-ref para coding agents: plumbing de refs, no mover HEADgit pack-refs para coding agents: packed-refs, no el dump al LLMgit repack para coding agents: compactar packs, no housekeeping a pelogit shortlog para coding agents: recuento por autor, no dump de loggit hooks para coding agents: listar, no instalar ni --no-verifygit maintenance para coding agents: housekeeping programado, no gc a pelogit credential para coding agents: helpers, no tokens en el promptgit verify-tag para coding agents: ningún release sin firma válidagit rerere para coding agents: el mismo conflicto no se resuelve dos vecesgit verify-commit para coding agents: firma válida no es firma confiablegit count-objects para coding agents: disco, no housekeepinggit prune para coding agents: plumbing, no housekeepinggit fsck para coding agents: integridad, no housekeepinggit gc para coding agents: housekeeping, no borrar el working treegit range-diff para coding agents: dos series, no un diffgit notes para coding agents: texto al lado, el SHA no cambiagit bundle para coding agents: objetos y refs, no un targit archive para coding agents: snapshot del tree, no otro clonegit sparse-checkout para coding agents: menos disco, no otro clonegit merge-tree para coding agents: merge en seco, sin tocar el índicegit cherry para coding agents: +/− por patch-id, no por SHAgit format-patch para coding agents: mailbox, no un diff sueltogit am para coding agents: mailbox a commits, no un diff sueltogit apply para coding agents: pega el parche, no crea el commitgit check-ref-format para coding agents: el nombre es válido, no que la rama existagit check-attr para coding agents: qué attr gana, no leer .gitattributes a ojogit name-rev para coding agents: SHA a nombre, no a describegit symbolic-ref para coding agents: leer HEAD, no reescribirlogit rev-list para coding agents: SHA y --count, no el dump al LLMgit show-ref para coding agents: refs locales, no el dump al LLMgit for-each-ref para coding agents: refs locales, cero update-refgit hash-object para coding agents: SHA del contenido, no un commitgit ls-remote para coding agents: refs del remoto, cero fetchgit cat-file para coding agents: tipo y talla, no el blob al LLMgit ls-tree para coding agents: tree object, no el discogit submodule para coding agents: gitlink 160000, no un clone extragit describe para coding agents: nombre legible, no un Releasegit merge-base para coding agents: ancestro común, no folkloregit check-ignore para coding agents: regla ganadora, no adivinargit rev-parse para coding agents: SHA, rama y cwd, no folkloregit grep para coding agents: tracked, pathspec y techo de líneasgit ls-files para coding agents: index y disco, no findgit mv para coding agents: index y disco, no /bin/mvgit rm para coding agents: index y disco, no /bin/rmgit init para coding agents: repo nuevo, no parche de uno existentegit reflog para coding agents: tips locales, no historia publicadagit show para coding agents: objeto concreto, no el parche al LLMgit tag para coding agents: listar refs, no publicar releasesgit remote para coding agents: listar, no reescribir origingit branch para coding agents: crear refs, no cambiar de árbolgit config para coding agents: get, --local, cero --globalgit clone para coding agents: un repo, luego worktreegit commit para coding agents: index, -m, cero amendgit push para coding agents: origin, tu rama, cero maingit status para coding agents: porcelain, XY, no el longReusable workflows: workflow_call, no copies el YAML entre reposschedule (cron) en GitHub Actions: UTC, no cada minutogit log para coding agents: A..B, A...B y no volcar historianeeds e if en GitHub Actions: deploy no corre si test fallógit diff para coding agents: working tree, index, A...Bstrategy.matrix en GitHub Actions: no clones el job a manogit fetch para coding agents: origin/*, FETCH_HEAD, cero --forceworkflow_dispatch: ejecuciones manuales seguras para agentespull_request_target: no lo uses como CI de forksgit switch para coding agents: cambiar de rama, no restaurar archivosOIDC en GitHub Actions: id-token, no keys estáticas en secretsEnvironments en GitHub Actions: prod no es un string, es un gategit bisect para coding agents: start, skip, run 125, siempre resetupload-artifact en GitHub Actions: v4, retention corto, cero secretosgit blame para coding agents: anota líneas, no culpa al autorCache en GitHub Actions: key del lockfile, nunca secretostimeout-minutes en GitHub Actions: no dejes el default de 6 horasgit pull para coding agents: fetch primero, --ff-only, no rebaseConcurrency en GitHub Actions: un run por rama, cancel-in-progress con criteriogit revert para coding agents: commit nuevo que deshace, no resetGITHUB_TOKEN en Actions: permissions mínimas, no un PAT de admingit cherry-pick para coding agents: un commit nuevo, no copiar el SHAgit merge para coding agents: commit de fusión, no rebase ni -X oursgit rebase para coding agents: reescribe SHA; no es merge ni resetgit reset para coding agents: mueve HEAD; --hard no es el undogit stash para coding agents: no es un worktree ni un backupgit clean para coding agents: dry-run primero, -x casi nuncagit restore para coding agents: deshacer un path, no reset --hardgit add para coding agents: paths explícitos, nunca git add .