1. 为什么我不建议新手一上来就啃框架

1.1 一个让我印象深刻的真实案例

去年年底，有个做运营的朋友找我，说想转行做 AI Agent 开发。他花了整整两周时间，跟着网上的教程把 LangChain 的文档从头到尾啃了一遍，Chain、Agent、Tool、Memory 这些概念背得滚瓜烂熟。结果我让他做一个最简单的需求——读取一个本地 Markdown 文件，调用大模型总结成摘要，再输出成 Word 文档——他卡了三天没做出来。

问题出在哪？不是他笨，而是他把顺序搞反了。LangChain 这类框架本质上是对底层 API 调用的封装，它帮你处理了消息格式、工具调用协议、上下文管理这些繁琐的事情。但如果你连“一次大模型调用到底发生了什么”都没搞清楚，直接去看框架源码，就像还没学会走路就去研究跑步的力学原理，越看越迷糊。

我后来让他先把 LangChain 放一边，用最原始的 HTTP 请求方式，手动构造 messages 数组，手动解析返回的 JSON，手动实现一个“如果模型说要调用工具，我就去执行对应函数再把结果塞回去”的循环。三天之后他回来跟我说：“原来 Agent 就是这么回事啊。”

这就是我想在这篇博文里说清楚的事情：AI Agent 入门，先学什么、后学什么，顺序比努力更重要。

1.2 这篇内容适合谁看

如果你属于以下几类人，这篇内容应该能帮你少走不少弯路：

• 完全零基础的新手：听说过 AI Agent，想学但不知道从哪下手，面对 Coze、Dify、LangChain 这些名字一脸懵。
• 想转行的开发者：有编程基础，但对 AI 应用开发不熟悉，不知道该补哪些知识。
• 产品/运营岗想了解技术边界：不一定要自己写代码，但需要知道 Agent 能做什么、不能做什么，方便和开发沟通。
• 已经在用 Coze 或 Dify 但感觉遇到瓶颈的人：拖拽玩得很溜，但一旦需要自定义逻辑就不知道怎么办了。

我会从“最小知识集”开始讲起，然后逐步过渡到工具选型、实操搭建、常见坑排查。整个过程我会尽量用大白话，配合我自己踩过的坑和实际项目中的经验，让你看完就能动手。

1.3 先搞清楚：AI Agent 到底是什么

在讨论学什么之前，得先把概念理清楚。很多人把 AI Agent 和“聊天机器人”混为一谈，其实差别很大。

普通的聊天机器人，你问它一句它答一句，它不会主动做任何事情。而 AI Agent 的核心特征是它能自己决定下一步做什么。你给它一个目标，它会拆解任务、选择工具、执行操作、根据结果调整策略，直到完成任务或者判断无法完成。

举个具体的例子。你对着一个聊天机器人说“帮我查一下明天北京的天气”，它可能直接告诉你“我无法获取实时天气信息”。但一个 Agent 会这样做：它先判断需要调用天气查询工具，然后构造查询参数，调用 API 拿到结果，再把结果整理成自然语言回复你。如果第一次调用失败了，它还会尝试换一个工具或者调整参数重试。

这个“判断-调用-观察-再判断”的循环，就是 Agent 的核心工作机制。理解了这个循环，你就理解了 Agent 的本质。后面要学的所有框架、平台、工具，本质上都是在帮你更高效地实现这个循环。

提示：如果你现在对“大模型 API 调用”还没有概念，建议先花半天时间，用 Python 的 requests 库手动调用一次大模型接口，看看请求体和响应体长什么样。这一步的体验非常关键。

2. 新手的最小知识集：别贪多，先掌握这四样

2.1 Python 基础：不需要精通，但得能读写

我知道很多人一听到“学 Python”就头大，觉得要学完整个语言才能开始做 Agent。完全不需要。你只需要掌握以下这些就够了：

