☰
小白程序员必看:用Python打造你的第一个大模型Agent(收藏版)
2026/10/8 6:56:27 网站建设 项目流程

本文深入浅出地介绍了大模型Agent的核心原理,强调Agent的本质是“LLM+Tools+Loop”。通过构建一个简单的Python Agent实例,详细阐述了如何利用工具定义、模型决策、工具执行和循环终止这四大机制,让模型能够实现多步判断和外部动作。文章建议新手先掌握原生API编程,再逐步学习框架,并提供了三个进阶练习,帮助读者巩固对Agent机制的理解。

很多人第一次接触 Agent,是从 LangChain、CrewAI、AutoGen 开始。框架文档里 Chain、Tool、Memory、Planner 一堆抽象,很容易让人觉得:Agent 很复杂,必须先学框架。

其实把框架剥开,底层逻辑就三件事:LLM 负责思考,工具负责行动,循环负责持续推进。

即:Agent = LLM + Tools + Loop。

理解这个公式,比背任何框架 API 都重要。框架会变,机制不会。下面用最小 Python Agent 把循环跑起来。

  1. Agent 到底是什么?

普通 LLM 调用是一次性的:用户提问,模型回答,结束。Agent 多了”行动循环”:

  1. LLM 读取用户问题和当前状态;

  2. LLM 判断是否需要工具;

  3. 如果需要,程序执行工具并把结果返回给 LLM;

  4. LLM 基于新结果继续判断;

  5. 直到模型认为任务完成,输出最终答案。

这个模式常称 ReAct:Reasoning + Acting。先推理,再行动,再观察结果,继续推理。

图1:Agent 循环流程图——用户输入进入 LLM,LLM 要么直接回答,要么调用工具;工具结果回传 LLM 继续思考,直到输出最终答案

什么时候需要 Agent? 任务需要”多步判断 + 外部动作”时,如查资料、算数、调接口、读文件。只做改写、摘要、分类,普通 LLM 调用就够。

  1. 用 Python 写一个最小 Agent

示例用 Anthropic Claude API 的tool_use。OpenAI function calling 同一套思想:定义工具 → 模型选工具 → 程序执行 → 结果回传。

先安装依赖,通过环境变量设置 Key(不要写进代码):

pip install anthropic export ANTHROPIC_API_KEY="你的_API_Key"

2.1 定义工具

工具不是函数本身,而是给模型看的"能力说明书":工具叫什么、能做什么、需要哪些参数。

import re import anthropic client = anthropic.Anthropic() tools = [{ "name": "calculator", "description": "计算简单数学表达式,只支持数字、加减乘除和括号。", "input_schema": { "type": "object", "properties": { "expression": { "type": "string", "description": "数学表达式,例如 123 * 456 + 789" } }, "required": ["expression"] } }]

工具描述越清楚,模型越容易选对。这里只放一个计算器,方便看懂完整链路。

2.2 执行工具

模型不会真的执行代码。它只提出”我要调 calculator,参数是 x”。真正执行的是你的 Python 程序。

def run_tool(name: str, args: dict) -> str: if name != "calculator": return"未知工具" expr = args["expression"] ifnot re.fullmatch(r"[0-9+/-*/(). ]+", expr): return"表达式包含不允许的字符" try: return str(eval(expr, {"__builtins__": {}}, {})) except Exception as e: returnf"计算失败:{e}"

这里用白名单限制字符。生产环境更建议用专门数学解析库,别让模型生成内容直接进入高权限执行环境。

2.3 写 Agent 循环

核心就是一个for循环:请求模型 → 检查工具调用 → 执行工具 → 结果塞回历史 → 再请求模型。

def agent(user_input: str, max_steps: int = 5) -> str: messages = [{"role": "user", "content": user_input}] for _ in range(max_steps): response = client.messages.create( model="claude-opus-4-8", max_tokens=1024, tools=tools, messages=messages, ) messages.append({"role": "assistant", "content": response.content}) if response.stop_reason != "tool_use": return"".join( block.text for block in response.content if block.type == "text" ) tool_results = [] for block in response.content: if block.type == "tool_use": result = run_tool(block.name, block.input) tool_results.append({ "type": "tool_result", "tool_use_id": block.id, "content": result, }) messages.append({"role": "user", "content": tool_results}) return"达到最大循环次数,Agent 停止。" print(agent("123 乘以 456 再加上 789 等于多少?"))

