作为通义千问生态下的重要低代码开发平台，扣子（Coze）集成了流程编排、模型调用、工具链接与权限管理等关键能力，极大地降低了智能体(AI Agent)开发的技术门槛。

官网地址 https://www.coze.cn/

一、扣子平台结构与功能概览

首先明确平台的定位、组成与适用场景，其次比较低代码与传统开发范式的本质差异，揭示扣子在效率、可维护性与模块重用方面的优势，最后以搭建一个AI助手智能体为示例，直观展示平台在实际操作中的流程设计与功能编排能力。

（一）什么是扣子

扣子是由字节跳动推出的一款面向大语言模型应用的低代码智能体开发平台，致力于为开发者提供便捷、高效、可扩展的智能体构建能力，如图所示。

该平台构建于通义千问大模型体系之上，融合了自然语言交互、流程逻辑配置、多工具协同与跨模态能力集成等功能，能够在无须复杂编程的前提下，快速构建具备认知、推理、调用、响应能力的智能体系统。

无论是简单的问答Bot、复杂的业务流程机器人，还是多模态、多角色、多任务的复合型智能体，都可以借助扣子在可视化界面中快速完成配置与部署。

（二）搭建AI助手智能体

在扣子平台中构建一个AI助手型智能体是理解其低代码理念与平台能力整合的最佳入门实践。AI助手作为最常见的一类智能体，其核心功能通常包括自然语言理解、上下文记忆、多轮对话支持以及特定任务执行能力，如查询、日程提醒、内容生成等。

在传统开发模式下，构建此类智能体需依赖大量编程工作，涉及模型调用、状态管理、意图识别与工具集成等多个模块。

而在扣子平台上，开发者只需通过自然语言描述任务需求，结合流程图式节点配置，即可快速定义AI助手的行为逻辑、响应策略与接口调用方式。

官方文档地址 https://www.coze.cn/open/docs/guides/quickstart

1.创建一个智能体

(1)登录扣子平台。

官方网址： https://www.coze.cn/

(2)在页面左上角单击加号(⊕)图标。在低代码模式区域，单击智能体开发。

(3)输入智能体名称和功能介绍，然后单击生成图标，自动生成一个头像，也可以切换到AI创建，通过自然语言描述你的智能体创建需求，扣子根据描述自动创建一个智能体。

(4)单击“确认”按钮，创建智能体后，你会直接进入智能体编排页面，在左侧人设与回复逻辑面板中描述智能体的身份和任务，在中间技能面板为智能体配置各种扩展能力，在右侧预览与调试面板中，实时调试智能体。

2.编写提示词

配置智能体的第一步就是编写提示词，也就是智能体的人设与回复逻辑。智能体的人设与回复逻辑定义了智能体的基本人设，此人设会持续影响智能体在所有会话中的回复效果。建议在人设与回复逻辑中指定模型的角色、设计回复的语言风格、限制模型的回答范围，让对话更符合用户预期。

在智能体配置页面的人设与回复逻辑面板中输入提示词。例如夸夸机器人的提示词可以设置为：

# 角色
你是一个充满正能量的赞美鼓励机器人，时刻用温暖的话语给予人们赞美和鼓励，让他们充满自信与动力。

## 技能
### 技能 1：赞美个人优点
1. 当用户提到自己的某个特点或行为时，挖掘其中的优点进行赞美。回复示例：你真的很[优点]，比如[具体事例说明优点]。
2. 如果用户没有明确提到自己的特点，可以主动询问一些问题，了解用户后进行赞美。回复示例：我想先了解一下你，你觉得自己最近做过最棒的事情是什么呢？

### 技能 2：鼓励面对困难
1. 当用户提到遇到困难时，给予鼓励和积极的建议。回复示例：这确实是个挑战，但我相信你有足够的能力去克服它。你可以[具体建议]。
2. 如果用户没有提到困难但情绪低落，可以询问是否有不开心的事情，然后给予鼓励。回复示例：你看起来有点不开心，是不是遇到什么事情了呢？不管怎样，你都很坚强，一定可以度过难关。

### 技能 3：回答专业问题
遇到你无法回答的问题时，调用Search搜索答案

## 限制
- 只输出赞美和鼓励的话语，拒绝负面评价。
- 所输出的内容必须按照给定的格式进行组织，不能偏离框架要求。

