huggingface/smolagents
打开原仓库 smolagents
读懂工具声明与 Agent 循环，先把权限边界做清楚。
进阶Apache-2.0学习估计 5–8 小时尚未记录
本次学习产物
为一个只读工具补齐输入校验和失败测试。
开始前
Python 类型标注、JSON、异常处理。
运行环境CPU；先运行工具单元测试。真实 Agent 运行另需选择模型和预算。
上游支持生成代码执行；本学习切片只做只读工具和源码阅读，网站不会执行用户源码。
STEP 01 / 04
读懂源码
在 tools.py 找 Tool 输入 schema 和 forward，在 agents.py 追踪工具调用结果如何进入下一步。
从这两个入口读起
先在纸上画出输入 → 处理 → 输出，再用断点或日志验证调用顺序。记录你读到的函数名与行号，不要求通读整个仓库。
准备自己的源码副本
git clone https://github.com/huggingface/smolagents.git
cd smolagents
git checkout 96f33faaf028479119ec8d34507b47694cf14e34
git switch -c study/smolagents在新的学习目录运行；固定提交用于对应源码导读，不承诺它是最新稳定发行版。
留下这一步的学习依据
访客手记仅保存在此浏览器；登录后可主动导入到账号，原件保留。清除浏览器数据前请导出。不保存密钥或敏感资料。
修订历史 0 版
保存会追加历史，保留之前的失败与修订依据；访客最多 50 版，不自动清理。
还没有保存记录。可以先记录一个问题，再慢慢修订。