典型运行:用户提问 → LLM 判断需要计算器 → 生成工具调用calculator({"expression":"123*456+789"})→ Python 执行得56877→ 结果回传 LLM → LLM 输出自然语言答案。

图2:Agent 运行过程——LLM 思考"需要计算器"→ 调用 calculator → 工具返回 56787 → LLM 组织最终回答

注意:图中示例数值用于展示流程;如果你换表达式,结果以程序实际计算为准。

什么时候用这个最小版? 学原理、验证工具调用、做内部小工具。还不适合直接上生产——缺权限控制、日志、重试、上下文管理和人工确认。

  1. 拆开看:Agent 的 4 个关键机制

机制一:工具定义

工具定义就是 LLM 的“工具菜单”。模型根据name、description和参数 schema 判断能不能用、该不该用、怎么传参。

坑点: 工具描述太泛会导致误选。例如“处理数据”不如“计算数学表达式并返回结果”。工具越多,描述越要互斥。

什么时候用: 只要模型需要访问外部世界——数据库、文件、接口、搜索、计算——就要定义工具。

机制二:模型决策

Agent 不是你硬编码“先调 A,再调 B”。LLM 会根据问题和工具列表自己决定下一步。这是 Agent 相比普通脚本最大的区别。

什么时候用: 路径不固定时用 Agent;路径固定时用普通代码编排更稳定、更便宜。

机制三:工具执行

LLM 只负责“提出动作”,程序负责“执行动作”。这个边界很重要:工具权限、参数校验、失败处理,都应该在你控制的代码里完成。

什么时候用: 永远如此。不要让模型直接执行任意 shell、SQL 或高权限 API。

机制四:循环终止

stop_reason == "tool_use"表示模型还想行动;否则说明它准备回答。除此之外,还要加max_steps,防止无限循环。

什么时候用: 所有 Agent 都必须有循环上限。没有上限,成本和风险都会失控。

  1. 从最小 Agent 到实用 Agent

最小版本能说明原理,但实用 Agent 至少要补三层能力。

图3:从最简 Agent 到实用 Agent 的演进——补循环上限、补错误回传、补上下文管理

第一,循环上限。用max_steps控制最多执行几轮,避免模型在“搜索—总结—再搜索”里打转。

第二,错误回传。工具失败时不要吞错误,要把错误作为tool_result返回给模型。模型看见“参数不合法”或“接口超时”,才有机会换策略。

第三,上下文管理。每轮工具调用都会让消息历史变长。短任务可以直接保留全部历史;长任务要做截断、摘要或外部记忆,否则 token 会爆。

什么时候升级? 当 Agent 需要跑很多步、接多个工具、给多人使用,或者会触碰文件/数据库/生产系统时,就不能停留在教学版。

  1. 要不要用框架?

方案适合场景优点坑点
原生 API + 循环学原理、简单工具透明、好调试基建要自己补
LangChain快速原型、RAG生态大抽象多、版本变化快
CrewAI多角色协作任务组织清晰简单任务容易过度设计
AutoGen多 Agent 对话适合研究协作模式调试链路长

建议路线:先写原生 Agent,搞懂 LLM + Tool + Loop;再学框架。 否则框架出错时,你分不清是模型没选对工具、schema 写错、工具执行失败,还是框架封装层的问题。

  1. 继续练习

如果你想继续深入,做三个小练习:

  1. 加一个read_file工具,让 Agent 能读本地文件;

  2. 加一个search工具,让 Agent 能查外部资料;

  3. 把messages保存到文件里,实现最简单的记忆。

做完这三个练习,你就真正理解了 Agent 的基本机制:模型负责决策,工具负责行动,循环负责推进,边界负责安全。

如何学习大模型 AI ?

由于新岗位的生产效率,要优于被取代岗位的生产效率,所以实际上整个社会的生产效率是提升的。

但是具体到个人,只能说是:

“最先掌握AI的人,将会比较晚掌握AI的人有竞争优势”。

这句话,放在计算机、互联网、移动互联网的开局时期,都是一样的道理。

我在一线互联网企业工作十余年里,指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家,也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑,所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限,很多互联网行业朋友无法获得正确的资料得到学习提升,故此将并将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

这份完整版的大模型 AI 学习资料已经上传CSDN,朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

为什么要学习大模型?

我国在A大模型领域面临人才短缺,数量与质量均落后于发达国家。2023年,人才缺口已超百万,凸显培养不足。随着AI技术飞速发展,预计到2025年,这一缺口将急剧扩大至400万,严重制约我国AI产业的创新步伐。加强人才培养,优化教育体系,国际合作并进是破解困局、推动AI发展的关键。

