Coze智能体搭建全攻略：从零开始掌握工作流节点、知识库应用与H5界面设计

本文由源码七号站原创整理，深度解析Coze（扣子）平台的核心功能与实战操作技巧，助你从入门到精通，打造属于自己的AI智能体应用。

前言：为什么要学习Coze智能体开发？

在人工智能快速发展的今天，AI智能体（Agent）已经成为提升工作效率、实现业务自动化的重要工具。Coze（扣子）作为字节跳动推出的新一代AI智能体开发平台，凭借其零代码、低门槛的特点，让每个人都能快速搭建出功能强大的AI应用。

无论你是想做一个智能客服、内容创作助手，还是数据分析工具，Coze都能帮你实现。本文将从最基础的概念讲起，一步步带你掌握Coze平台的核心功能，包括JSON数据结构、工作流节点配置、知识库应用、插件调用以及H5界面设计等全方位内容。

源码七号站建议你在阅读本文时，同步打开Coze平台（官网：https://www.coze.cn ）进行实际操作，这样学习效果会更好。

第一章：必备基础——JSON数据结构详解

在深入学习Coze智能体搭建之前，你需要先理解一个非常重要的概念：JSON数据结构。这是贯穿整个Coze工作流的核心知识点，节点与节点之间传输的数据都是以JSON格式进行组织的。

1.1 什么是JSON？

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，它具有良好的可读性，非常适合人类阅读和编写。在Coze平台中，所有节点之间传递的数据都采用JSON格式，因此掌握JSON结构是学习Coze的第一步。

1.2 JSON的两种顶层结构

JSON有两种基本的顶层结构，理解它们是掌握数据传输的关键。

1.2.1 对象（Object）

对象使用花括号 {} 包裹，内部由键值对组成。键和值之间用冒号分隔，多个键值对之间用逗号分隔。

{
"name": "华仔",
"age": 18,
"level": "初级"
}

关于对象结构，有几个重要规则需要牢记：

• 键必须是字符串，且必须用双引号包裹（单引号不允许）
• 键和值之间用冒号 : 分隔
• 多个键值对之间用逗号 , 分隔
• 最后一个键值对后面不能加逗号

举个例子，下面这段JSON是错误的：

{
"name": "华仔",
"age": 18, // 最后一个不能有逗号
}

正确的写法应该是：

{
"name": "华仔",
"age": 18
}

1.2.2 数组（Array）

数组使用方括号 [] 包裹，元素之间用逗号分隔。数组中的元素可以是任意数据类型，包括字符串、数字、布尔值、null、对象，甚至是另一个数组。

["标题一", "标题二", "标题三", "标题四", "标题五"]

数组也可以包含更复杂的元素：

[
{"title": "文章一", "content": "内容一"},
{"title": "文章二", "content": "内容二"},
{"title": "文章三", "content": "内容三"}
]

1.3 JSON支持的数据类型

在JSON中，值可以是以下几种数据类型：

1.4 嵌套结构

在实际应用中，JSON经常会出现嵌套结构，即对象中包含数组，或数组中包含对象。

对象嵌套数组的示例：

{
"user": "张三",
"hobbies": ["读书", "游戏", "编程"]
}

数组嵌套对象的示例：

[
{"name": "标题一", "content": "内容一"},
{"name": "标题二", "content": "内容二"}
]

多层嵌套的复杂示例：

{
"company": "源码七号站",
"employees": [
{
"name": "张三",
"skills": ["Python", "JavaScript"]
},
{
"name": "李四",
"skills": ["Java", "Go"]
}
]
}

1.5 为什么JSON这么重要？

在Coze平台中，节点与节点之间传输的数据都是JSON格式。当你理解了JSON结构后，你就能：

1. 正确配置节点的输入输出参数
2. 理解批处理和循环节点的工作原理
3. 准确提取和使用上游节点返回的数据
4. 排查数据传输过程中的问题

源码七号站提醒你：如果你在后续学习中遇到数据格式相关的问题，建议回到这一章节复习JSON的基础知识。

第二章：工作流节点详解

Coze的工作流是搭建智能体的核心，它由多个节点组成，每个节点负责完成特定的任务。本章将详细介绍各类节点的功能和使用方法。

2.1 开始节点与结束节点

2.1.1 开始节点

开始节点是工作流的入口，用于定义用户输入的变量。你可以在这里设置：

• 变量名称：给变量取一个有意义的名字，如 query、keyword 等
• 变量类型：支持字符串、整数、文件、图片等多种类型
• 必填项：带星号标记的为必填参数
• 默认值：可以预设输入内容，用户不输入时使用默认值

例如，创建一个关键词输入变量：

