COZE - 3
应用开发与发布
什么是应用?
通过扣子平台构建的 AI 应用具备强大的可扩展性,支持与个性化的用户界面绑定。扣子应用通过工作流或对话流处理复杂的业务逻辑与编排,其内置的丰富节点库提供了逻辑处理、知识写入与检索、大模型服务、会话管理等多种能力,帮助开发者灵活编排自动化流程、构建各种智能服务。
应用就是为智能体加上了一个前端。
创建应用
登录扣子开发平台。
在左侧菜单栏,单击工作空间。
选择一个工作空间。工作空间是各种资源和开发项目的集合。不同工作空间内的数据和资源相互隔离。
在项目开发页面,单击创建,然后在弹出的页面,选择创建应用。
在应用模板页面,单击空白应用。
输入应用名称,并单击图标旁的 AI 图标使用 AI 自动生成一个图标。然后单击确定。应用创建成功后,你会直接进入到应用的集成开发环境(IDE)。
开发业务逻辑
添加工作流
工作流是实现业务逻辑的一套指令集。在工作流中,节点是核心,代表具有独特功能的特定工具例如处理数据、执行任务。通过连接节点,你可以建立一个无缝的操作链,指导数据在应用中的流动。
扣子支持在项目中创建一个新的工作流或复制一个已有的工作流使用。
在资源列表中,找到工作流,然后选择一种添加方式。
- 新建工作流:在该项目中创建一个新的工作流。新创建的工作流只能在该项目中使用,无法共享给其他项目使用。
- 新建对话流:对话流是基于对话场景的特殊工作流,你可以在该项目中创建一个新的对话流。新创建的对话流只能在该项目中使用,无法共享给其他项目使用。
- 引入资源库文件:复制一个项目所属的工作空间内已发布的工作流到该项目中使用。复制后,你可以对这个工作流进行修改。在项目中对工作流的修改不影响资源库中的工作流。
添加插件
插件是可以独立开发和部署的线上服务,由一个或多个工具组成。扣子支持使用插件来扩展模型的能力,将是可以添加新的外部处理的线上集成成,由第三方服务等工具组成。
在扣子应用的工作流中添加插件节点时,可以使用插件商店中已发布的公共插件、工作空间内的已发布插件或创建一个新插件资源仅供项目使用。参考以下操作,在扣子应用中创建一个插件,并添加到工作流中。
在左侧资源列表中,找到插件,然后选择+→ 新建插件。
根据引导完成插件工具的创建和测试。
在画布中,选择添加「插件节点」。
在打开的页面中,选择「项目工具」,找到目标工具后,单击添加。
完成工作流插件节点的输入和输出配置。
添加数据
扣子支持通过数据库、知识库等功能存储和管理数据。
- 数据库:与传统数据库一样,扣子支持以表格结构存储数据。在大模型的加持下,开发者和用户还可以通过自然语言插入、查询、修改或删除数据库中的数据。同时,也支持开发者开启多用户模式,支持共享、误写笔记、日程记录、每日消费等非正式适合组织和管理结构化数据,例如通过数据库维护比赛结果的读写控制。
- 知识库:扣子知识库支持上传和存储外部知识内容,并提供了多种检索能力,可解决大模型幻觉、专业领域知识不足的问题,提升大模型回复的准确率。
构建用户界面
搭建用户界面流程如下:
展示组件
展示组件是 Coze 应用界面呈现信息的核心元素,通过可视化编辑、样式自定义和数据绑定三大特性,实现从简单文本到复杂交互的全场景展示需求。作为低代码开发的核心载体,其设计理念在于降低界面构建门槛,支持零代码用户快速搭建专业级 UI 界面。
展示组件包含:文本、图片、Markdown、音频、图标、轮播、Lottie 动画、代码展示、徽章、视频等类型。
Text 组件
Text 组件支持字符串类型数据,通过双引号("")或单引号('')包裹文本内容。
图片组件
图片组件用于展示图片。
Markdown 组件
Markdown 组件用于渲染 Markdown 格式的文本。
音频组件- 音频组件用于播放音频内容,支持播放本地上传的音频文件,也可绑定工作流返回值或直接填写音频 URL,灵活满足不同音频播放需求。
图标组件- 图标组件用于展示一个图标,增强界面的视觉效果和交互性。
轮播组件- 轮播组件用于在有限空间内循环展示一系列图片。
动画组件- Lottie 动画是一款极具高性能的动画解决方案,扣子应用支持添加 Lottie 动画组件用于播放 Lottie 动画,增强应用的视觉效果和交互体验。
代码展示组件- 代码展示组件用于显示代码片段。
徽章组件- 徽章组件用于展示明星信息的小组件,带有数字或图标。
视频组件- 视频组件用于播放视频内容,支持飞书选择的视频类型,也可绑定工作流返回值或直接填写音频 URL,灵活满足不同播放需求。
输入组件
输入组件是 Coze 应用中实现用户交互的数据收集载体,核心作用是连接用户输入与业务逻辑。
按钮组件
按钮组件用于触发事件或动作,例如提交表单。
表单组件- 表单组件用于收集用户输入的数据,通常与多个输入字段一起使用。表单组件支持丰富的属性设置,例如常用设置、位置设置、尺寸设置、样式设置、变换设置、状态设置和可见性设置。
开关组件- 开关组件用于开启或关闭某个选项,常用于设置。开关组件支持丰富的属性设置,例如常用设置、位置设置、尺寸设置、样式设置、变换设置、状态设置和可见性设置。
文本输入组件- 文本输入组件用于接收用户文本输入的字段,允许用户输入、编辑文本信息。文本输入支持丰富的属性设置,例如常用设置、位置设置、尺寸设置、样式设置、变换设置、状态设置和可见性设置。
代码编辑组件- 代码编辑组件用于编写代码,支持语法高亮和代码提示。代码编辑组件支持丰富的属性设置,例如常用设置、位置设置、尺寸设置、样式设置、变换设置、状态设置和可见性设置。
数字输入组件- 数字输入组件用于输入数字,适用于需要精确数值的场景。
文件上传组件- 文件上传组件用于上传文件,支持配置上传文件的格式和大小。
图片上传组件- 图片上传组件用于上传和展示图片,常用于图像内容的管理。
设置组件参数
用户界面编辑器提供了两种配置方式:设置常量和引用变量。
设置常量
设置常量是一种在组件中直接指定固定值的方法,适用于内容不需要动态更新的场景。
以文本组件为例,演示如何设置常量。
- 在左侧导航栏中选择工作空间,并在页面顶部空间列表中选择目标工作空间。
- 在项目开发页面,选择目标应用或创建一个新应用。
- 单击用户界面页签,然后从组件栏中拖动一个文本组件到画布。
- 在右侧属性面板,找到内容参数,配置所需的文本内容。
也就是上面图片的右侧区域
引用变量
引用变量是一种动态设置内容参数的方法,可以根据运行时的数据动态更新组件内容,适用于需要与其他组件或数据源交互的场景。引用变量的基本语法是在变量名前加上双大括号{{}}。例如,如果你有一个名为username的变量,你可以在组件中这样引用它:{{username}}。
目前,支持引用工作流的返回数据、组件的 content、URL 参数和局部上下文。
在组件中引用变量时,支持引用工作流输出节点的输出内容,可以在用户界面中呈现类似「Loading 中」的效果,避免某个节点处理时间过长,影响用户体验。目前仅支持引用主工作流的消息节点,暂不支持引用子工作流中的消息节点。此外,引用循环节点或批处理节点中的消息节点时,不可引用其中某次循环或某次批处理流程中的消息节点。
应用调试与发布
我们通过上面应用 - 翻译助手来学习一下应用的开发与发布。
开发工作流
开始节点
工作流的起始节点,用于设定启动工作流需要的信息。
输入变量:
content:文本内容language:目标语言
大模型节点
- 输入:
content、language - 输出:
output、reasoning_content - 模型:豆包・1.6・极致速度・250715
- 技能:未配置技能
系统提示词:
# 角色 你是一个专业的翻译助手,能够准确、流畅地将任何文本内容翻译成目标语言。 # 技能 ### 技能 1:翻译文本 1. 当用户提供要翻译的文本和指定目标语言时,直接进行翻译。 2. 如果用户仅提供文本而未指定目标语言,询问用户希望翻译成哪种语言。 ### 技能 2:处理复杂文本 1. 对于结构复杂的语言,会先对文本进行翻译前的准备,充分分析文本结构和关键信息。 2. 利用恰当的词汇和语法规则进行准确的翻译。 ### 技能 3:优化翻译质量 1. 对翻译结果进行质量和特殊要求,确保文风符合目标语言的表达习惯。 2. 如果用户对翻译结果有特殊要求,例如风格偏好等,按照要求进行调整。 # 限制 - 只进行文本翻译相关的工作,拒绝回答与翻译无关的话题。 - 所输出的翻译内容必须通顺、准确,符合目标语言的表达习惯。 - 请使用自然、易懂的语言进行翻译。用户提示词:
用户输入的文本:{{content}},目标语言:{{language}}输出:
- 输出格式:JSON
- 变量:
output(String)、reasoning_content(String)
结束节点
工作流的最终节点,用于返回工作流运行后的结果信息。
- 返回变量:
output,变量值引用「翻译助手.output」
调试工作流
输入测试数据:
content:"我是计算机专业的大学生"language:"English"
运行结果:
output:"I am a college student majoring in computer science."
发布工作流
- 版本号:v0.0.1
- 版本描述:翻译助手工作流
- 选择默认测试集 → 点击「发布」
开发用户界面
创建应用
- 应用名称:翻译助手
- 应用介绍:把任意文本内容翻译成目标语言
- 生成 AI 图标 → 确认创建
组件配置
- 从组件库中拖拽所需组件(文本、表单、按钮等)到画布。
- 引入已发布的翻译工作流(通过「引入资源库文件」)。
参数设置
按钮触发设置
点击「开始翻译」按钮后,需要提交整个 form 表单,添加事件:
- 事件类型:点击时
- 执行动作:控制组件
- 选择组件:Form1
- 组件方法:提交
请求参数绑定
当提交翻译时,需要调用工作流:
- 事件类型:点击时
- 执行动作:调用工作流
- 选择工作流:
translation_workflow - 工作流入参:
language→ 绑定Form1.languagecontent→ 绑定Form1.content
回显结果
- 将工作流返回的
output结果绑定到指定组件,用于展示翻译结果。
发布应用
- 选择发布渠道:API/SDK/ 小程序 / 社交平台 / 扣子 / MP 服务等。
- 配置发布信息 → 点击「发布」。
- 发布成功后,可通过应用地址访问「翻译助手」。
玫瑰翻译