• 变量和基本数据类型：字符串、数字、列表、字典。特别是字典，因为大模型 API 的请求和响应都是 JSON 格式，在 Python 里就是字典嵌套。
• 函数定义和调用：你需要把每个“工具”写成一个函数，Agent 才能调用它。
• 条件判断和循环：Agent 的核心循环就是 while 循环加 if-else 判断。
• 文件读写：读取配置文件、保存输出结果。
• 安装和使用第三方库：pip install 和 import，就这么简单。
• 异常处理：try-except，因为 API 调用随时可能失败。

这些内容，如果每天花两小时，一周之内绝对能掌握。不需要去看什么“Python 从入门到精通”的厚书，直接找一个交互式的教程网站，边学边敲代码就行。

我个人的建议是：不要单独学 Python，而是带着一个具体的小目标去学。比如“我要写一个程序，读取一个 txt 文件，调用大模型 API 总结内容，然后把结果保存到另一个文件”。在这个目标驱动下，你遇到什么语法就学什么，效率比系统学习高得多。

2.2 大模型 API 调用：Agent 的基石

这是最核心的一环。不管你后面用 Coze、Dify 还是 LangChain，底层都是在调用大模型 API。你需要理解以下几个概念：

消息角色（Role）：大模型 API 通常接受一个 messages 数组，里面每条消息有一个 role 字段。常见的 role 有：

• system：系统提示词，用来设定模型的行为和身份。
• user：用户输入的内容。
• assistant：模型之前的回复。
• tool：工具调用的结果（不同厂商叫法可能不同）。

Token 是什么：Token 是大模型处理文本的基本单位。你可以粗略理解为“一个汉字约等于 1-2 个 token，一个英文单词约等于 1 个 token”。API 通常按 token 数量计费，也有上下文长度限制。比如一个模型支持 8K 上下文，意思是你发送的所有消息加上模型回复的总 token 数不能超过 8192。

温度（Temperature）：控制模型输出的随机性。温度越低（接近 0），输出越确定、越保守；温度越高（接近 1 或更高），输出越随机、越有创造性。做 Agent 的时候，通常需要模型稳定地输出结构化内容，所以温度一般设得比较低。

函数调用（Function Calling）：这是 Agent 的关键能力。你可以在 API 请求中定义一组“工具”，每个工具有名称、描述和参数 schema。模型在回复时，如果判断需要调用某个工具，它会返回一个结构化的工具调用请求，而不是普通文本。你的代码解析这个请求，执行对应的函数，把结果再发回给模型，模型继续处理。

我强烈建议你在学任何框架之前，先手动实现一次完整的函数调用流程。这个过程会让你对 Agent 的理解深入一个层次。

2.3 HTTP 请求与 JSON：数据交换的基本功

Agent 开发中，你几乎每天都在和 HTTP 请求、JSON 数据打交道。你需要知道：

• GET 和 POST 请求的区别。
• 请求头（Headers）里通常要放什么，比如 Content-Type、Authorization。
• 如何用 Python 的 requests 库发送请求。
• JSON 的基本结构：对象（字典）、数组（列表）、嵌套。
• 如何解析响应中的嵌套 JSON，取出你需要的数据。

这些知识不需要专门去学网络编程课程，直接在调用大模型 API 的过程中就掌握了。我第一次调通 API 的时候，花了两个小时才搞明白 Authorization 头部的格式是Bearer sk-xxxxx，中间那个空格不能少。这种细节，只有亲手试过才知道。

2.4 提示词工程：让模型按你的意图工作

提示词工程不是玄学，它是有规律可循的。对于 Agent 开发来说，你至少需要掌握：

• 角色设定：在 system 消息中明确告诉模型它是谁、要做什么、有什么限制。
• 输出格式约束：要求模型以特定格式输出，比如 JSON、Markdown 表格等。
• 少样本示例：给模型几个输入输出的例子，它就能更好地理解你的意图。
• 思维链引导：让模型在给出最终答案之前，先展示推理过程，能显著提高复杂任务的准确率。

