Atomic Agents: montar agentes de IA pieza a pieza

La idea: piezas de un solo uso

El creador de Atomic Agents lo compara con piezas de construcción: cada componente hace una sola cosa, se puede reutilizar, se combina con los demás y produce resultados estables. En la práctica, cada agente declara un esquema de entrada y otro de salida con Pydantic, y la biblioteca Instructor obliga al modelo de lenguaje a responder en ese formato (salida estructurada). Para encadenar dos agentes, se hace coincidir la salida de uno con la entrada del siguiente.

Alrededor de los agentes hay un generador de prompt de sistema (contexto, pasos, instrucciones de salida), un historial de conversación y «proveedores de contexto» que inyectan información dinámica, como resultados de búsqueda.

Para qué sirve en la práctica

Atomic Agents encaja en cadenas de procesamiento controladas: un asistente que siempre propone preguntas de seguimiento, un pipeline que busca en la web y luego resume, un agente que extrae campos concretos de un documento. La CLI «atomic» descarga herramientas listas para usar (búsqueda web, calculadora, lector de PDF, transcripciones de YouTube, entre otras) en forma de código que usted puede modificar. Un conector MCP permite usar las herramientas de un servidor externo, y cada ejecución puede trazarse con OpenTelemetry.

Cómo empezar

Instale atomic-agents con pip, añada si hace falta el complemento de Instructor para su proveedor y defina un esquema de salida, una configuración de agente y un cliente del modelo. El repositorio incluye ejemplos de inicio rápido y proyectos completos, y la documentación publica también archivos preparados para que los lea un asistente de programación.

Ventajas y límites

Ventajas: código explícito y fácil de probar, salidas tipadas, poca «magia» oculta, muchos proveedores de modelos y licencia MIT.

Límites: solo Python; el enfoque exige escribir más esquemas que otros frameworks más automáticos; el proyecto depende en gran parte de un único mantenedor, y la versión 2.0 rompió la compatibilidad con la anterior.

Alternativas

Pydantic AI comparte la misma filosofía de tipado, smolagents es igual de ligero pero más autónomo y Langroid se basa en agentes que intercambian mensajes.