Coze 智能体构建入门指南
一、什么是 Coze? Coze 是新一代 AI 应用开发平台。无论你是否有编程基础,都可以在 Coze 上快速搭建基于大模型的各类 AI 应用,并将 AI 应用发布到各个社交平台,也可以通过 API 或 SDK 将 AI 应用集成到你的业务系统中。 二、Coze 能做什么? Coze 提供可视化设计与编排工具,通过零代码或低代码方式,快速搭建基于大模型的各类 AI 项目。(登录到 Coze 官网…

一、什么是 Coze? Coze 是新一代 AI 应用开发平台。无论你是否有编程基础,都可以在 Coze 上快速搭建基于大模型的各类 AI 应用,并将 AI 应用发布到各个社交平台,也可以通过 API 或 SDK 将 AI 应用集成到你的业务系统中。 二、Coze 能做什么? Coze 提供可视化设计与编排工具,通过零代码或低代码方式,快速搭建基于大模型的各类 AI 项目。(登录到 Coze 官网…

Coze 是新一代 AI 应用开发平台。无论你是否有编程基础,都可以在 Coze 上快速搭建基于大模型的各类 AI 应用,并将 AI 应用发布到各个社交平台,也可以通过 API 或 SDK 将 AI 应用集成到你的业务系统中。
Coze 提供可视化设计与编排工具,通过零代码或低代码方式,快速搭建基于大模型的各类 AI 项目。(登录到 Coze 官网,进入商店,有各种应用、插件等)
三者的关系:智能体是'会自主做事'的主体;应用是它在业务中的价值场景;插件是按需装配的能力模块,三者共同支撑从客服到工业等多领域的智能化升级。
Coze 支持创建自定义插件。每个插件可添加多个工具,同一个插件内的不同工具必须使用相同的域名。插件中的每个工具都是一个独立的 API。调用插件其实就是调用插件内的某个工具,即 API。
如,一个查询天气的 AI Service 可能包含以下两个 API:
【注】每个工作空间下最多可创建 1000 个插件,每个插件中最多包含 100 个工具,每个账号下最多可创建 15 个 IDE 插件
在创建插件时,首先需要将这个 API 服务注册为一个插件,然后将这个服务下的 API 添加到插件中作为工具使用,最后将插件发布上线。
在调用 Coze API 前,确保你已经将智能体发布为了 API 服务,并通过不同的授权方式获取了访问令牌
点击添加键,在弹出来的窗口如下,设置一些信息,点击确定,在弹出来的窗口点击复制访问令牌!!(一定要复制,因为只能查看一次令牌)

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

工作空间,并在页面顶部空间列表中选择个人空间或团队空间。
已有服务创建将 Header 信息配置到 Header 列表当中
a.Authorization,Bearer 个人访问令牌
b.Content-Type,application/json

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

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


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

创建工具确定
试运行。试运行页面,输入参数,然后单击运行测试接口。测试完成后,单击完成请求方法为 GET 方法

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

工作流是一系列可执行指令的集合,用于实现业务逻辑或完成特定任务。它为应用/智能体的数据流动和任务处理提供了一个结构化框架。工作流的核心是将大模型的强大能力与特定的业务逻辑相结合,通过系统化、流程化的方法来实现高效、可扩展的 AI 应用。
简单来说就是,工作流是一种可视化、可编排的流程设计工具,用于定义智能体在处理用户请求或执行任务时的具体步骤和逻辑
工作流的核心在于节点,每个节点是一个具有特定功能的独立组件,负责处理数据、执行任务等,有输入和输出。工作流默认含开始(定义启动输入参数)和结束节点(返回运行结果),节点可通过引用输出连接,形成操作链。 在工作流节点编排时,灵活性和扩展性很关键;多种类型的节点(如开始节点、插件节点、代码节点等)都支持 String、Integer 等多种变量类型;可根据实际需求灵活选数据类型,无需额外数据转换,以此提升工作流编排的灵活性与扩展性。

与工作流相比,对话流更具有交互性。每个对话流都和一个会话绑定,运行的时候能从这个会话里读取历史信息,还能把本次运行对话流产生的消息记录到这个会话里,就相当于是有记忆功能的工作流。可以这么理解,当用户发起请求时,AI 靠工作流处理;返回结果给用户时,用对话流。
二者区别如下:
| 差异 | 工作流 | 对话流 |
|---|---|---|
| 场景 | 工作流用于处理功能类请求,适合数据自动化处理,像生成行业调研报告等 | 对话流是对话场景的特殊工作流,更适配处理对话类请求,适用于智能客服等对话式应用 |
| 节点 | 工作流里涉及大模型处理的节点不支持查看对话历史 | 对话流开始节点需传入会话名称以记录对话历史,模型类节点还能读取对话历史,会话上下文会和用户问题一起传给大模型 |
| 角色配置 | 工作流不支持角色配置 | 对话流支持,可单独为每个对话流配置角色名称、头像等属性,且在不同场景下能以指定角色与用户交互,还有相应的优先级规则 |
| 用户界面 | 工作流支持丰富的布局、展示等组件类型 | 对话流目前仅支持 AI 对话组件,可将对话流包装成聊天面板展示在移动端或网页端 |
| 发布渠道 | 工作流在 AI 应用中支持发布到 API,绑定用户界面后还能发布到模板、商店,但暂不支持发布到社交渠道等 | 对话流在 AI 应用中支持发布到 API&SDK、小程序、社交渠道等 Coze 提供的所有发布渠道 |
| API 调用 | 工作流通过 API 执行工作流或执行工作流(流式响应)来调用 | 对话流通过 API 执行对话流来调用 |
工作流是一系列可执行指令的集合,用于实现业务逻辑或完成特定任务。你可以在智能体和应用搭建中通过工作流实现特定的任务或指令。但在此之前,需要先构建一个可运行的工作流。
工作空间,并在左侧顶部空间列表中选择个人空间(默认是个人空间,这里我以个人空间为例)资源库页面右上角单击+资源,并选择工作流设置工作流的名称(要英文的)与描述,并单击确认

【注】创建好后会自动跳转至工作流的编辑页面,初始状态下工作流包含开始节点和结束节点,顾名思义,开始节点用于启动工作流,结束节点用于返回工作流的运行结果。
创建好工作流后,你在画布中添加节点。工作流内置了很多基础节点供使用,同时还可以添加插件节点来执行特定任务。
配置节点的输入和输出参数 输出参数:

要想在智能体内使用该工作流,需要发布工作流(跟插件一样)
单击发布 示例:(我这里是简单示例,所以节点只有一个。)

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

【注】发布以后就可以将这个工作流添加到智能体内了
工作流区域,单击右侧的加号图标在添加工作流对话框,在资源库工作流页面选择工作流

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

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

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

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

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online