smolagents: la biblioteca de agentes minimalista de Hugging Face

La idea: menos abstracción, más código

Hugging Face publicó smolagents a finales de 2024 con una promesa sencilla: que la lógica completa de un agente quepa en una base de código pequeña y legible. Mientras muchos frameworks acumulan capas, smolagents se mantiene cerca de cómo funciona de verdad un agente de IA: el modelo razona, elige una acción, observa el resultado y vuelve a empezar, según el patrón ReAct.

Ofrece dos tipos de agentes:

• CodeAgent, la especialidad de la casa: en cada paso, el modelo escribe un fragmento de Python que llama a herramientas, hace cálculos o combina resultados;
• ToolCallingAgent, para la llamada a herramientas clásica en JSON cuando ese modo resulta más adecuado.

Las herramientas pueden venir de un servidor MCP, de LangChain o incluso de una aplicación publicada en el Hub de Hugging Face. También es posible que varios agentes colaboren, con uno que dirige a los demás.

¿Para quién y para qué?

smolagents sirve para aprender qué es realmente un agente, crear prototipos rápido o construir agentes de búsqueda web, análisis de datos y tratamiento de archivos. Encaja bien con los modelos de pesos abiertos, ya que funciona igual con un modelo local que con una API comercial. Los agentes admiten además entradas de imagen, vídeo o audio.

Empezar en pocos minutos

Tras instalar con pip el paquete smolagents (con la opción «toolkit» para las herramientas por defecto, como la búsqueda web), se elige un modelo, se crea un CodeAgent con una lista de herramientas y se le encarga una tarea. Los comandos listos para usar smolagent y webagent permiten incluso probarlo sin escribir un script.

Puntos fuertes y límites

Puntos fuertes: sencillez, transparencia (se ve el código que escribe el agente), independencia del modelo e integración con el Hub.

Límites: ejecutar código generado exige un aislamiento en sandbox serio en producción; la calidad depende mucho del modelo, ya que los modelos pequeños escriben código menos fiable; y no hay interfaz visual ni gestión avanzada del estado y de la reanudación como en frameworks más pesados.

Alternativas

Para producción con control fino, considere LangGraph o Pydantic AI. Para un SDK oficial de un fabricante, el OpenAI Agents SDK o Google ADK.