智能体开发

Level 1: 提示词创建

先做一个角色明确、体验完整、能稳定对话的提示词型智能体

工具:Cherry Studio,豆包,讯飞星火,腾讯元器

编辑智能体:

  • 模型设置:模型温度:温度越高,输出的内容越有创意性。

level 2:当任务步骤固定时,用工作流更合适

任务步骤大致确定,希望过程可见、可控、可复用时,优先工作流。

level 3:在 平台里做更完整的平台智能体

对比维度Coze(扣子)Difyn8n
平台定位更偏零代码智能体与内容应用平台更偏大模型应用开发平台更偏通用自动化与流程编排平台
适用用户零技术背景的个人、小团队、自媒体运营者开发者、技术团队、需要定制化 AI 的企业开发者和需要复杂自动化的企业
核心优势上手快、模板多、发布方便、字节生态联动明显工作流、知识库、API、私有化与企业化能力更强集成能力强、节点多、开源程度高
学习曲线较高
扩展性有限(主要依赖预设模板和插件)中等(支持自定义模型和外部工具)极强(400+节点,支持代码自定义)
部署方式支持云端托管和私有化部署支持云端和私有化部署支持自托管和云端部署
成本免费版+积分制付费套餐免费版+分层付费计划完全开源,自托管只需服务器费用
趋势不错的使用体验,个人用户增长迅速在企业用户中的影响力不断扩大在企业级市场保持着稳定的用户基础

优点与缺点分析:

  • Coze 的优缺点:

    • Coze 的最大优点是上手极其简单,提供 100+预制模板,无需编写代码就能快速搭建 AI 应用。它与字节系产品(抖音、飞书等)深度集成,一键发布到多个平台。免费版提供基础功能,试错成本低。
    • Coze 的局限性在于功能较浅,复杂逻辑难以实现。数据云端存储(虽支持私有化部署,但插件开发者生态仍闭源私有化部署版本不如云托管版本易用) ,对企业数据安全有顾虑。深度集成能力弱于 n8n 和 Dify。
  • Dify 的优缺点:

    • Dify 的突出优势在于大模型应用开发能力强,内置多种模型接口和 RAG 框架。提供企业级功能如多模型热切换、权限管理和操作审计。在低代码和高扩展性之间取得了良好平衡。
    • Dify 的缺点是模型调用成本较高,依赖第三方 API 付费接口。对非技术用户仍有一定门槛,需理解“向量数据库”等概念。
  • n8n 的优缺点:

    • n8n 的核心优势是开源免费且数据完全自主,满足严格合规需求。拥有强大的集成能力,支持 400+预建节点,几乎可以连接任何系统。可视化+代码双模式兼顾易用性与扩展性。
    • n8n 的主要缺点是学习门槛较高,需要理解 API 概念和工作流逻辑。中文资源相对较少,深度功能需参考英文文档。

你可能会问:Coze 和 Dify 先学哪个? 若你零代码、想最快做出能发布的智能体(如豆包/飞书一键发布),优先跟 Coze;若你有一点开发基础、更在意企业级功能或本地部署,可优先 Dify。两者思路一致(提示词 + 工具/插件 + 知识库),学完一个再学另一个会很快。

1. Coze

工作空间:展示已开发的智能体或资源库列表,用户可在该平台上创建、配置和管理聊天机器人与智能体。 模板:提供大量可复制的模板,部分模板收费。 商店:展示平台上其他用户开发的项目,以及开发时可用的各种插件(如联网、爬虫、股票分析等)。 基本步骤

  1. 创建智能体
  2. 填写提示词
  3. 模型参数调整/使用插件/使用变量(需要将交互的数据记录下来)
  4. 设置开场白和预设问题/使用知识库/使用数据库/长期记忆/文件盒子

2. Dify

一个开源的大语言模型(LLM)应用开发平台,为 AI Agent 提供了 50 多种内置工具,如谷歌搜索、DALL·E、Stable Diffusion 和 WolframAlpha 等。

它的具体功能如下: 基于Agent架构构建智能体应用 基于RAG构建私有知识库应用 基于Workflow构建智能工作流应用

Dify 可以本地化部署,保证数据的安全。

基本步骤

  1. 创建智能体
  2. 填写提示词
  3. 设置开场白和预设问题/审查

Level 4:代码级开发——自己掌控 Loop 与 Harness

前面 Level 1~3 都是平台视角(提示词 → 工作流 → Coze/Dify/n8n),本质是”用别人搭好的运行外壳”。当平台的灵活性不够、或要深度定制时,就下沉到代码级开发,自己掌控 Agent 的运行机制。