我自己的经验是：Agent 的效果，七分靠提示词，三分靠模型能力。同样一个模型，提示词写得好和写得差，效果差距可能是天壤之别。所以不要急着去学框架的高级功能，先把提示词写好。

3. 工具选型：Coze、Dify、LangChain 到底怎么选

3.1 先看一张对比表

这张表不是绝对的，但能帮你快速定位自己该从哪个工具开始。

3.2 我的建议：分阶段选择

如果你是完全零基础，我建议从 Coze 开始。原因很简单：它能让你在最短时间内看到一个 Agent 跑起来的样子。你不需要写任何代码，只需要配置好人设、添加几个插件、设计好工作流，就能做出一个能用的东西。这个正反馈非常重要，它能让你保持学习的动力。

但 Coze 的局限性也很明显。当你想实现一些平台不支持的功能时，就会卡住。比如你想在 Agent 中调用一个自己写的 Python 脚本处理数据，Coze 的自定义能力就比较有限。

这时候就该上Dify了。Dify 介于 Coze 和 LangChain 之间，它既有可视化的编排界面，又支持自定义代码节点和外部 API 接入。你可以把它理解为一个“低代码的 Agent 开发平台”。Dify 支持本地部署，数据安全性更好，适合企业内部使用。

LangChain则是给那些需要深度定制的人准备的。当你发现 Dify 的抽象层反而限制了你的发挥，或者你需要把 Agent 能力嵌入到一个已有的 Python 项目中时，LangChain 就是更好的选择。但它的学习成本确实高，你需要理解它的各种抽象概念：Chain、Agent、Tool、Memory、Retriever 等等。

提示：不要同时学多个工具。选一个，用它做出一个完整的东西，然后再学下一个。我见过太多人同时开三个教程，最后哪个都没学完。

3.3 关于“学 Coze 是不是智商税”这个问题

网上经常有人讨论“学 Coze 是不是智商税”。我的看法是：取决于你的目标。

如果你的目标是快速搭建一个能用的 Agent，解决手头的实际问题，那 Coze 是非常高效的工具，完全不是智商税。但如果你把 Coze 当作唯一技能，指望靠它去找一份 Agent 开发的工作，那确实不够。因为企业级应用通常需要更深度的定制能力，Coze 的封闭性会成为瓶颈。

我的建议是：把 Coze 当作入门工具，用它建立对 Agent 的直观认知，然后逐步向 Dify 和 LangChain 过渡。这三者不是互斥的，而是递进的关系。

4. 实操：从零搭建一个能用的 Agent

4.1 需求定义：先想清楚要解决什么问题

很多人一上来就问“怎么搭建 Agent”，但连自己要解决什么问题都没想清楚。我的习惯是先用一句话描述需求，然后拆解成具体的输入和输出。

比如，我想做一个“Markdown 转 Word 工作流”。这句话太模糊了。具体化之后应该是：

• 输入：一个 Markdown 格式的文本文件。
• 处理：解析 Markdown 内容，保留标题、列表、表格、代码块等格式。
• 输出：一个 Word 文档，格式与 Markdown 对应。

再比如“让小红书自动发消息”这个需求，拆解后是：

• 输入：一条消息内容和一个目标用户。
• 处理：打开小红书应用，找到目标用户，发送消息。
• 输出：发送成功的确认。

把需求拆解到这个程度，你才能判断哪些环节可以用 Agent 做，哪些环节需要其他工具配合。

4.2 用 Coze 搭建一个简单工作流

假设我们要做一个“每日新闻摘要”Agent。流程是：定时触发 → 抓取新闻 → 调用大模型总结 → 推送到指定渠道。

在 Coze 中，这个流程可以这样搭建：

第一步：创建工作流。在 Coze 的工作流界面中，新建一个工作流，给它起个名字，比如“daily_news_summary”。

第二步：添加触发节点。Coze 支持定时触发，你可以设置每天早上 8 点执行。