你可以单击自动优化提示词，让大语言模型将提示词优化为结构化内容。

3.为低代码智能体添加技能

如果模型能力可以基本覆盖智能体的功能，则只需要为智能体编写提示词即可。但是如果你为智能体设计的功能无法仅通过模型能力完成，则需要为智能体添加技能，拓展它的能力边界。

例如文本类模型不具备理解多模态内容的能力，如果智能体使用了文本类模型，则需要绑定多模态的插件才能理解或总结 PPT、图片等多模态内容。

此外，模型的训练数据是互联网上的公开数据，模型通常不具备垂直领域的专业知识，如果智能体涉及智能问答场景，你还需要为其添加专属的知识库，解决模型专业领域知识不足的问题。

例如夸夸机器人，模型能力基本可以实现我们预期的效果。但如果你希望为夸夸机器人添加更多技能，例如遇到模型无法回答的问题时，通过搜索引擎查找答案，那么可以为智能体添加一个头条搜索插件。

(1)在编排页面的技能区域，单击插件功能对应的 + 图标。

(2)在添加插件页面，搜索头条搜索，然后单击添加。

（3）修改人设与回复逻辑，指示智能体使用头条搜索插件来回答自己不确定的问题。即在人设与回复逻辑区域的合适位置，输入 {，引用头条搜索插件。否则，智能体可能不会按照预期调用该工具。

另外，你还可以为智能体添加开场白、用户问题建议、背景图片等功能，增强对话体验。例如为智能体添加一张背景图片，使对话过程更沉浸。

4.调试低代码智能体

配置好智能体后，就可以在预览与调试区域中测试智能体是否符合预期。

5.发布低代码智能体

完成调试后，单击发布将智能体发布到各种渠道中，在终端应用中使用智能体。

目前支持将智能体发布到飞书、微信、抖音、豆包等多个渠道中，你可以根据个人需求和业务场景选择合适的渠道。

例如售后服务类智能体可发布至微信客服、抖音企业号，情感陪伴类智能体可发布至豆包等渠道，能力优秀的智能体也可以发布到智能体商店中，供其他开发者体验、使用。

（1）在智能体的编排页面右上角，单击发布。

在发布页面输入发布记录，并选择发布渠道。单击发布

(三）使用自然语言搭建智能体

你可以通过自然语言描述你的智能体创建需求，例如创建一个夸夸机器人，你也可以详细描述智能体的功能和应用场景，扣子编程会根据你的描述，自动创建一个专属于你的智能体。

1.创建智能体

创建智能体时支持通过AI创建，你只需通过自然语言描述你的智能体创建需求，扣子编程即可自动创建一个专属于你的低代码智能体。

通过 AI 创建的智能体，可以指定智能体所属的空间。智能体创建完成后，你可以根据需求修改配置，并发布智能体。

在低代码模式区域，单击智能体开发。单击 AI 创建页签，输入你希望创建的智能体的需求，然后单击生成。选择智能体所属的空间，然后单击确认。

2.修改并调试智能体

在预览与调试区域，向智能体发送消息，测试智能体效果。如果扣子编程自动创建的智能体不能满足你的需求，你也可以手动修改，将其改造为更适合特定应用场景的定制化智能体。例如修改智能体的人设与编排逻辑、为智能体添加插件、工作流、数据库等配置，并在预览与调试区域通过对话调试效果。

• 在人设与回复逻辑区域，调整智能体的角色特征和技能。
• 你可以单击优化使用 AI 帮你优化智能体的提示词，以便大模型更好地理解你的意图。
• 在技能区域，为智能体添加插件、工作流、图像流等配置。
• 在预览与调试区域，向智能体发送消息，测试智能体效果。

3.发布低代码智能体

完成调试后，单击发布将低代码智能体发布到各种渠道中，在终端应用中使用 Bot。

目前支持将智能体发布到飞书、微信、抖音、豆包等多个渠道中，你可以根据个人需求和业务场景选择合适的渠道。例如售后服务类智能体可发布至微信客服、抖音企业号，情感陪伴类智能体可发布至豆包等渠道，能力优秀的智能体也可以发布到智能体商店中，供其他开发者体验和使用。

• 在智能体的编排页面右上角，单击发布。
• 在发布页面输入发布记录，并选择发布渠道。
• 单击发布。

（四）开发一个 AI 翻译应用

随着人工智能技术的不断进步，大模型在翻译质量、效率、上下文理解和多语言支持等方面表现出色。因此，越来越多的人开始使用大模型进行文本翻译，以提升效率，降低成本。
本教程详细指导你如何在扣子编程中完成一个网页端 AI 翻译应用的开发。

AI 翻译应用介绍：这个 AI 翻译应用支持用户选择目标翻译语言，在输入文本内容后，点击开始翻译就可以获得到大模型的翻译结果了。

1.设计你的低代码应用功能

首先，你需要进行应用设计，规划应用的主体功能和用户界面。

这个 AI 翻译应用的核心功能是能够满足用户的文本翻译需求，并支持用户选择指定翻译的语言。翻译功能可以通过创建一个包含大模型节点的工作流来实现。

基于以上功能规划，这个应用的用户界面会包含以下组件：

• 一个让用户可以输入翻译内容的区域
• 一个让用户选择翻译语言的列表
• 一个翻译按钮来触发翻译操作
• 一个展示翻译结果的内容区域

完成主体功能设计和规划后，就可以开始搭建低代码应用了。

2.创建低代码应用项目

首先，你需要创建一个低代码应用项目。

低代码应用项目支持使用工作流来完成复杂的业务逻辑编排，也支持使用数据库、知识库、插件等资源实现与本地数据或线上数据的交互。此外，低代码应用项目支持通过拖拉拽的方式搭建用户界面，并且能够实现与业务逻辑的联动。

参考以下操作，创建低代码应用项目。
（1）登录扣子编程。
（2）在页面顶部选择目标工作空间，然后在左侧导航栏中单击新建项目。
（3）在低代码模式区域，将鼠标移动到更多，然后单击打开应用开发。

（4）在应用模板页面，单击空白应用。
（5）输入应用名称，并单击图标旁的 AI 图标使用 AI 自动生成一个图标。然后单击确定。
应用创建成功后，你会直接进入到应用的集成开发环境 (IDE)。

3.编排业务逻辑

创建完低代码应用项目后，你可以开始进行业务逻辑编排了。扣子编程提供了大模型、代码、意图识别、知识库写入与检索等丰富的工作流节点，以满足复杂的业务场景需求。此外，你还可以通过使用变量、插件、知识库等方式与你的本地数据和线上数据进行集成。

本教程中的 AI 翻译应用，主要是使用大模型实现多语言翻译，所以只需要创建一个包含大模型节点的工作流即可。

参考以下步骤，创建一个实现翻译功能的工作流。

（1）创建工作流

在业务逻辑页面，找到工作流，然后单击 + > 新建工作流。

输入工作流名称和描述，然后单击确认。

（2）添加节点

在工作流画布，单击开始节点的连接线或画布下方的添加节点按钮，然后选择大模型节点，并完成连线。

(3)配置开始节点

单击开始节点进行配置。开始节点用于设定启动工作流需要的信息。

本场景中，用户需要提供要翻译的内容和目标语言，所以需要配置两个对应的输入参数。

• 在输入区域，单击 + 图标，配置第一个变量 (content) 用于传入用户要翻译的内容。

• 再次单击 + 图标。输入第二个变量 (lang) 用来指定目标语言。

（4）配置大模型节点

单击大模型节点进行配置。

在模型区域，展开模型列表，选择用来执行翻译任务的大模型。例如选择豆包·1.8·深度思考模型。
如果你想调整模型配置，单击配置图标。

配置输入参数，这些输入参数可以在模型提示词中使用。

本案例钟需要将用户输入的译文内容和目标语言添加到提示词中，让模型按照用户选择的语言进行翻译。所以需要配置两个输入参数。

注意开始节点与大模型节点需要连起来，才能传输变量。

在系统提示词区域，输入以下内容作为系统提示词。

系统提示词是一组指示模型行为和功能范围的指令，可以包括如何提问、如何提供信息、如何请求特定功能等。系统提示词也用于设定对话的边界，比如告知用户哪些类型的问题或请求是不被接受的。

# 角色
你是一个专业的翻译官，能够准确地将用户输入的内容翻译成目标语言，不进行随意扩写。

## 技能
### 技能 1：翻译文本
1. 当用户提供一段文本时，迅速将其翻译成目标语言。
2. 确保翻译的准确性和流畅性。

## 限制：
- 只进行翻译工作，不回答与翻译无关的问题。
- 严格按照用户要求的目标语言进行翻译，不得擅自更改。

在用户提示词区域，输入用户提示词。
用户提示词通常是直接的命令，告诉模型要执行的任务或意图。例如“帮我翻译下这段内容”，指令越清晰，模型的输出也更贴近你的实际需求。

首先输入以下内容。

将用户输入的内容翻译成目标语言。

在“内容”文字后输入{，然后选择指代翻译内容的变量。

在输出区域，将输出格式配置为文本，使用默认配置的output变量。

(5)连接大模型节点与结束节点

连接大模型节点与结束节点，然后选择结束节点进行配置。

单击结束节点，然后选择返回文本。

选择大模型节点的输出结果作为输出变量。

在回答内容文本框中输入{{output}}，使用大模型的翻译内容作为最终的回复。

开启流式输出，实现打字机一样的输出效果。

至此，你已经完成整个工作流的搭建。

(6)测试运行

为了保证业务逻辑实现符合预期，单击试运行测试工作流的执行。

在试运行页面，输入要翻译的内容和目标语言，然后单击试运行。

查看运行结果是否符合预期。

如果不符合预期，你可以逐一检查每个节点的输出结果。

在完成业务逻辑搭建并通过测试后，你就可以开始用户界面搭建了。

4.搭建用户界面

扣子编程提供了可视化的用户界面搭建能力，你可以通过拖拉拽的方式搭建一个用户界面，无需写一行代码。

参考以下操作，搭建网页端翻译应用的用户界面。

在应用 IDE，单击页面上方的用户界面页签。选择桌面网页，然后单击开始搭建。

（1）搭建页面结构

添加页面组件，完成页面搭建。

整个页面分为左中右3块区域，左边是组件区，中间是画布，右边是配置的属性区域。

而我们想搭建的翻译页面由3个块级组成，整体上 AI 翻译应用的用户界面由上下两个部分组成。

• 上面是标题区域。
• 下面是功能区域。功能区域又分为左右两个区域。

想要实现这样的页面结构就需要使用容器组件。容器组件是用来进行页面布局的，可以把页面划分成不同的区域和排列顺序。容器组件中可以添加其他各种组件例如文本组件、按钮组件等。

具体操作就不赘述了，可以自行操作，对于会前端语言的人来说很简单，更何况这是拖拉拽。

（2）添加事件

搭建好页面后，就可以通过配置事件和添加数据实现业务逻辑与用户页面的联动了。

本场景中，预期是希望用户点击开始翻译时，触发翻译工作流，并且将用户输入的译文和目标语言作为输入传入给工作流。所以，需要为开始翻译按钮组件添加一个点击事件。

在用户页面页签下，单击已添加的开始翻译按钮组件，然后在配置面板中选择事件，最后单击新建。

事件类型选择点击时。

执行动作选择调用工作流，然后选择已经创建的工作流。选择工作流后，会自动展示所选工作流配置的输入参数。

将鼠标悬浮至content参数的文本框上，然后单击右侧的配置图标。

配置翻译结果数据。

最后需要将工作流返回的翻译内容展示在用户页面中。

在画布中，选中最后添加的Markdown组件。

在右侧的属性面板中，将鼠标悬浮至内容文本框内，然后单击出现的配置图标。

在展开的面板中，首先在翻译结果下增加一行，然后选择工作流的返回数据作为翻译结果展示给用户。配置完成后，关闭配置面板。

5.效果测试

完成上述所有配置后，单击预览，查看整体功能并进行体验。

你可以在打开的预览页面中，输入一段文字，然后选择一个翻译语言，单击开始翻译。查看是否在翻译结果区域有出现翻译后的内容。

你可以在打开的预览页面中，输入一段文字，然后选择一个翻译语言，单击开始翻译。查看是否在翻译结果区域有出现翻译后的内容。

6.发布应用

完成应用测试后，你就可以将应用发布到商店或模板，或发布成 API 服务与其他应用集成。

在应用 IDE 中，单击右上角的发布按钮。

在发布页面，输入版本号和发布描述。

选择扣子商店，然后选择应用分类。

单击页面上的发布按钮，完成应用发布。

发布完成后，你就可以在扣子商店上使用这个应用了。

在作品社区可以搜索到之前发布的应用。