Smolagents

Smolagents 是 Hugging Face 推出的轻量级 AI agent 框架，支持基于代码的 agent、工具调用、Python 代码执行、沙箱运行，并可集成 Hugging Face 及其他模型提供商。

概述

Smolagents 是 Hugging Face 团队推出的轻量级 AI agent 框架。其目标是帮助开发者仅用少量代码构建能够与现实世界交互的 agent，同时保持框架小巧且易于上手。

该网站将产品重点放在 code agent 上：agent 不只是生成 JSON 或文本动作，而是通过编写并执行 Python 代码片段来完成任务。Smolagents 还支持传统的工具调用型 agent、沙箱执行选项，以及与 Hugging Face 生态及其他平台的模型和工具集成。

功能

紧凑的核心框架

Smolagents 被描述为一个极简框架，其 `agents.py` 中的核心代码约 1,000 行，这使得抽象层更小，代码库也更容易检查。

代码 agent 工作流

该框架强调让 agent 编写并运行 Python 代码片段来执行操作，而不是仅依赖 JSON 或基于文本的工具输出。

面向效率的执行

网站称，与标准工具调用方法相比，代码 agent 可将步骤和 LLM 调用次数减少约 30%，并且在复杂基准上表现更好。

沙箱化代码执行

Smolagents 支持 E2B 等沙箱环境，以便更安全地执行生成的代码，为开发者提供一个隔离的环境来运行 agent 操作。

模型与 Hub 集成

该框架可通过 Hugging Face Hub 集成，用于共享和加载工具；同时它也可通过 Transformers 使用 Hugging Face 模型，并通过 LiteLLM 兼容 OpenAI、Anthropic 及其他提供商。

多种 agent 风格

除了 code agent 之外，网站还表示 smolagents 也支持传统的工具调用型 agent，在这种格式更合适时使用 JSON 或文本块。

使用场景

代码优先的 agent 开发
构建通过 Python 代码执行操作的 agent，尤其适合需要可复用函数、对象处理或比简单工具调用更复杂控制流的任务。
自定义工具工作流
为 agent 添加自定义工具，例如旅行规划、网页搜索或图像生成，并通过 Hugging Face Hub 分享这些工具。
更安全的代码执行
当你希望在开发或部署期间为执行过程提供更安全的边界时，可在沙箱环境中运行生成的 agent 代码。
多模型设置
当你希望在模型选择上更灵活时，可使用 Hugging Face、OpenAI、Anthropic 或其他 LiteLLM 兼容来源的受支持模型提供商。
工具调用替代方案
当 JSON 或文本块动作更适合特定工作流时，可选择传统的工具调用型 agent，而不是 code agent。

Pros and Cons

Pros

核心框架较小，代码库精简。
同时支持 code agent 和传统工具调用型 agent。
可通过 LiteLLM 与 Hugging Face 模型及其他提供商协同工作。
包含沙箱执行选项，可更安全地运行代码。
提供免费的 Starter 方案和付费的 Pro 方案。

Cons

源材料对支持的集成仅提供有限细节，因此平台生态主要以较宽泛的方式描述。
定价页面包含占位符 FAQ 和推荐语文本，因此除方案摘要外，并未提供太多具体的产品指导。

FAQ

什么是 Smolagents？

Smolagents 被定位为 Hugging Face 团队推出的轻量级 AI agent 框架。它旨在让开发者以相对较少的代码定义一个 agent、添加工具并运行它。

Smolagents 支持哪些类型的 agent？

该网站表示，smolagents 支持 code agent，即 agent 会编写并执行 Python 代码片段；也支持使用 JSON 或文本块的传统工具调用型 agent。

Smolagents 是免费的吗？

价格页面显示有一个免费的 Starter 方案和一个付费的 Pro 方案。Starter 包含 5 台设备、1 个月云端保留、无限通知和基础集成；Pro 标价为每月 12 美元，包含无限设备、1 年云端保留、无限通知、高级集成以及优先客户支持。

Smolagents 如何安全地处理工具和执行？

该网站将 E2B 等沙箱执行选项描述为更安全的代码执行方式。页面还展示了围绕自定义工具和 Hugging Face Hub 分享构建的示例。

Quick Facts

类别: AI Agent Framework
品牌: Smolagents
源站域名: smolagents.org
主要用户: 构建 agent 的开发者
核心工作流: 由 LLM 编写的 Python 代码与工具使用
定价: 免费 Starter 方案和付费 Pro 方案