尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
如何 30 分钟跑通 AI 智能体:基于 Agents Course 的 ReAct 循环原理拆解与实战步骤
如何 30 分钟跑通 AI 智能体基于 Agents Course 的 ReAct 循环原理拆解与实战步骤【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-courseHuggingFace Agents Course 帮 Python 开发者补齐了 AI 智能体开发最缺的一环从零搞懂智能体内部机制再亲手搭出一个能调工具的可用智能体。这个开源仓库就是该课程的完整教材从概念讲到框架最后用基准测试收尾。本文带你看懂它最核心的思考-行动-观察循环并用 smolagents 跑通一个带时区查询工具的智能体。动手前先准备先备齐四样东西后面全程不会卡住Python 3.9 及以上环境装好huggingface_hub、smolagents、pytz三个库一个 Hugging Face 账号并在设置页生成 read 权限的 API token后续调用推理接口要用把课程仓库 clone 到本地git clone https://gitcode.com/GitHub_Trending/ag/agents-course浏览器里预留 30 分钟代码会在真实模型接口上运行可选会读 units/zh-CN/ 下的中文课程内容遇到名词可以随手查它到底是怎么工作的核心结论一句话模型只负责说框架负责做两者靠一段循环咬合起来。用一个类比建立直觉。模型像管家 Alfred 的脑子能想事但出不了书房门smolagents 这类框架是管家的腿脚负责跑腿工具则是书房外的电话、日历、搜索引擎。脑子的产出始终是文字跑腿和拨电话的事全由框架代劳。拆成 5 个要点工具就是一个 Python 函数。它和普通函数唯一的不同是额外携带一份契约名字、功能描述、参数类型、返回类型。框架把契约写进系统提示。模型靠读这段文本才知道有哪些工具可用、参数怎么传这是全部秘密的第一半。模型输出的仍然是文本。它生成一段 Python 代码或 JSON 结构而不是真的调用任何东西。框架执行这段代码拿到返回值把结果作为观察Observation即工具的执行反馈追加回对话再发回模型。整个过程是个 while 循环。模型每轮基于最新观察重新决策直到给出最终答案或触达步数上限。这个循环就叫 ReAct 循环是 Reasoningacting 的合称。想看完整推导读 units/zh-CN/unit1/agent-steps-and-structure.mdx 里 Alfred 查天气的逐步演示即可。跟着跑一遍下面的小任务搭一个能回答东京现在几点的智能体。全程三段代码每段都在解决循环里的一个零件。先登录模型接口token 换成你自己的from huggingface_hub import login login()接着定义工具。注意两个细节参数要有类型注解文档字符串要写清每个参数的用途——框架靠这两样自动生成给模型看的工具描述。from smolagents import tool import datetime import pytz tool def get_time_in_timezone(timezone: str) - str: 查询指定时区的当前时间。 Args: timezone: IANA 时区名如 Asia/Tokyo tz pytz.timezone(timezone) return datetime.datetime.now(tz).strftime(%Y-%m-%d %H:%M:%S)然后组装智能体。CodeAgent是 smolagents 的默认类型模型每轮输出一段 Python 代码框架执行后把结果交还。from smolagents import CodeAgent, InferenceClientModel agent CodeAgent( tools[get_time_in_timezone], modelInferenceClientModel(), max_steps5, )最后发起任务agent.run(现在东京是几点)控制台会打印每一步的追踪模型先生成代码print(get_time_in_timezone(Asia/Tokyo))框架执行它时间字符串回到模型手里模型再输出 Final Answer。整个思考-行动-观察循环你刚才已经亲眼跑通一遍。工具定义的完整写法在 units/zh-CN/unit1/tools.mdx。进阶玩法两条路线各点一下换一种动作格式ToolCallingAgent让模型输出 JSON 而非代码适合不需要变量处理的简单场景对比见 unit2/smolagents/tool_calling_agents.mdx换一种控制方式流程固定时改用 LangGraph 的有向图比自由循环更可控入口在 units/zh-CN/unit2/langgraph/做完 unit4 的 GAIA 基准项目还能拿到带评分的结业认证容易踩的坑工具参数没写类型注解→ 现象是模型传的参乱七八糟、工具频繁报错。原因是框架用 Python 自省自动生成工具描述缺注解它就只能猜。解法每个参数补上: str、- str这类注解返回类型也别省。文档字符串只有一句功能描述→ 现象是模型不知道什么时候该调用你的工具或把参数填错。原因是模型判断工具的唯一依据就是这段描述。解法在Args:下逐个参数写清用途参考上面时区工具的写法。免费推理接口偶发超时或过载→ 现象是同一份代码时好时坏。原因是公共端点排队与你的代码无关。解法换个模型重试并用max_steps控制循环轮数避免反复烧额度。收尾整篇的核心就一条链路模型生成文本、框架执行工具、结果回灌成观察、循环直到出答案——理解了这条链路换任何框架都是同样的零件。想继续深入按 units/zh-CN/ 的单元顺序走unit1 吃透 ReAct 循环unit2 横向对比三个框架unit3 实战 Agentic RAGunit4 上 GAIA 基准。【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

