smolagents · 第 1 章 smolagents 全貌与 agency 阶梯

smolagents · 第 1 章 smolagents 全貌与 agency 阶梯

章节摘要:本章是攀爬的起点。smolagents 是 HuggingFace 官方轻量 agent 库,"用代码思考"——LLM 把 action 写成 Python 代码而非 JSON。本章讲清库的定位与极简哲学(barebones:18 文件/1.28 万行/6 个核心依赖),引入官方 agency 等级表(☆~★★★)作为全书攀爬主线,并用 quickstart 三行代码跑起第一个 CodeAgent。本章共 2 节,无前置依赖。

阶梯坐标

学习目标

1. 说清 smolagents 定位与"代码即思考"理念。
2. 理解 barebones 极简哲学。
3. 认识 agency 等级表(全书主线)。
4. 跑通第一个 CodeAgent quickstart。
5. 认识 src/smolagents/ 18 个文件的分工。

子章节导航

01 smolagents 定位与 barebones 极简哲学

HF官方/1.27.0.dev0/Apache 2.0;"Agents that think in code!";代码即action范式(比JSON少30%步);barebones(18文件1.28万行/核心依赖仅6个/17组可选extras);测试1:1文化;18个核心文件分工总览(agents/models/tools/local_python_executor/default_tools/memory等)。

02 agency 等级表与 quickstart

agency等级表(☆单程序/☆☆Agent ReAct/☆☆☆CodeAgent/★★多agent/★★★自主研究);安装(pip install smolagents);quickstart三行代码(OpenAIModel+CodeAgent+web_search);agent选型(何时CodeAgent何时ToolCallingAgent);CLI(smolagent/webagent命令)。

前置知识与后续延伸

前置:Python基础;LLM基本概念。后续:第2章攀第一阶ToolCallingAgent。