smolagents 轻量级智能体库

smolagents

smolagents 是 Hugging Face 推出的轻量级智能体库，目标是让用户用很少的代码构建并运行智能体。其核心代码主要集中在约 1,000 行的 agents.py 中，抽象层次较薄，便于阅读和改写源码。

能做什么

• 以代码表达动作：提供 CodeAgent，让模型把动作写成 Python 代码片段，而非输出工具调用字典。库同时提供更传统的 ToolCallingAgent，以 JSON/文本形式表达动作。
• 多模型后端：通过 InferenceClientModel、LiteLLMModel、OpenAIModel、TransformersModel、AzureOpenAIModel、AmazonBedrockModel 等接入本地或云端模型。
• 多模态输入：文档称智能体支持文本、视觉、视频乃至音频输入。
• 工具与连接：可从 MCP 服务器、LangChain、Hub Space 等来源获取工具，也可在 Hugging Face Hub 上分享或拉取工具与智能体。
• 命令行使用：提供 smolagent（通用多步 CodeAgent）与 webagent（基于 helium 的网页浏览智能体）两个 CLI 命令。
• 多智能体层级、远程代码执行、工具集合导入等能力。

适用场景

• 需要用较少代码快速搭建智能体原型的开发者。
• 希望让模型以代码方式规划与调用工具、从而减少步骤的场景。
• 需要接入多种模型供应商或本地模型的工作流。
• 需要从 MCP、LangChain 或 Hub 复用既有工具的集成场景。

使用条件与限制

• 需要安装 Python 包，官方示例使用 pip install "smolagents[toolkit]"。
• 使用某模型后端时需自备对应服务的凭据或本地运行环境（如 API Key、本地 transformers 模型等）。
• 安全限制：由于 CodeAgent 涉及代码执行，官方明确要求将智能体代码放入沙箱运行，支持 E2B、Blaxel、Modal、Docker 等隔离方案。内置的 LocalPythonExecutor 不是安全沙箱，仅提供尽力而为的限制，可被绕过，不得作为安全边界用于运行不可信代码。
• 项目以 Apache License 2.0 发布。