大模型入门到实战全套学习大礼包

1、大模型系统化学习路线

作为学习AI大模型技术的新手,方向至关重要。 正确的学习路线可以为你节省时间,少走弯路;方向不对,努力白费。这里我给大家准备了一份最科学最系统的学习成长路线图和学习规划,带你从零基础入门到精通!


2、大模型学习书籍&文档

学习AI大模型离不开书籍文档,我精选了一系列大模型技术的书籍和学习文档(电子版),它们由领域内的顶尖专家撰写,内容全面、深入、详尽,为你学习大模型提供坚实的理论基础。

3、AI大模型最新行业报告

2025最新行业报告,针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估,以了解哪些行业更适合引入大模型的技术和应用,以及在哪些方面可以发挥大模型的优势。

4、大模型项目实战&配套源码

学以致用,在项目实战中检验和巩固你所学到的知识,同时为你找工作就业和职业发展打下坚实的基础。

5、大模型大厂面试真题

面试不仅是技术的较量,更需要充分的准备。在你已经掌握了大模型技术之后,就需要开始准备面试,我精心整理了一份大模型面试题库,涵盖当前面试中可能遇到的各种技术问题,让你在面试中游刃有余。

适用人群

第一阶段(10天):初阶应用

该阶段让大家对大模型 AI有一个最前沿的认识,对大模型 AI 的理解超过 95% 的人,可以在相关讨论时发表高级、不跟风、又接地气的见解,别人只会和 AI 聊天,而你能调教 AI,并能用代码将大模型和业务衔接。

  • 大模型 AI 能干什么?
  • 大模型是怎样获得「智能」的?
  • 用好 AI 的核心心法
  • 大模型应用业务架构
  • 大模型应用技术架构
  • 代码示例:向 GPT-3.5 灌入新知识
  • 提示工程的意义和核心思想
  • Prompt 典型构成
  • 指令调优方法论
  • 思维链和思维树
  • Prompt 攻击和防范
  • …
第二阶段(30天):高阶应用

该阶段我们正式进入大模型 AI 进阶实战学习,学会构造私有知识库,扩展 AI 的能力。快速开发一个完整的基于 agent 对话机器人。掌握功能最强的大模型开发框架,抓住最新的技术进展,适合 Python 和 JavaScript 程序员。

  • 为什么要做 RAG
  • 搭建一个简单的 ChatPDF
  • 检索的基础概念
  • 什么是向量表示(Embeddings)
  • 向量数据库与向量检索
  • 基于向量检索的 RAG
  • 搭建 RAG 系统的扩展知识
  • 混合检索与 RAG-Fusion 简介
  • 向量模型本地部署
  • …
第三阶段(30天):模型训练

恭喜你,如果学到这里,你基本可以找到一份大模型 AI相关的工作,自己也能训练 GPT 了!通过微调,训练自己的垂直大模型,能独立训练开源多模态大模型,掌握更多技术方案。

到此为止,大概2个月的时间。你已经成为了一名“AI小子”。那么你还想往下探索吗?

  • 为什么要做 RAG
  • 什么是模型
  • 什么是模型训练
  • 求解器 & 损失函数简介
  • 小实验2:手写一个简单的神经网络并训练它
  • 什么是训练/预训练/微调/轻量化微调
  • Transformer结构简介
  • 轻量化微调
  • 实验数据集的构建
  • …
第四阶段(20天):商业闭环

对全球大模型从性能、吞吐量、成本等方面有一定的认知,可以在云端和本地等多种环境下部署大模型,找到适合自己的项目/创业方向,做一名被 AI 武装的产品经理。

  • 硬件选型
  • 带你了解全球大模型
  • 使用国产大模型服务
  • 搭建 OpenAI 代理
  • 热身:基于阿里云 PAI 部署 Stable Diffusion
  • 在本地计算机运行大模型
  • 大模型的私有化部署
  • 基于 vLLM 部署大模型
  • 案例:如何优雅地在阿里云私有部署开源大模型
  • 部署一套开源 LLM 项目
  • 内容安全
  • 互联网信息服务算法备案
  • …

学习是一个过程,只要学习就会有挑战。天道酬勤,你越努力,就会成为越优秀的自己。

如果你能在15天内完成所有的任务,那你堪称天才。然而,如果你能完成 60-70% 的内容,你就已经开始具备成为一名大模型 AI 的正确特征了。

这份完整版的大模型 AI 学习资料已经上传CSDN,朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询