smolagents

smolagents é um framework de agente de IA revolucionário e minimalista da equipe da Hugging Face, projetado para simplificar drasticamente a criação e implantação de agentes de IA robustos. Construído sobre o princípio da simplicidade, sua base de código principal tem aproximadamente 1.000 linhas, tornando-o altamente acessível para desenvolvedores. A principal inovação do framework é sua abordagem 'code-first' (código primeiro), onde os agentes geram e executam trechos de código Python para realizar ações, em vez de depender de blobs de JSON ou texto menos flexíveis. Este método prova ser mais eficiente, reduzindo o número de passos e chamadas de LLM em cerca de 30% e alcançando um desempenho superior em benchmarks complexos.

O framework foi projetado para máxima flexibilidade e integração. Ele funciona perfeitamente com qualquer modelo de linguagem grande, incluindo modelos de código aberto do Hugging Face Hub via Transformers, bem como modelos proprietários da OpenAI, Anthropic e outros através de sua integração com o LiteLLM. Isso permite que os desenvolvedores escolham o melhor modelo para sua tarefa específica sem ficarem presos a um único ecossistema.

Como usar smolagents

O uso do smolagents foi projetado para ser um processo intuitivo para desenvolvedores familiarizados com Python. O fluxo de trabalho geralmente envolve três etapas principais:

1. Defina Suas Ferramentas: O primeiro passo é criar ou importar as ferramentas que seu agente usará. Uma ferramenta é simplesmente uma função Python. Você pode facilmente transformar qualquer função em uma ferramenta usando o decorador `@tool`. Essas ferramentas podem realizar qualquer ação, desde fazer chamadas de API (como buscar dados de viagem do Google Maps) até realizar cálculos locais.
2. Instancie o Agente: Uma vez que você tenha suas ferramentas, você cria uma instância de uma classe de agente, como `CodeAgent`. Ao inicializar o agente, você fornece a ele a lista de ferramentas que ele pode usar e especifica o modelo de linguagem que deseja que o impulsione (por exemplo, `HfApiModel()` para modelos do Hugging Face).
3. Execute o Agente: Com o agente configurado, você pode dar a ele uma tarefa usando o método `.run()` e um prompt em linguagem natural. O agente então raciocinará autonomamente, escreverá código Python para usar as ferramentas fornecidas, executará o código e iterará até completar a tarefa. Por exemplo, você poderia pedir para ele "planejar uma viagem de um dia de bicicleta por Paris", e ele usaria uma ferramenta de tempo de viagem para gerar um itinerário detalhado.

Após criar uma ferramenta personalizada, você pode compartilhá-la facilmente com a comunidade enviando-a para o Hugging Face Hub com um único comando, fomentando a colaboração e o reuso.

Recursos principais do smolagents

• Agentes Code-First: Os agentes geram e executam código Python para ações, oferecendo flexibilidade, capacidade de composição e eficiência superiores em relação à chamada de ferramentas tradicional.
• Minimalista e Simples: Uma base de código compacta de cerca de 1.000 linhas garante que o framework seja fácil de entender, usar e estender.
• Ampla Compatibilidade com LLMs: Integra-se com qualquer LLM, incluindo modelos no Hugging Face Hub, OpenAI e Anthropic, via Transformers e LiteLLM.
• Execução Segura: Suporta a execução de código gerado pelo agente em ambientes sandbox como o E2B para garantir a segurança e prevenir efeitos colaterais indesejados.
• Integração Profunda com o Hugging Face Hub: Permite que os desenvolvedores compartilhem e carreguem ferramentas facilmente, fomentando um ecossistema colaborativo de componentes reutilizáveis.
• Suporte para Chamada de Ferramentas Tradicional: Embora o foco seja no code-first, o framework também suporta agentes tradicionais que usam JSON ou texto para ações, proporcionando flexibilidade para diferentes casos de uso.
• Alta Eficiência: Agentes de código reduzem o número de passos e chamadas de LLM necessários para completar tarefas complexas, levando a resultados mais rápidos e precisos.

Casos de uso para smolagents

A flexibilidade do smolagents o torna adequado para uma ampla gama de aplicações:

• Assistentes Pessoais: Criar assistentes sofisticados que podem gerenciar tarefas, como o exemplo do planejador de viagens que calcula rotas e constrói um itinerário.
• Análise de Dados e Geração de SQL: Construir agentes que podem entender consultas em linguagem natural, escrever as consultas SQL correspondentes para um banco de dados, executá-las e apresentar os resultados.
• Pesquisa Automatizada: Implantar agentes que podem navegar na web, coletar informações de múltiplas fontes, sintetizar descobertas e gerar um relatório resumido.
• Automação de Desenvolvimento de Software: Ajudar desenvolvedores escrevendo trechos de código, depurando ou até mesmo orquestrando processos de compilação simples, agindo como um assistente 'tipo Devin' para tarefas específicas.
• Automação de Fluxos de Trabalho Complexos: Conectar múltiplas ferramentas e APIs para automatizar processos de negócios de várias etapas, como processar tickets de suporte ao cliente ou gerenciar pedidos de e-commerce.

Vantagens do smolagents

O smolagents oferece vantagens significativas para desenvolvedores que constroem sistemas de agentes:

• Capacidade de Composição Superior: O código suporta naturalmente o aninhamento e o reuso de funções, permitindo a expressão de lógicas altamente complexas que são difíceis de alcançar com JSON.
• Manuseio Eficiente de Objetos: Gerenciar e transferir objetos de dados complexos entre etapas é muito mais simples e direto em código em comparação com a serialização para e de JSON.
• Flexibilidade Máxima: O código pode representar qualquer operação que um computador pode realizar, fornecendo versatilidade virtualmente ilimitada para as ações do agente.
• Aproveita os Pontos Fortes dos LLMs: Os LLMs foram treinados em vastas quantidades de código de alta qualidade, tornando-os excepcionalmente proficientes em gerá-lo e entendê-lo.
• Código Aberto e Impulsionado pela Comunidade: Sendo um projeto da Hugging Face, ele se beneficia de uma vibrante comunidade de código aberto e dos extensos recursos do Hugging Face Hub.

Preços e planos

smolagents é um framework de código aberto lançado sob a licença Apache 2.0, tornando-o completamente gratuito para uso. Os desenvolvedores podem baixar, modificar e integrar livremente a biblioteca em seus projetos. Embora o framework em si seja gratuito, os usuários podem incorrer em custos relacionados ao uso de serviços de terceiros, como:

• Chamadas de API para LLMs proprietários (por exemplo, a série GPT da OpenAI, o Claude da Anthropic).
• Uso de ambientes sandbox pagos ou outras ferramentas e APIs externas.