第三步：添加数据抓取节点。使用 Coze 内置的 HTTP 请求插件，或者自己配置一个 API 调用，从新闻源获取数据。这里需要注意：抓取到的数据通常是 JSON 格式，你需要用 Coze 的代码节点或者变量提取功能，把新闻标题和内容提取出来。

第四步：添加大模型节点。把提取到的新闻内容作为输入，配置提示词，让模型生成摘要。提示词可以这样写：

你是一个新闻摘要助手。请将以下新闻内容总结成 3-5 条要点，每条不超过 50 字。 新闻内容： {{news_content}}

第五步：添加输出节点。把模型生成的摘要推送到指定渠道，比如飞书群、钉钉群或者邮件。

整个流程搭建下来，熟练的话半小时就能搞定。但有几个细节需要注意：

• 变量传递：Coze 的工作流中，节点之间的数据传递靠变量。你需要确保上一个节点的输出变量名和下一个节点的输入变量名一致。
• 错误处理：如果新闻源抓取失败怎么办？建议加一个条件判断节点，如果抓取结果为空，就跳过后续步骤或者发送告警。
• 测试运行：Coze 提供了测试运行功能，可以在正式启用前手动触发一次，看看每个节点的输出是否符合预期。

4.3 用 Dify 搭建一个知识库问答 Agent

Dify 的强项是知识库和 RAG（检索增强生成）。我们来做一个月子中心常见问题解答 Agent。

第一步：准备知识库文档。把月子中心的常见问题整理成 Markdown 或 PDF 文件。内容越结构化越好，比如按“饮食”、“护理”、“费用”等类别分节。

第二步：在 Dify 中创建知识库。上传文档，Dify 会自动进行分段和向量化。这里有一个关键参数：分段长度。分段太长，检索精度下降；分段太短，上下文不完整。我的经验是中文内容每段 300-500 字比较合适。

第三步：创建应用。选择“知识库问答”类型，关联刚才创建的知识库。

第四步：配置提示词。在系统提示词中告诉模型：你是一个月子中心的客服助手，根据知识库内容回答用户问题，如果知识库中没有相关信息，就如实告诉用户你不知道。

第五步：测试和调优。问一些知识库中有答案的问题，看看模型能否准确检索并回答。如果效果不好，可以调整检索的 Top-K 参数（即每次检索返回多少个片段），或者优化分段策略。

Dify 的知识库流水线还支持更高级的功能，比如多路召回、重排序等。这些可以在基础流程跑通之后再逐步优化。

4.4 用 LangChain 实现一个带工具调用的 Agent

如果你已经掌握了前面两个工具，想进一步深入，可以试试用 LangChain 手动实现一个 Agent。下面是一个简化版的代码框架：

from langchain_openai import ChatOpenAI from langchain.agents import tool, AgentExecutor, create_openai_tools_agent from langchain_core.prompts import ChatPromptTemplate # 定义工具 @tool def get_weather(city: str) -> str: """查询指定城市的天气""" # 这里调用真实的天气 API return f"{city}今天晴，温度 25 度" @tool def calculate(expression: str) -> str: """计算数学表达式""" return str(eval(expression)) # 初始化模型 llm = ChatOpenAI(model="gpt-4", temperature=0) # 定义提示词 prompt = ChatPromptTemplate.from_messages([ ("system", "你是一个有用的助手，可以调用工具来回答问题。"), ("human", "{input}"), ("placeholder", "{agent_scratchpad}"), ]) # 创建 Agent tools = [get_weather, calculate] agent = create_openai_tools_agent(llm, tools, prompt) agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True) # 运行 result = agent_executor.invoke({"input": "北京今天天气怎么样？顺便帮我算一下 23 乘以 47"}) print(result["output"])

这段代码看起来不长，但背后涉及的概念很多：工具定义、提示词模板、Agent 执行器、中间步骤记录。如果你在没有理解底层原理的情况下直接抄这段代码，一旦出错你根本不知道从哪里排查。

5. 常见问题与排查技巧实录

5.1 大模型 API 调用失败怎么办

