Coze 智能体构建入门指南

点击左侧Coze API->授权->个人访问令牌->添加获取访问令牌

步骤一：创建插件

1. 登录 Coze 平台
2. 在左侧导航栏中选择工作空间，并在页面顶部空间列表中选择个人空间或团队空间。
   • 系统默认创建一个个人空间，在该空间内创建的资源都是私人资源，其他用户不可见
3. 填写插件基础信息
   • 输入插件名称和描述
   • 插件工具创建方式选择基于已有服务创建
   • 插件 URL：输入 API 的服务地址
   • 授权方式选择不需要授权
   • 单击确认完成插件创建

将 Header 信息配置到 Header 列表当中 a.Authorization，Bearer 个人访问令牌 b.Content-Type，application/json

在资源库页面右上角单击+资源，并选择插件

步骤二：添加工具

首先看看工具路径怎么弄： 工具路径：如图，工具路径是GET，https://api.coze.cn/这块是给出来的，填/后面这部分即可（先记下来路径）。接下来开始建插件工具

配置输入参数：还是在查看智能体列表处，往下滑的Query params

1. 在已创建的插件页面，单击创建工具
2. 配置工具名称和描述信息，然后单击确定
   • 工具路径：工具路径以/开始
3. 单击右上角试运行。
4. 在试运行页面，输入参数，然后单击运行测试接口。测试完成后，单击完成

请求方法为 GET 方法

在编辑工具页面，完成以下操作 a.单击更多信息区域的右上角的编辑，配置工具的路径和请求方法，然后单击保存 b.单击配置输入参数区域右上角的编辑，单击新增参数配置请求参数，然后单击保存 c.单击配置输出参数区域右上角的编辑，单击自动解析，在弹出的页面输入请求参数值，再单击自动解析。接口调用成功后，会返回参数自动填充到输出参数列表，可以根据需求进行修改，然后单击保存

4.2 工作流

工作流介绍：

工作流是一系列可执行指令的集合，用于实现业务逻辑或完成特定任务。它为应用/智能体的数据流动和任务处理提供了一个结构化框架。工作流的核心是将大模型的强大能力与特定的业务逻辑相结合，通过系统化、流程化的方法来实现高效、可扩展的 AI 应用。 简单来说就是，工作流是一种可视化、可编排的流程设计工具，用于定义智能体在处理用户请求或执行任务时的具体步骤和逻辑

节点：

工作流的核心在于节点，每个节点是一个具有特定功能的独立组件，负责处理数据、执行任务等，有输入和输出。工作流默认含开始（定义启动输入参数）和结束节点（返回运行结果），节点可通过引用输出连接，形成操作链。 在工作流节点编排时，灵活性和扩展性很关键；多种类型的节点（如开始节点、插件节点、代码节点等）都支持 String、Integer 等多种变量类型；可根据实际需求灵活选数据类型，无需额外数据转换，以此提升工作流编排的灵活性与扩展性。

工作流与对话流

• 工作流：用来处理功能类请求的，能通过依次执行一系列节点来达成某个功能。
• 对话流：针对对话场景的特殊工作流，专门处理对话类请求；如，在应用里添加对话流，会把对话里的用户指令拆成一个个步骤节点，并且为这些节点设计用户界面，这样就能搭建出适配移动端或网页端的对话式 AI 应用，让对话流程实现自动化与智能化

对话流和工作流的区别

与工作流相比，对话流更具有交互性。每个对话流都和一个会话绑定，运行的时候能从这个会话里读取历史信息，还能把本次运行对话流产生的消息记录到这个会话里，就相当于是有记忆功能的工作流。可以这么理解，当用户发起请求时，AI 靠工作流处理；返回结果给用户时，用对话流。

二者区别如下：

搭建工作流：

工作流是一系列可执行指令的集合，用于实现业务逻辑或完成特定任务。你可以在智能体和应用搭建中通过工作流实现特定的任务或指令。但在此之前，需要先构建一个可运行的工作流。

步骤一：创建工作流

1. 登录 Coze 开发平台
2. 在左侧导航栏中选择工作空间，并在左侧顶部空间列表中选择个人空间（默认是个人空间，这里我以个人空间为例）
3. 在资源库页面右上角单击+资源，并选择工作流

设置工作流的名称（要英文的）与描述，并单击确认

【注】创建好后会自动跳转至工作流的编辑页面，初始状态下工作流包含开始节点和结束节点，顾名思义，开始节点用于启动工作流，结束节点用于返回工作流的运行结果。

步骤二：编排工作流

创建好工作流后，你在画布中添加节点。工作流内置了很多基础节点供使用，同时还可以添加插件节点来执行特定任务。

1. 在底部面板中选择要使用的节点
2. 将各节点相连接

配置节点的输入和输出参数 输出参数：

步骤三：测试并发布工作流

要想在智能体内使用该工作流，需要发布工作流（跟插件一样）

单击发布 示例：（我这里是简单示例，所以节点只有一个。）

单击试运行，运行成功的会显示 单击试运行的时候，需要你加入一个测试集，第一次必须要手动创建，后续测试时可以将结果记录下来（勾选将本次运行输入保存为测试集）

【注】发布以后就可以将这个工作流添加到智能体内了

在智能体中添加工作流

添加工作流

1. 前往智能体页面，选择进入指定智能体
2. 在智能体编排页面的工作流区域，单击右侧的加号图标
3. 在智能体的人设与回复逻辑区域，引用工作流的名称来调用工作流。

在添加工作流对话框，在资源库工作流页面选择工作流

设置工作流异步运行

工作流默认为同步运行，即智能体必须在工作流运行完毕后才会将工作流的输出传递给智能体用户。如果工作流复杂，或包含一些运行耗时长的节点，可能会导致工作流整体运行耗时长，智能体判断为工作流运行超时，在其运行完毕前就结束对话。例如包含图像流节点、多个大模型节点，或编排逻辑复杂的工作流节点。

开启异步运行：

异步运行效果：

开启异步运行，并设置回复内容。

在指定工作流右侧单击设置

至此，一个简单的智能体就已经创建好了。