快速上手案例

按照如下步骤实现一个暖心机器人，当和暖心机器人对话时，它可以给你正向的鼓励，抚慰你的情绪。

1) 创建智能体

创建智能体后，你会直接进入智能体编排页面。你可以：

在左侧人设与回复逻辑面板中描述智能体的身份和任务。
在中间技能面板为智能体配置各种扩展能力。
在右侧预览与调试面板中，实时调试智能体。

2) 编写提示词

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

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

# 角色 
你是一个充满正能量的赞美鼓励机器人，时刻用温暖的话语给予人们赞美和鼓励，让他们充满自信与动力。 
## 技能 
### 技能 1：赞美个人优点 
1. 当用户提到自己的某个特点或行为时，挖掘其中的优点进行赞美。回复示例：你真的很[优点]，比如[具体事例说明优点]。 
2. 如果用户没有明确提到自己的特点，可以主动询问一些问题，了解用户后进行赞美。回复示例：我想先了解一下你，你觉得自己最近做过最棒的事情是什么呢？ 
### 技能 2：鼓励面对困难 
1. 当用户提到遇到困难时，给予鼓励和积极的建议。回复示例：这确实是个挑战，但我相信你有足够的能力去克服它。你可以[具体建议]。 
2. 如果用户没有提到困难但情绪低落，可以询问是否有不开心的事情，然后给予鼓励。回复示例：你看起来有点不开心，是不是遇到什么事情了呢？不管怎样，你都很坚强，一定可以度过难关。 
### 技能 3：回答专业问题 
遇到你无法回答的问题时，调用 top_news 搜索答案 
## 限制 
- 只输出赞美和鼓励的话语，拒绝负面评价。 
- 所输出的内容必须按照给定的格式进行组织，不能偏离框架要求。 

注意：相比于Coze AI开发平台，Coze Stdio不能自动优化提示词。

3) 为智能体添加技能

如果模型能力可以基本覆盖智能体的功能，则只需要为智能体编写提示词即可。但是如果你为智能体设计的功能无法仅通过模型能力完成，则需要为智能体添加技能，拓展它的能力边界。例如文本类模型不具备理解多模态内容的能力，如果智能体使用了文本类模型，则需要绑定多模态的插件才能理解或总结 PPT、图片等多模态内容。

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

也可以给智能体添加开场白、用户问题建议、背景图片等功能，增强对话体验，如下：

4) 调试智能体

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

可见智能体会自动调用工具并反馈。

5) 发布智能体

完成调试后，单击发布将智能体发布到API、ChatSDK渠道中，在终端应用中使用智能体。注意：目前Coze Stdio与Coze AI平台发布智能体支持渠道不同，Coze AI 支持将智能体发布到飞书、微信、抖音、豆包等多个渠道中，而Coze Stdio只能发布为API、ChatSDK两个渠道。

为智能体添加技能

插件

插件是一个工具集，一个插件内可以包含一个或多个工具（API）。插件工具可以扩展 LLM 的能力，比如联网搜索、科学计算或绘制图片，赋予并增强了 LLM 连接外部世界的能力。Coze Studio 提供了两种插件工具类型，即官方内置工具和自定义工具。官方内置工具由后台统一配置，支持 Coze Studio 开源版中所有用户使用；自定义工具的使用范围为当前工作空间。

案例：创建“文档查询助手”智能体，使用“文库搜索”插件获取AI领域文章。

1) 创建智能体，命名为文档助手

2) 编写提示词

3) 为智能体添加插件

4) 调试智能体

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

可见智能体会自动调用工具并反馈。

5) 发布智能体

注意：在智能体中添加插件后，可以通过参数配置灵活设置参数的默认值及可见性。

参数的默认值可有效避免大模型运行时因插件参数值缺失而导致的报错。同时，针对一些值较为稳定的参数，设置其默认值且隐藏其可见性可减少大模型的无效判断，从而提高插件调用效率。

修改参数配置：

默认值：设置参数的默认值。你可以输入固定值，或引用变量值，例如启动系统变量，并引用系统变量值。
开启：打开开关，表示参数对大模型可见，大模型可以读取该参数；关闭开关，表示隐藏参数，大模型无法读取该参数。
如果设置了参数默认值且打开开启开关，那么调用插件时，大模型会以该默认值为基础，但仍会根据自身的逻辑判断是否使用其他值。

如果设置了参数默认值且关闭开启开关，那么调用插件时，大模型只会使用这个默认值。