TVA具身架构范式创新:增强具身智能开放域泛化能力

TVA具身架构范式创新:增强具身智能开放域泛化能力

前沿技术探索:TVA智能体(简称TVA)TVA智能体(亦称“AI智能体视觉”或“TVA视觉智能体”)是依托Transformer架构与“因式智能体”理论构建的通用视觉技术体系。它有机融合深度强化学习(DRL)、卷积…

📅 2026/11/8 14:56:50
微信群机器人只有被@才回怎么做

微信群机器人只有被@才回怎么做

1. 引言 微信群里一开自动回复,闲聊也会被插话。微信群机器人更稳的策略是:只有被 才回,没点名就静音。个人号在群里当机器人用时,尤其需要这条规则。 本文将围绕「微信群机器人只有被才回怎么做」写判断和短答。GeWe API 会把…

📅 2026/11/7 22:32:49
AI编程智能体的时间盲区:如何补上时间感知能力

AI编程智能体的时间盲区:如何补上时间感知能力

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/10/24 20:06:12
MORE NEWS

更多资讯

📰

金华电工证年审地点怎么报名,怎么避坑

金华电工证年审地点怎么报名,怎么避坑 你是不是正愁不知道去哪里报名金华电工证年审,又怕被中介骗钱?别急,这篇文章能帮你把关,确保你走对路、不花冤枉钱。 金华电工证年审地点怎么报名…

📰

电工作业考试习题集多少钱?怕考不过白交培训费?这份攻略帮你省事又省钱

电工作业考试习题集多少钱?怕考不过白交培训费?这份攻略帮你省事又省钱 你是不是正在为电工作业考试发愁?怕考不过白交培训费?别急,我这有份 电工作业考试习题集 ,帮你少走弯路, 多少钱…

📰

电工作业考试习题集怎么选?良心建议帮你避坑

电工作业考试习题集怎么选?良心建议帮你避坑 你是不是也遇到过这种情况:想考电工作业证,网上一搜全是培训机构,价格五花八门,不知道哪家靠谱,怕被坑?别急,这篇文章就是为你量身打造的【电工作业考试习题集】良心建议,帮你从报名到考试一网打尽,少走…

📰

架子工属于特种工人吗 电子证书怎么考怎么用

架子工属于特种工人吗 电子证书怎么考怎么用 你是不是也在纠结: 架子工属于特种工人吗 ?报名时不知道去哪,怕被中介坑?别急,我从业这么多年,见过太多同行走弯路,今天就把这事儿讲明白。 电子证书…

📰

菏泽电工证查询网保姆级教程:学历不高也能考电工证,别被门槛吓退

菏泽电工证查询网保姆级教程:学历不高也能考电工证,别被门槛吓退 学历不高怕报不上名?别急,今天给你讲清楚菏泽电工证查询网怎么用,以及电工证到底值不值得考,别被那些“必须大专以上才能报名”的话骗了,…

📰

工地太忙根本没时间复习考试,国防电工证查询多久拿证全攻略

工地太忙根本没时间复习考试,国防电工证查询多久拿证全攻略 工地太忙根本没时间复习考试,你是不是也经常在工地上忙得连吃饭时间都没有?更别说腾出时间来备考特种作业证了。尤其是 国防电工证查询…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