这是新手遇到最多的问题。我把常见的错误和排查方法整理成了一张表：

我自己的经验是：90% 的 API 调用问题，都是 Key 的问题或者请求体格式的问题。遇到报错先检查这两个，能省很多时间。

5.2 Dify 部署中的典型坑

Dify 本地部署时，有几个坑我踩过：

SSL 错误：如果你在 Dify 前面加了反向代理，可能会遇到 SSL 证书验证失败的问题。解决方法是在 Dify 的环境变量中配置正确的证书路径，或者在内网环境中暂时关闭 SSL 验证（仅限测试环境）。

上下文超长：Dify 的工作流中，如果多个节点的输出累积起来超过了模型的上下文限制，就会报错。解决方法是：在关键节点后添加“变量截断”处理，或者使用 Dify 的“上下文管理”功能，只保留最近几轮对话。

迁移问题：Dify 的版本更新比较快，跨版本迁移时可能会遇到数据库结构不兼容的问题。建议在迁移前先备份数据库，并查看官方发布的迁移指南。

接入本地大模型：Dify 支持接入本地部署的大模型，但需要确保模型服务暴露了兼容 OpenAI 格式的 API 接口。如果模型本身不支持，可以加一层适配器转换。

5.3 Coze 工作流搭建中的注意事项

Coze 的工作流看起来简单，但有几个细节容易忽略：

• 文件上传处理：Coze 支持文件上传，但上传后的文件需要先解析成文本，才能被大模型处理。解析节点要放在大模型节点之前。
• 变量类型：Coze 的变量有类型区分，字符串和数字不能混用。如果类型不匹配，工作流会报错。
• 循环节点：如果需要对列表中的每一项执行相同操作，要用循环节点。循环体内的变量作用域和外部不同，需要注意。
• 调试技巧：Coze 的工作流支持单步调试，每个节点都可以单独运行查看输出。善用这个功能，能快速定位问题。

5.4 LangChain 学习中的常见困惑

LangChain 的抽象层次比较多，新手容易迷失。我的建议是：

• 先学 LCEL（LangChain Expression Language）：这是 LangChain 的新一代语法，用管道符|串联各个组件，比老的 Chain 类更直观。
• 理解 Runnable 协议：LangChain 中几乎所有组件都实现了 Runnable 接口，支持 invoke、batch、stream 等方法。理解了这个，你就理解了 LangChain 的设计哲学。
• 不要一上来就学 LangGraph：LangGraph 是 LangChain 生态中用于构建有状态、多步骤 Agent 的库。它很强大，但前提是你已经理解了基础的 Agent 循环。先用手动循环实现一遍，再用 LangGraph 重构，理解会深刻得多。
• 版本兼容性：LangChain 的版本更新非常快，不同版本之间的 API 可能有较大变化。看教程时一定要注意版本号，尽量以官方文档为准。

6. 学习路径与资源推荐

6.1 我建议的学习顺序

根据我自己的经验和带新人的经历，我整理了一个分阶段的学习路径：

第一阶段（1-2 周）：Python 基础 + 大模型 API 调用。目标是能手动写一个程序，调用大模型 API 完成简单的文本处理任务。

第二阶段（1 周）：提示词工程 + 函数调用。目标是能写出稳定的提示词，并手动实现一次完整的函数调用流程。

第三阶段（1-2 周）：Coze 或 Dify 入门。选一个平台，跟着官方教程做一个完整的 Agent。目标是理解 Agent 的工作流编排。

第四阶段（2-4 周）：LangChain 入门。用代码实现一个带工具调用的 Agent，理解框架的抽象设计。

第五阶段（持续）：根据实际需求深入学习。比如 RAG、多 Agent 协作、Agent 评估等。

这个路径不是绝对的，你可以根据自己的基础和需求调整。但核心原则是：先理解本质，再学工具；先跑通流程，再优化细节。

6.2 资源推荐

