一、搭建智能体
扣子利用大语言模型极大地简化了智能体的搭建过程。 在充分利用大语言模型优势的同时，扣子还支持用户通过知识库、工作流等功能来配置智能体如何响应用户查询，以保证智能体的回复符合预期。
1、创建一个智能体
（1）登录扣子开发平台
在扣子登录页面中输入你的邮箱和密码。如果是第一次使用扣子，直接点击"注册"按钮，会自动注册账号并且登录开发平台；如果已经注册过，输入邮箱和密码后，点击"登录"按钮即可。
（2）在页面左上角单击 ⊕，并选择创建智能体
（3）输入智能体名称和功能介绍，点击下方图标选择自己图标上传（可选）
（4）单击确认。
创建智能体后，你会直接进入智能体编排页面。你可以：
- 在左侧人设与回复逻辑面板中描述智能体的身份和任务。
- 在中间技能面板为智能体配置各种扩展能力。
- 在右侧预览与调试面板中，实时调试智能体。
（5）模型选择
在中间面板的上方，你可以为智能体选择大模型，目前Coze Studio 支持的模型服务如下：
- 火山方舟 | Byteplus ModelArk
- OpenAI
- DeepSeek
- Claude
- Ollama
- Qwen
- Gemini
注意：第一次使用扣子的用户，此时的大模型可以选择，但是不能进行使用。需要在后端模型配置文件中配置模型服务的API Key与模型名称后才可以使用大模型。而API Key是需要自己进入模型的官网中注册账号申请的。
模型配置操作
1、打开项目实例页面，进入文件管理页面
打开/coze-studio/backend/resources/conf/目录下的model文件夹，已经将常用大模型的配置文件放入
2、打开需要使用的大模型的配置文件，修改文件中的 meta.conn_config.api_key、meta.conn_config.model 字段（需要自己进入模型的官网中注册账号申请），保存文件
- 以doubao-seed-1.6模型为例
- 通过下方网址进入火山引擎获取API Key页面，登录账号后进入"API Key 管理"页面，创建API Key后将其复制到meta.conn_config.api_key字段
https://www.volcengine.com/docs/82379/1541594
- 通过下方网址进入火山引擎获取 Endpoint ID页面，登录账号后进入"方舟控制台-在线推理"页面，创建推理接入点后将接入点名称（id）复制到meta.conn_config.model字段
https://www.volcengine.com/docs/82379/1099522
- 最后保存文件
3、回到项目实例页面，进入WebSSH页面 - 使用./sj-run.sh -t 停止程序；
<span style="color: red;">（注意：代码块的右上角有一键复制代码的功能）
arduino
./sj-run.sh -t- 使用./sj-run.sh -s 可以启动程序，如果 8080 端口已有程序在运行，可以选择是否继续启动其他端口。
<span style="color: red;">（注意：代码块的右上角有一键复制代码的功能）
arduino
./sj-run.sh -s- 重启程序后，通过对外开放端口获取访问地址，将获取到的链接复制到本地浏览器重新进入 coze-studio 页面
- 进入刚刚创建的智能体编排页面中，选择doubao-seed-1.6模型就可以使用了
2、编写提示词
配置智能体的第一步就是编写提示词，也就是智能体的 人设与回复逻辑 。智能体的人设与回复逻辑 定义了智能体的基本人设，此人设会持续影响智能体在所有会话中的回复效果。建议在人设与回复逻辑中指定模型的角色、设计回复的语言风格、限制模型的回答范围，让对话更符合用户预期。
在智能体配置页面的人设与回复逻辑面板中输入提示词，通用的结构可以设置为：
你也可以单击提示词库，里面有常用的几种模版供选择：
3、为智能体添加技能（可选）
如果模型能力可以基本覆盖智能体的功能，则只需要为智能体编写提示词即可。但是如果你为智能体设计的功能无法仅通过模型能力完成，则需要为智能体添加技能，拓展它的能力边界。
1、在编排页面的技能 区域，单击插件 功能对应的 + 图标。
2、在添加插件 页面，搜索需要添加的插件 ，然后单击 添加 。
3、修改人设与回复逻辑，指示智能体使用添加的插件来回答自己不确定的问题。否则，智能体可能不会按照预期调用该工具
另外，你还可以为智能体添加开场白、用户问题建议、背景图片等功能，增强对话体验。例如为智能体添加一张背景图片，使对话过程更沉浸。
4、调试智能体
配置好智能体后，就可以在预览与调试区域中测试智能体是否符合预期。
二、搭建应用
注意目前开源的版本只能进行工作流的创建，没有提供搭建可视化用户界面的功能
1、创建 AI 应用项目
AI 应用项目支持使用工作流来完成复杂的业务逻辑编排，也支持使用数据库、知识库、插件等资源实现与本地数据或线上数据的交互。
（1）登录扣子开发平台
（2）在页面左上角单击 ⊕，并选择创建应用
（3）输入应用名称，应用介绍（可选），单击图标可在本地上传图片更换图标（可选）。然后单击确认
应用创建成功后，你会直接进入到应用的集成开发环境 (IDE)。
2、编排业务逻辑
创建完 AI 应用项目后，你可以开始进行业务逻辑编排了。扣子 提供了大模型、代码、意图识别、知识库写入与检索等丰富的工作流节点，以满足复杂的业务场景需求。此外，你还可以通过使用变量、插件、知识库等方式与你的本地数据和线上数据进行集成。
下面通过AI翻译的应用向用户演示，主要是使用大模型实验多语言翻译，所以只需要创建一个包含大模型节点的工作流即可。
参考以下步骤，创建一个实现翻译功能的工作流。
（1）创建应用成功后进入页面，找到工作流，然后单击 + ** > ** 新建工作流 。
（2）输入工作流名称和说明，然后单击 确认 。
注意工作流名称只支持字母、数字和下划线，且必须以字母开头。
（3）在工作流画布，单击开始 节点的连接线或画布下方的添加节点 按钮，然后选择大模型节点，并完成连线。
（4）单击开始节点进行配置。（开始节点用于设定启动工作流需要的信息）
- 在输入区域，配置第一个变量 (content) 用于传入用户要翻译的内容。
- 单击 **+ **图标。输入第二个变量 (lang) 用来指定目标语言
（5）单击大模型节点进行配置。
- 在模型区域，展开模型列表，选择用来执行翻译任务的大模型。本次演示中选择**Doubao-Seed-1.6 **模型
- 配置输入参数，这些输入参数可以在模型提示词中使用。
本次演示中需要将用户输入的译文内容和目标语言添加到提示词中，让模型按照用户选择的语言进行翻译。所以需要配置两个输入参数。
单击输入 区域的 + 图标，然后点击对应的设置图标，选择开始节点中配置的变量。
重复上述操作，再添加目标语言的这个变量。
删除不需要的输入信息，确保输入中只包含下图中的这两个参数。
- 在系统提示词 区域，输入以下内容作为系统提示词。
系统提示词是一组指示模型行为和功能范围的指令，可以包括如何提问、如何提供信息、如何请求特定功能等。系统提示词也用于设定对话的边界，比如告知用户哪些类型的问题或请求是不被接受
markdown
# 角色
你是一个专业的翻译官，能够准确地将用户输入的内容翻译成目标语言，不进行随意扩写。
## 技能
### 技能 1：翻译文本
1. 当用户提供一段文本时，迅速将其翻译成目标语言。
2. 确保翻译的准确性和流畅性。
## 限制：
- 只进行翻译工作，不回答与翻译无关的问题。
- 严格按照用户要求的目标语言进行翻译，不得擅自更改。
- 在用户提示词区域，输入用户提示词。
用户提示词通常是直接的命令，告诉模型要执行的任务或意图。例如"帮我翻译下这段内容"，指令越清晰，模型的输出也更贴近你的实际需求。
首先输入以下内容。
将用户输入的内容翻译成目标语言。因为不同用户提供的翻译内容，选择的目标语言都不同，所以需要将译文内容和目标语言使用输入变量来指代，这样就可以在运行时替换成真实的用户需求
在"内容"文字后输入{，然后选择指代翻译内容的变量。
说明如果你没有可用的变量，请检查是否按照教程配置了模型节点的输入变量。
重复上述方法，添加目标语言变量。
- 在输出 区域，将输出格式 配置为 文本 ，使用默认配置的 output 变量。
（6）选择结束节点进行配置
单击结束 节点，然后选择 返回文本 。
选择大模型节点的输出结果作为输出参数。
在回答内容文本框中输入{{output}}，使用大模型的翻译内容作为最终的回复。
开启 流式输出 ，实现打字机一样的输出效果。
至此，你已经完成整个工作流的搭建。
（7）为了保证业务逻辑实现符合预期，单击试运行测试工作流的执行。
（8）在试运行 页面，输入要翻译的内容和目标语言，然后单击试运行
（9）查看运行结果是否符合预期。
如果不符合预期，你可以逐一检查每个节点的输出结果。
