Coze智能体简单入门构建指南

# AI应用开发的新利器：Coze平台深度解析 人工智能应用开发正经历深刻变革——技术门槛持续降低，创新可能性不断拓展。扣子（Coze）正是这一变革浪潮中的关键平台之一。 ## 什么是Coze？ 扣子是一款新一代人工智能应用开发平台，其核心价值在于：无论用户是否具备编程基础，都能在该平台上快速构建基于大语言模型的各类AI应用。更为关键的是，这些应用可发布至多个社交媒体平台，亦能通过API或SDK集成到现有业务系统中。简言之，它大幅缩短了AI应用从“创意构思”到“实际落地”的周期。 ## Coze到底能做些什么？ 扣子提供可视化设计与编排工具，采用零代码或低代码方式，即可高效搭建各类AI项目。登录扣子官网进入商店后，可看到多种应用与插件——其背后由几个关键模块构成： **智能体**：基于对话的AI项目，能理解自然语言，调用知识库与插件，借助可视化工作流完成复杂任务。智能客服、虚拟伴侣等均属此类。 **应用**：利用大模型技术开发的应用程序，具备完整的业务逻辑和可视化用户界面，属于独立的AI项目，例如AI搜索、翻译工具等。 **插件**：一个工具集，单个插件可包含一个或多个工具（API）。其作用在于扩展智能体的功能，通过标准化接口与工作流集成，帮助完成联网搜索、知识库问答、邮件/日历操作、图片理解、多模态生成等任务。若官方集成的插件不足以满足需求，还可创建自定义插件来集成所需API。 理解这三者的关系：智能体是“具备自主行动能力”的主体，应用是其在业务场景中的价值体现，插件则是按需装配的功能模块——三者共同支撑从客服到工业等多领域的智能化升级。 ## Coze的几个关键优势 **灵活的工作流设计**：扣子的工作流功能专用于处理逻辑复杂、对稳定性要求较高的任务流。平台提供了大量灵活可组合的节点，包括大语言模型LLM、自定义代码、判断逻辑等。 **无限拓展的能力集**：扣子集成了丰富的插件工具，显著拓展了智能体的能力边界。官方提供多款功能强大的插件，可直接插入智能体中；同时平台支持自定义插件，可将已有的API能力通过参数配置快速创建为插件，还能发布至商店供其他用户使用。 **丰富的数据源**：知识库功能提供简单易用的数据管理与存储方式，支持智能体与自身数据进行交互。 **持久化的记忆能力**：数据库记忆能力让AI交互更加自然——可持久记住用户对话中的重要参数或内容。 ## Coze的使用指南 ### 认识插件 #### 插件与工具 Coze支持创建自定义插件。每个插件可添加多个工具，但有一个限制：同一插件内的不同工具必须使用相同的域名。插件中的每个工具都是一个独立的API，调用插件实际上就是调用插件内的某个工具——即API。 举例说明：一个查询天气的AI服务，可能包含两个API： - 查询当前天气：http://api.weather.com/current - 查询未来天气：http://api.weather.com/forecast 【注】每个工作空间下最多可创建1000个插件，每个插件中最多包含100个工具，每个账号下最多可创建15个IDE插件。 #### 基于API创建一个插件 创建插件时，需先将API服务注册为一个插件，然后将该服务下的API添加到插件中作为工具使用，最后发布上线。在调用扣子API前，需确保已将智能体发布为API服务，并通过不同授权方式获取访问令牌。 **获取访问令牌** 1. 登录扣子平台 2. 点击左侧“扣子API→授权→个人访问令牌→添加”获取访问令牌 3. 点击“添加”按钮，在弹出的窗口中配置相关信息，点击“确定”，然后在新窗口中点击“复制访问令牌”——这里有一个重要提示：务必复制，因为令牌仅可查看一次 **步骤一：创建插件** 1. 登录coze平台 2. 在左侧导航栏选择“工作空间”，并在页面顶部空间列表中选择个人空间或团队空间（系统默认的个人空间内资源均为私有，其他用户不可见） 3. 在资源库页面右上角单击“+资源”，选择“插件” 4. 填写插件基本信息：输入名称和描述，工具创建方式选择“基于已有服务创建”，输入API的服务地址，配置Header信息（Authorization填写“Bearer 个人访问令牌”，Content-Type填写“application/json”），授权方式选择“不需要授权”，最后单击确认完成创建 **步骤二：添加工具** 先明确工具路径的配置方式：工具路径在创建时，基础URL是固定的，仅需填写/后面的部分即可。接下来开始创建插件工具： 1. 在已创建的插件页面，单击“创建工具” 2. 配置工具名称和描述信息，确认 3. 在编辑工具页面完成三件事：配置工具的路径和请求方法（路径以/开头，请求方法为GET），配置输入参数（新增参数并保存），配置输出参数（使用自动解析功能） 4. 单击右上角“试运行”，输入参数运行测试，测试完成后单击“完成” ### 工作流 #### 工作流介绍 工作流是一系列可执行指令的集合，用于实现业务逻辑或完成特定任务。它为应用或智能体的数据流动与任务处理提供了结构化框架。其核心在于将大模型能力与特定业务逻辑相结合，通过系统化、流程化的方式实现高效、可扩展的AI应用。 用通俗的说法：**工作流是一种可视化、可编排的流程设计工具，用于定义智能体在处理用户请求或执行任务时的具体步骤与逻辑。** **节点**：工作流的核心在于节点。每个节点是一个具有特定功能的独立组件，负责处理数据、执行任务等。工作流默认包含开始节点（定义启动输入参数）和结束节点（返回运行结果），节点可通过引用输出连接，形成操作链。多种类型的节点均支持String、Integer等变量类型，可根据实际需求灵活选择，无需额外数据转换。 #### 工作流与对话流 - **工作流**：处理功能类请求，通过依次执行一系列节点达成某个功能 - **对话流**：针对对话场景的特殊工作流，专门处理对话类请求。例如在应用中添加对话流，会将用户指令拆解为若干步骤节点，并为这些节点设计用户界面，搭建出适配移动端或网页端的对话式AI应用 #### 对话流和工作流的区别 对话流更具交互性。每个对话流都和一个会话绑定，运行时能读取历史信息，还能将本次运行产生的消息记录到会话中——相当于具备记忆功能的工作流。可以这样理解：用户发起请求时，AI依靠工作流处理；返回结果给用户时，使用对话流。 | 差异 | 工作流 | 对话流 | |------|--------|--------| | 场景 | 处理功能类请求，适合数据自动化处理 | 对话场景的特殊工作流，适配对话类请求 | | 节点 | 大模型处理节点不支持查看对话历史 | 需传入会话名称，模型类节点能读取历史信息 | | 角色配置 | 不支持 | 支持配置角色名称、头像等属性 | | 用户界面 | 支持丰富的组件类型 | 目前仅支持AI对话组件 | | 发布渠道 | 支持API、模板、商店 | 支持所有发布渠道 | | API调用 | 执行工作流或执行工作流（流式响应） | 执行对话流 | #### 搭建工作流 **步骤一：创建工作流** 1. 登录扣子开发平台 2. 在左侧导航栏选择“工作空间”，并在左侧顶部空间列表中选择个人空间 3. 在资源库页面右上角单击“+资源”，选择工作流 4. 设置工作流的名称（英文）与描述，确认 创建完成后会自动跳转至编辑页面，初始状态包含开始节点和结束节点。 **步骤二：编排工作流** 在画布中添加节点。工作流内置了多种基础节点，同时还可以添加插件节点执行特定任务： 1. 在底部面板中选择要使用的节点 2. 将各节点相连接 3. 配置节点的输入和输出参数 **步骤三：测试并发布工作流** 若要在智能体内使用工作流，必须先发布它（与插件的逻辑相同）： 1. 单击试运行，运行成功会显示相应信息。首次运行时需手动创建测试集，后续测试时可将结果记录下来 2. 单击发布 发布后即可将此工作流添加到智能体内。 #### 在智能体中添加工作流 1. 前往智能体页面，选择进入指定智能体 2. 在智能体编排页面的“工作流”区域，单击右侧的加号图标 3. 在“添加工作流”对话框的“资源库工作流”页面选择工作流 4. 在智能体的人设与回复逻辑区域，引用工作流的名称来调用工作流 #### 设置工作流异步运行 工作流默认为同步运行，这意味着智能体必须等待其运行完毕后才能将输出传递给用户。若工作流复杂，或包含运行耗时较长的节点（如图像流节点、多个大模型节点），可能导致超时。 开启异步运行： 1. 在指定工作流右侧单击设置 2. 开启异步运行，并设置回复内容 3. 查看异步运行效果 至此，一个简单的智能体就已创建完成。从插件配置到工作流编排，每一步其实都不复杂——关键在于将这些模块组合起来，使其真正为你所用。