SmolAgents
Hugging Face · Programação
O SmolAgents é um framework de agentes de IA de código aberto da Hugging Face: uma biblioteca de agentes em Python em que os agentes agem escrevendo código e rodam em sandbox.
Sobre SmolAgents
What Is SmolAgents
O SmolAgents é uma biblioteca de Python para criar agentes de IA, e vem da Hugging Face. É um framework de agentes open source: a equipe mantém a lógica central abaixo de cerca de 1.000 linhas, então você lê o que o código faz em vez de aprender um emaranhado de abstrações. O projeto instala de graça com um único comando pip.
A ideia por trás dele é simples: os agentes deveriam agir escrevendo código, não preenchendo uma lista JSON de chamadas de ferramenta. O CodeAgent escreve um trecho curto de Python a cada passo e o executa, e segundo a Hugging Face isso reduz as etapas e as chamadas ao modelo que uma tarefa exige. Existe um segundo tipo, o ToolCallingAgent, que mantém a chamada clássica em formato JSON se você preferir.
Rodar código gerado por um modelo tem risco, então o SmolAgents te empurra para um isolamento de verdade. Ele aceita sandboxes gerenciados na nuvem como E2B, Blaxel e Modal, além do Docker auto-hospedado. O executor local de Python só aplica restrições leves, e a documentação avisa sem rodeios que ele não é uma barreira de segurança. Anote mais uma coisa: é uma ferramenta para desenvolvedores. Não existe app com botões, então convém se virar bem em Python antes de valer a pena.
Getting Started
- Instale o pacote com
pip install "smolagents[toolkit]"para trazer um conjunto padrão de ferramentas. - Escolha um modelo: um local de transformers ou Ollama, um provedor do Hub da Hugging Face, ou qualquer um acessível pelas integrações com LiteLLM e servidores compatíveis com OpenAI.
- Crie um CodeAgent, passe suas ferramentas e o modelo, e chame
agent.runcom uma tarefa em linguagem natural. - Rode o agente dentro de um sandbox como E2B ou Docker antes de deixá-lo mexer em algo importante.
- Compartilhe o agente pronto no Hub com
push_to_hubpara que outros possam carregá-lo e reutilizá-lo.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de SmolAgents.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores de Python
- Engenheiros de IA com modelos locais
- Pesquisadores e estudantes
Tarefas
- Automatizar pesquisa em várias etapas
- Criar agentes que navegam na web
- Conectar ferramentas que você já tem
Cenários
- Prototipar uma ideia de agente rápido
- Manter trabalho sensível em sandbox
- Compartilhar um agente reutilizável com o time
Principais recursos
Agentes de código que escrevem ações em Python
O SmolAgents centra seu agente padrão no código. Em vez de soltar um bloco JSON com nomes de ferramentas, o modelo escreve um trecho curto de Python a cada passo e o framework o executa. A Hugging Face diz que esse estilo usa cerca de 30% menos passos em alguns benchmarks e pontua melhor nos difíceis, e o mesmo agente pode percorrer várias buscas ou cálculos numa única ação.
Execução de código em sandbox
Como o agente executa código que gera, o SmolAgents aceita execução isolada por sandboxes gerenciados como E2B, Blaxel e Modal, ou por um contêiner Docker auto-hospedado. Assim o código arbitrário não chega à sua máquina. O executor local de Python adiciona alguns limites, mas a documentação avisa que ele não é uma barreira de segurança, então o sandbox é o caminho previsto.
Configuração independente de modelo
A biblioteca não te tranca em um provedor. Ela traz classes de modelo para o Inference Client da Hugging Face, o LiteLLM, servidores compatíveis com OpenAI como Together AI e OpenRouter, modelos locais do transformers, Azure e Amazon Bedrock. Trocar de motor é uma linha, o que importa quando você compara custo ou alterna entre modelos hospedados e locais.
Flexibilidade de ferramentas e modalidades
Você carrega ferramentas de um servidor MCP, adapta ferramentas do LangChain ou até embrulha um Space da Hugging Face como ferramenta. Os agentes também aceitam mais que texto: o mesmo framework lida com entradas de visão, vídeo e áudio, então um agente que navega ou lê imagens encaixa sem uma biblioteca separada.
Compartilhar e reutilizar no Hub
Agentes e ferramentas sobem e descem do Hub da Hugging Face. Um agente pronto vira um repositório Space que você chama de qualquer lugar, o que transforma scripts pessoais em peças compartilhadas. A integração com o Hub é o que torna a reutilização prática dentro de um time ou de uma comunidade.
CLI e suporte multiagente
Dois comandos, smolagent e webagent, rodam agentes direto do terminal, com um modo interativo que percorre o tipo de agente, as ferramentas e a configuração do modelo. Além disso, o SmolAgents aceita hierarquias multiagente em que um agente gerencia outro, então você monta um gerente que delega para um agente de busca ou um de código.
Prós e contras
Prós
- O núcleo tem cerca de 1.000 linhas, então o laço do agente fica legível e fácil de modificar.
- Os agentes de código cortam passos e chamadas ao modelo frente ao tool calling em JSON, o que baixa o custo em tarefas longas.
- Funciona com quase qualquer modelo, de uma instância local do Ollama até OpenAI, Anthropic e Bedrock.
- O suporte a sandbox com E2B, Blaxel, Modal e Docker dá isolamento real para o código gerado.
- A integração com o Hub deixa publicar e reutilizar agentes e ferramentas em vez de refazê-los.
Contras
- É uma biblioteca para desenvolvedores, não um app, então quem não sabe Python não a usa direto.
- O executor local embutido não é um sandbox de segurança, e rodar código não confiável sem E2B ou Docker é um risco real.
- A camada de abstração tão fina deixa parte da ligação nas suas mãos, ao contrário de frameworks mais pesados e com mais peças incluídas.
- Configurar um sandbox remoto ou um modelo local soma ajustes antes de o primeiro agente rodar.
Perguntas frequentes
O SmolAgents é uma biblioteca de Python para criar agentes de IA que concluem tarefas escrevendo e executando código. Os desenvolvedores a usam para automatizar trabalhos de várias etapas como pesquisa, navegação web e chamadas de ferramenta, e para experimentar desenhos de agentes sem um framework pesado.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a SmolAgents.
Alternativas a SmolAgents
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.