这一层要理解两个核心概念(Day 1 的另外两篇):

  • 运行循环(Loop):Agent”想→做→看→再想”的节奏。如何设计见 loop_engineering.md
  • 运行外壳(Harness):真正驱动这个循环、把模型武装成 Agent 的那层代码。见 agent_harness.md

把 Level 1~4 连起来看:提示词决定 Agent 的角色 → 工作流/编排决定固定流程 → Loop 决定动态循环节奏 → Harness 是承载这一切运行的机器。平台(Coze/Dify)帮你把 Harness 藏起来了;代码级开发则是自己造或用 LangChain/LangGraph 这类现成 Harness。

代码级选型阶梯

阶段工具何时用
搞懂原理纯 Python 手写 while 循环学习、想看清 Agent 到底怎么转
快速起步LangChain AgentExecutor原型、单 Agent、标准 ReAct
复杂可控LangGraph(graph-based runtime)分支、多 Agent、需要强可控性和可观测性

建议路径:先手写一遍最小循环(体会判停、状态、错误处理),再用 LangChain,最后按需上 LangGraph。顺序反了容易被框架概念淹没,却不懂它在解决什么。

开发路径全景图

零代码 ────────────────────────────────────────▶ 全代码
  │              │                │                    │
 提示词型      工作流型         平台智能体          代码级 Agent
(Cherry等)   (步骤固定)      (Coze/Dify/n8n)     (LangChain/LangGraph/手写)
  │              │                │                    │
 角色+对话     流程可见可控     知识库+插件+发布      自己掌控 Loop & Harness
                                                       └─ loop_engineering.md
                                                       └─ agent_harness.md

选型直觉:越往右越灵活但越重。需求能被平台满足就别下沉;平台卡住了(要自定义循环、特殊工具编排、深度可观测)再上代码级。

常见坑(复习重点)

  • 一上来就写代码 → 简单需求用 Coze/Dify 几分钟搞定,非要手写循环属于过度工程。
  • 一直停在平台层 → 遇到平台表达不了的复杂逻辑还硬凑,此时该下沉到代码级。
  • 跳过手写直接上 LangGraph → 不理解 Loop/Harness,框架就是黑盒,出问题不会查。
  • 温度参数乱设 → 需要稳定输出的任务(如结构化提取)把温度调高,导致结果飘(呼应”AI 可预测性”,Day 2)。

Agent 表现不好,该拉哪根杠杆?(排障决策框架)

Agent 效果差时,常见的错误反应是”赶紧微调模型”。其实有三根不同的杠杆,对应三种不同根因,且成本天差地别。先诊断症状,再对症下药。

症状根因拉哪根杠杆成本
不知道某事实 / 最新信息 / 私有知识缺知识RAG(检索喂进上下文),见 embedding_model.md低~中
知道但不听指令 / 格式不对 / 风格不对 / 不会调工具缺行为SFT 微调,见 foundation_model.md + sft.md(Day 3)
单步没问题,但多步就乱:忘前文、死循环、工具报错就崩、该停不停缺工程Harness / Loop / Context,见 agent_harness.mdloop_engineering.md

⚠️ 关键认知:很多看起来像”模型不行”的问题,其实是 Harness / 上下文问题。

  • Agent”忘了”前面说的话 → 多半是状态管理没把历史喂回去(Loop/Context),不是模型笨。
  • Agent 工具老调错 → 可能是工具描述写得烂(Harness 的上下文组装),不该急着微调。

排障顺序:便宜 → 贵

① 先调 Prompt / Context      ← 最便宜,改几行字
② 再查 Harness / Loop         ← 状态、工具描述、错误处理、判停
③ 缺知识 → 上 RAG            ← 中等成本
④ 缺行为且前三步都试过 → SFT  ← 最贵,最后手段

一句话:微调是最后手段,不是第一反应。 先怀疑工程(Harness/Context),再怀疑知识(RAG),最后才怀疑模型行为(SFT)。

呼应”两个基座”(见 foundation_model.md):RAG/微调动的是基座模型①(模型地基),Harness 动的是基座②脚手架(系统地基)——它们是并列的不同杠杆。

关联概念

  • loop_engineering.md:代码级开发绕不开的运行循环设计。
  • agent_harness.md:承载循环的运行外壳,平台帮你藏起来了。
  • foundation_model.md:两个”基座”辨析;RAG vs 微调动的是模型地基。
  • agent.md:Agent = 模型 + 工具 + 循环 + 状态;workflow vs agent 的取舍。
  • mcp.md / tool_calling.md:给 Agent 接能力。
  • openai_compatible_sdk.md:代码级开发里”调哪个模型”的统一客户端层,换供应商只改 base_url
  • n8n.md:Level 3 平台智能体之一,可视化工作流自动化 + AI Agent 节点(与 Coze/Dify 并列)。