免费 AI Agent 课程上手：Hugging Face Agents Course 三步搭好环境，跑通第一个 Agent
【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course
Hugging Face Agents Course 是一门免费的 AI Agent 课程：用 Python 从 Agent 基础概念讲到 smolagents、LlamaIndex、LangGraph 三大框架实战，最后用 GAIA 基准评测收尾，通过即获课程认证。这篇指南带你三步搭好本地学习环境，直接翻开第一课。
课程地图：5 个主单元 + 3 个加餐
| 单元 | 学什么 | 你的产出 |
|---|---|---|
| Unit 0 | 课程导览、注册账号、加入学习社区 | 可用的课程账号 |
| Unit 1 | Agent 定义、LLM 大脑、思考-行动-观察循环 | 用 smolagents 写的第一个 Agent |
| Bonus 1 | 微调模型支持函数调用 | 会调用工具的微调模型 |
| Unit 2 | smolagents、LlamaIndex、LangGraph 框架实战 | 按场景选框架的判断力 |
| Bonus 2 | Agent 可观测性与评估 | 追踪运行轨迹的方法 |
| Unit 3 | Agentic RAG：Agent 先检索文档再作答 | 会检索、会回答的 Agent |
| Bonus 3 | 宝可梦对战游戏 Agent | 一个能下场的对战 Agent |
| Unit 4 | GAIA 基准最终项目 | 结业证书 |
各单元相对独立，可按自己节奏安排；完整章节顺序见 units/en/_toctree.yml。
动手前核对运行环境清单
- Python ≥ 3.11：跑
python --version确认，版本要求写在 quiz/pyproject.toml - 装了 git：
git --version有输出即可 - 网络能访问 PyPI：后续依赖全靠它下载
- 有 Python 基础语法和 LLM 初步概念：这是课程列出的先决条件
三步搭好本地学习环境
第 1 步：克隆课程仓库
git clone https://gitcode.com/GitHub_Trending/ag/agents-course为什么要克隆：讲义、单元内容和测验工具都放在仓库里，units/ 是各单元讲义，quiz/ 是配套测验工具，本地留一份随时可离线翻阅。
跑完你应该看到当前目录多出agents-course文件夹，units/、quiz/两个子目录齐全。
第 2 步：创建并激活虚拟环境
cd agents-course && python -m venv agents-env && source agents-env/bin/activatevenv（虚拟环境）相当于给课程单独开一个 Python 沙盒，装的包不会污染系统解释器。
提示符前多出(agents-env)就说明隔离成功；Windows 用户没有 source 命令，改在 PowerShell 里执行agents-env\Scripts下的激活脚本即可。
第 3 步：按项目配置装齐依赖
pip install "datasets>=3.2.0" "huggingface-hub>=0.27.1" "ipykernel>=6.29.5" "requests>=2.32.3" pip install "smolagents[all]"四条核心包的版本号照抄自 quiz/pyproject.toml：datasets 管数据集、huggingface-hub 负责模型与文件下载、ipykernel 支撑 Jupyter 笔记、requests 处理网络请求；smolagents 是 Unit 1 教程要用的轻量 Agent 框架。每个包都显示 Successfully installed、终端没有红色报错，依赖就算装齐了。
跑一条体检命令，确认环境可用
✅
python -c "import datasets, huggingface_hub, ipykernel, requests; print('依赖就绪')"屏幕打印出依赖就绪，说明四个核心库全部导入成功。入口从 units/en/unit0/introduction.mdx 开始：注册账号、加入社区，然后按 Unit 1 → 2 → 3 → 4 推进，终点是在 Unit 4 的 GAIA 基准评测里拿认证；英文吃力就切到 units/zh-CN/ 看中文翻译。
三个高频卡点的处理办法
⚠️现象：pip install提示 requires Python >=3.11原因：系统默认 Python 版本过低处理：装 3.11+ 的解释器后重建虚拟环境，把第 2 步命令里的python换成python3.11
现象：source: command not found原因：在 Windows CMD 里用了 Linux/macOS 语法处理：换 PowerShell，执行agents-env\Scripts\Activate.ps1
现象：pip 下载长时间卡在某个百分比原因：直连 PyPI 速度慢处理：给 pip install 加-i参数，临时切换到国内镜像源
今天就能做的两件事
- 打开 units/en/unit0/introduction.mdx，按引导完成账号注册与社区加入；
- 接着看 units/en/unit1/tutorial.mdx，用 smolagents 写出你的第一个 Agent，让这套环境立刻派上用场。
【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
