smolagents 项目说明：以代码为动作的轻量智能体库

用途与核心思路

smolagents 是 Hugging Face 提供的轻量智能体库，目标是用较少代码运行智能体，其主逻辑集中在约一千行的 agents.py 中，尽量保持抽象最小化。

它的核心是 CodeAgent：智能体的动作以 Python 代码片段写出，工具调用即 Python 函数调用，因此可以在一个动作里对多个网站发起搜索等批量操作。资料称这种做法相比让模型输出待调用工具的字典，可减少约 30% 的步骤与模型调用，并在困难基准上取得更高表现；该结论来自其引用的论文。

库同时提供更传统的 ToolCallingAgent，以 JSON/文本形式表达动作，可按场景选择。

适用场景与接入方式

• 模型无关：支持本地 transformers、ollama，也支持通过 InferenceClientModel、LiteLLM、OpenAI 兼容服务、Azure、Amazon Bedrock 等接入各类模型。
• 模态无关：资料称支持文本、视觉、视频乃至音频输入。
• 工具来源多样：可使用 MCP 服务器、LangChain 的工具，也可把 Hub Space 当作工具。
• 可与 Hub 集成，将工具或智能体推送/拉取共享。
• 提供 CLI：smolagent 为通用多步 CodeAgent 命令，webagent 为基于 helium 的网页浏览智能体。

限制与待核实

代码执行存在任意代码执行风险，资料明确要求将智能体代码放入沙箱，推荐 E2B、Blaxel、Modal 等云沙箱或 Docker 自托管容器；内置 LocalPythonExecutor 只是尽力而为的限制，不是安全边界，不可用于运行不可信代码。 资料中的代码示例、安装方式与基准结论均来自该仓库自述，未在此做运行验证；具体版本行为需以实际文档与测试为准。