Cómo funcionan los agentes de IA, desde cero
Un agente de IA es un modelo de lenguaje dentro de un bucle con herramientas: lee el pedido, pide una herramienta, recibe el resultado y decide qué hacer después, hasta terminar el trabajo. Agent Harness Patterns explica ese bucle pieza por pieza, en 17 patrones cortos que se apoyan unos en otros.
Cada patrón muestra el problema, una traza animada de un agente que lo resuelve y el código dos veces: desde cero en TypeScript y Python, y con astorlm, el SDK de agentes open source para TypeScript del que salen los patrones.
El recorrido de fundamentos
-
0
Tu caja de herramientas
Las piezas previas a cualquier agente: el modelo, el system prompt, los mensajes que reenvías y una primera herramienta.
-
1
¿Qué es un agente?
La diferencia entre llamar a un modelo, armar un workflow y dejar que el modelo decida qué hacer.
-
2
El bucle del agente
Llamar al modelo, ejecutar las herramientas que pide, devolverle los resultados y repetir hasta que termine.
-
3
Diseñar una herramienta
Nombre, descripción y esquema: todo lo que el modelo sabe de una herramienta.
-
4
Cuándo parar
end_turn, límites de turnos y herramientas terminales: las formas de terminar el bucle.
-
5
Errores en el bucle
Una herramienta que falla no rompe al agente: el error vuelve como resultado y el modelo se recupera.
-
6
Hooks
Los puntos donde tu código entra en el bucle: antes de cada turno, de cada llamada al modelo, de cada ejecución de herramienta.
-
7
La mochila se llena
Qué pasa cuando el historial ya no entra en la ventana de contexto, y cómo compactarlo.
-
8
Skills bajo demanda
Un catálogo liviano siempre a mano, y el manual completo solo cuando hace falta.
-
9
Memoria
Recordar entre sesiones: historial guardado, archivos y búsqueda por significado.
-
10
Vueltas limpias
Cuando el trabajo no entra en una sesión: un agente nuevo en cada vuelta, con el progreso guardado en archivos.
-
11
Observabilidad y evaluaciones
Ver qué hizo el agente, cuánto costó y si lo hizo bien.
-
12
Planificar y reflexionar
Pensar el plan antes de tocar nada, y revisar el resultado antes de entregarlo.
-
13
Humano en el bucle
Pedir permiso, aceptar correcciones a mitad de camino y escalar ante la duda.
-
14
Seguridad y sandboxing
Encerrar lo que el agente ejecuta, y desconfiar de lo que lee.
-
15
Subagentes
Delegar una subtarea a otro agente con su propio contexto limpio.
-
16
Agentes proactivos
Agentes que se despiertan solos: un heartbeat, primero un chequeo barato y un mensaje solo cuando importa.
Constrúyelo con astorlm
El bucle del agente como librería: un runtime agéntico embebible y SDK-first para TypeScript.
pnpm add astorlm¿Usas un asistente de código con IA? Apúntalo a llms.txt o lee la guía para agentes de IA.