变量名：keyword
类型：字符串
描述：用户输入的关键词
必填：是
默认值：AI教程

2.1.2 结束节点

结束节点是工作流的出口，用于返回处理结果给用户。它支持两种输出方式：

1. 返回变量：直接返回某个节点的输出变量
2. 返回文本：返回自定义的文本内容，支持Markdown格式

Markdown格式常用语法：

• 标题：# 一级标题、## 二级标题、### 三级标题
• 加粗：**文本**
• 斜体：*文本*
• 分割线：---
• 换行：\n
• 超链接：[链接文字](URL地址)

2.2 大模型节点

大模型节点是工作流中最核心的节点，它调用AI大模型来处理各种任务。

2.2.1 模型选择

Coze平台支持多种大模型，包括：

• 豆包系列模型（推荐使用）
• Claude系列
• GPT系列
• 文心一言
• 其他第三方模型

选择模型时需要考虑：任务复杂度、响应速度、成本等因素。一般来说，豆包模型在国内使用体验较好，且免费额度充足。

2.2.2 精准度设置

大模型节点提供三种精准度模式：

2.2.3 系统提示词与用户提示词

系统提示词用于定义AI的角色和任务规则，相当于给AI一个"人设"。例如：

你是一个专业的爆款标题专家。你需要根据用户提供的关键词，生成5个不同风格的标题。
要求：
1. 每个标题不超过20个字
2. 标题要吸引眼球
3. 符合新媒体传播特点

用户提示词用于传入具体的任务指令和参数。通过引用变量的方式（使用 {{变量名}} 格式）将上游节点的数据传递给大模型。

2.2.4 输出格式配置

大模型节点的输出格式可以设置为：

• 字符串：输出普通文本
• 数组：输出列表形式的数据（适合批处理场景）
• 对象：输出结构化的键值对数据

重要提示：如果你需要后续节点进行批处理，务必将输出格式设置为数组类型。

2.3 循环节点

循环节点用于重复执行某些操作，直到满足特定条件。

2.3.1 基本配置

循环节点需要设置三个关键参数：

• 起始值：循环开始的数值（通常为0或1）
• 结束值：循环结束的数值
• 步长：每次循环递增的值（通常为1）

例如，设置起始值为0，结束值为5，步长为1，则循环会执行5次。

2.3.2 循环控制

在循环内部，你可以使用两种控制节点：

• 继续循环（Continue）：跳过当前这一次循环，直接进入下一次
• 中断循环（Break）：终止整个循环，不再执行后续迭代

举个例子，如果你在循环中添加条件判断，当循环变量等于3时执行"继续循环"，那么第3次循环的后续操作会被跳过，直接进入第4次循环。

如果执行"中断循环"，则第3次及之后的所有循环都会被终止。

2.4 中间变量与特殊变量

这是循环节点中一个非常重要的高级功能，主要用于实现上下文连贯。

2.4.1 中间变量的作用

假设你要写一篇长文章，分成5个段落，每个段落都需要与上一个段落保持内容连贯。这时就需要用到中间变量。

中间变量的工作原理：

1. 第一次循环时，中间变量为初始值（可以是空字符串）
2. 大模型根据当前标题和中间变量生成第一段内容
3. 第一段内容被赋值给中间变量
4. 第二次循环时，大模型获取到的中间变量就是第一段的内容
5. 大模型结合第一段内容和新标题，生成与上文连贯的第二段
6. 以此类推...

2.4.2 特殊变量（设置变量）

特殊变量节点用于在每次循环结束时，将当前的输出值更新到中间变量中，以便下一次循环使用。

配置步骤：

1. 在循环内添加"设置变量"节点
2. 选择要更新的中间变量
3. 将当前大模型的输出赋值给中间变量

通过这种方式，每一次循环的输出都会成为下一次循环的输入参考，从而实现"承上启下"的效果。

2.5 批处理节点

批处理节点与循环节点类似，但效率更高——它可以同时处理多个任务。

2.5.1 批处理与循环的区别

2.5.2 批处理配置

批处理节点的关键配置项：

• 并行运行数量：一次性可以处理几个任务（建议设置为5-10）
• 批处理支付数：总共处理多少批次
• 输入数据：必须是数组类型

例如，你有5个标题需要生成对应的文章：

1. 上游大模型生成5个标题（输出为数组）
2. 批处理节点接收这个数组
3. 批处理内部的大模型使用 item 变量获取当前处理的标题
4. 同时生成5篇文章

item变量说明：在批处理内部，item 代表当前正在处理的数组元素。就像循环中的"当前项"一样。

2.6 条件判断节点

条件判断节点用于根据不同条件执行不同的操作分支。

2.6.1 选择器节点

选择器节点支持设置多个