• Python 入门：找一个交互式学习网站，边学边练，不要只看视频。
• 大模型 API 文档：直接看官方文档，虽然有时候比较枯燥，但信息最准确。
• Coze 官方教程：Coze 的官方文档和模板库是最好的学习材料，多看别人做好的工作流。
• Dify 社区：Dify 的社区版有丰富的插件和模板，遇到问题可以在社区搜索。
• LangChain 官方文档：虽然更新快，但官方文档的示例代码质量很高，建议配合版本号阅读。

提示：不要收藏一堆教程然后吃灰。选一个，从头到尾跟完，做出一个能跑的东西，比收藏一百个教程都有用。

6.3 关于“AI Agent 主流架构”的理解

网上经常讨论“AI Agent 主流架构”，什么 ReAct、Plan-and-Execute、Multi-Agent 等等。我的看法是：新手不需要一上来就纠结架构。

ReAct 是最基础的架构，核心就是“推理-行动”循环。你手动实现的那个“判断-调用-观察-再判断”的循环，就是 ReAct 的简化版。Plan-and-Execute 是先制定计划再逐步执行，适合复杂任务。Multi-Agent 是多个 Agent 协作，适合需要不同专业能力的场景。

这些架构不是非此即彼的，实际项目中往往是混合使用。我的建议是：先把 ReAct 理解透，能手动实现，然后再去看其他架构。你会发现它们都是在 ReAct 的基础上做加减法。

7. 一些掏心窝子的经验

7.1 不要追求“完美准备”

我见过太多人，学 Agent 之前先花一个月学 Python，学完 Python 又花一个月学网络编程，学完网络编程又觉得需要先学算法……结果半年过去了，一行 Agent 代码都没写过。

正确的做法是：带着一个具体的小目标去学。比如“我要做一个能自动总结网页内容的 Agent”，然后缺什么补什么。Python 不会？学最基础的。API 不会调？看文档。提示词不会写？抄别人的改。在这个过程中，你的学习效率是最高的。

7.2 多动手，少看视频

看视频学习有一种“我在学习”的错觉，但实际上手写代码的时候，你会发现完全不是那么回事。一个标点符号的错误、一个缩进的问题，都能让你卡半天。但这些卡住你的地方，恰恰是你真正学到东西的地方。

我的习惯是：看十分钟教程，就停下来自己写二十分钟。遇到问题先自己排查，实在搞不定再搜索。这样学到的知识，印象最深。

7.3 建立自己的代码片段库

Agent 开发中有很多重复的模式：调用 API、解析 JSON、处理错误、构造提示词。我建议你从第一天开始，就把自己写过的、调试通过的代码片段保存下来，分类整理。下次遇到类似需求，直接复制粘贴改一改，效率能提高好几倍。

我用的是一个简单的 Markdown 文件，按功能分类，每个片段附上简短的说明和使用场景。这个习惯让我在后来做项目时省了大量时间。

7.4 关注成本，但不要被成本吓住

大模型 API 调用是要花钱的，但新手阶段的成本其实很低。以 GPT-4 为例，一次普通的对话调用可能就几分钱。你花几十块钱，就能做很多次实验了。

我的建议是：开发阶段用便宜的小模型调试流程，最终效果验证时再用大模型。很多模型厂商都提供了免费额度或者低价套餐，足够你学习和做 Demo 用了。

7.5 加入社区，但不要迷失在信息里

Agent 开发是一个快速发展的领域，每天都有新工具、新框架出现。加入社区能让你及时了解动态，但也容易让你焦虑——“别人都在用新东西了，我还在学旧的”。

我的经验是：关注核心概念，而不是工具本身。工具会变，但 Agent 的核心循环、提示词工程的基本原则、RAG 的基本流程，这些是不变的。把核心概念理解透了，新工具出来你花半天就能上手。

最后再分享一个小技巧：如果你在学 Coze 或 Dify 的过程中遇到了瓶颈，感觉拖拽解决不了问题，那正是你该去学 LangChain 的信号。不要硬扛，也不要放弃，顺着这个信号走，你会进入一个更广阔的天地。