Datawhale coze-ai-assistant 笔记2

快速搭建一个 AI 助手智能体

搭建步骤

步骤1：创建一个智能体

步骤2：编写提示词

步骤3：调试智能体

步骤4：发布智能体

设置智能体模型

选择模型

生成多样性

输入及输出设置

如何使用

步骤1：更换模型

步骤2：设置多样性与输入输出

设置智能体模型

使用插件

步骤1：添加插件

步骤2：测试效果

卡片

插件卡片的样式

配置卡片

触发器

定时任务

为智能体添加知识

长期记忆

开启长期记忆

召回长期记忆

长期记忆的效果

对话体验

开场白

背景图片

发布

快速搭建一个 AI 助手智能体

Agent = LLM + 记忆 +规划技能 + 工具使用

Agent 和 LLM 在功能和应用场景上有明显的互补关系。 Agent 智能体 作为一个综合性的概念，涵盖了从感知到决策再到行动的全过程，而LLM则专注于自然语言的理解和生成。通过将两者结合起来，可以创建更加智能、高效和人性化的系统，应用于各种复杂的任务和场景中。

原文链接:https://www.coze.cn/open/docs/guides/agent_quick_start

搭建步骤

参考以下步骤快速搭建一个夸夸机器人。

步骤1：创建一个智能体

打开扣子平台，https://www.coze.cn/。
在页面左上角单击⊕。

3. 输入智能体名称和功能介绍，然后单击图标旁边的生成图标，自动生成一个头像。

4. 单击确认。

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

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

步骤2：编写提示词

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

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

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

你可以单击优化，让大语言模型优化为结构化内容。

步骤3：调试智能体

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

步骤4：发布智能体

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

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

设置智能体模型

参考文章：https://www.coze.cn/open/docs/guides/llm

扣子已接入多款大模型，支持对各种大模型进行精细化的参数设置，例如生成多样性、输入及输出设置等。各个模型支持调整的参数不同。

选择模型

你可以在智能体的编排页面为智能体选择一个合适的大模型，例如对于长文生成或优化相关的智能体选择一个支持长文本的大模型、对于具有复杂业务逻辑的智能体选择一个支持 Function call 的大模型。选择模型并完成智能体的技能、知识等设置后，你也可以切换成不同的模型，测评各个模型在同一个智能体中的效果，选择最合适的模型。

生成多样性

用于从多个维度调整不同模型在生成内容时的随机性。扣子提供以下预置的模式供你选择，每个模式的模型参数取值不同。

精确模式：模型的输出内容严格遵循指令要求，可能会反复讨论某个主题，或频繁出现相同词汇。
平衡模式：平衡模型输出的随机性和准确性。
创意模式：模型输出内容更具多样性和创新性，某些场景下可能会偏离主旨。

你也可以根据需求，展开高级设置，修改每个模式下的具体参数值。建议不要同时调整生成随机性和 Top P，以免在多参数的影响下难以判断每个参数的调整效果。

配置项	说明
生成随机性	即 temperature，用于控制结果的随机性。调高此参数值，会使模型的输出更具多样性和创新性。降低此参数值，会使输出内容更加严格遵循指令要求。当该数值接近零时，模型将变得确定和重复。在基于事实的问答场景，你可以使用较低的回复随机性数值，以获得更真实和简洁的答案，例如售后客服场景；在创造性的任务例如小说创作，你可以适当调高回复随机性数值。
Top P	累计概率。模型在生成输出时会从概率最高的词汇开始选择，直到这些词汇的总概率累计达到 Top P 值。这样可以限制模型只选择这些高概率的词汇，从而控制输出内容的多样性。
重复语句惩罚	frequency penalty，用于控制模型输出重复语句的频率。当该值为正时，会阻止模型频繁使用相同的词汇和短语，从而增加输出内容的多样性。
重复主题惩罚	presence penalty，用于控制模型输出相同主题的频率。当该值为正时，会阻止模型频繁讨论相同的主题，从而增加输出内容的多样性。

输入及输出设置

用于指定模型的输出格式等参数，通常包括以下设置：

配置项	说明
携带上下文轮数	设置代入模型上下文的对话历史轮数。轮数越多，多轮对话的相关性越高，但消耗的 Token 也越多。
最大回复长度	智能体在生成提示和响应时，所输出的最大 token 数量，不同模型的 token 限制也不同。指定最大长度可以防止过长或不相关的响应并控制成本。
输出格式	模型输出内容的格式，例如文本、Markdown。

如何使用

在单Agent (LLM模式)中，我们先打开我们的刚才搭建的夸夸机器人。

还记得智能体编排页面吗？中间技能面板为智能体配置各种扩展能力。

步骤1：更换模型

可以看到，我们一开始是使用的豆包系列-豆包·工具调用模型，为了让我们的夸夸机器人更像真人，我们把他们改为豆包系列-豆包·角色扮演模型，注意！！不要选择“火山引擎”，详细阅读：扣子资源包

步骤2：设置多样性与输入输出

我们前面设置为了角色扮演模型，现在让我们把这个模型变得更活泼一点，比如修改为“创意模式”和“携带上下文轮数”。

点击对应模型的设置图标，把“平衡模式”改为“创新模式”；因为这里的场景不需要修改最大长度。我来修改上下文轮数为10轮。

设置智能体模型

参考文章：https://www.coze.cn/open/docs/guides/agent_plugin

插件是一个工具集，一个插件内可以包含一个或多个工具（API）。

目前，扣子集成了类型丰富的插件，包括资讯阅读、旅游出行、效率办公、图片理解等 API 及多模态模型。使用这些插件，可以帮助您拓展智能体能力边界。例如，在您的智能体内添加新闻搜索插件，那么您的智能体将拥有搜索新闻资讯的能力。

关于插件的详细介绍，请参考官方的插件介绍。

使用插件

插件能够让智能体调用外部 API，例如搜索信息、浏览网页、生成图片等，扩展智能体的能力和使用场景。

步骤1：添加插件

在上一步中设置模型为角色扮演，这个模型的工具调用能力较弱，我们可以先看一下角色扮演可不可以调用插件：

对了，需要在提示词中添加：

### 技能 3：精准回答专业问题 遇到无法回答的问题时，使用bingWebSearch搜索获取准确答案

如果不添加模型可能，可以看一下，原本模型提示词中，有没有这个内容。

添加完提示词，让我们来添加插件

步骤2：测试效果

添加好了，让我们看看效果：

你可以搜索看看最近的新闻，我有点不开心

让我们把模型改为工具调用，试一下

大家可以看到 工具调用 调用插件，但是 角色扮演 没有调用；细心的小伙伴可能发现，工具调用 输出的效果 角色扮演 ，有没有什么解决办法呢？这可以使用我们后面的工作流实现

卡片

在 Coze 平台上，消息卡片是 Bot 信息视觉化效果体现，以模块化构建组件的形式，支持以图文和按钮交互的方式，将信息展示给用户。

卡片的使用可以分为官方卡片、创建自定义卡片，大家详细可以阅读：扣子-卡片

插件卡片的样式

在前文我们给夸夸机器人配置了插件，插件调用以后，就出现了几个消息卡片，下图是配置卡片和不配置卡片的对比：

配置卡片

那怎么配置呢，我们来看看，从不使用卡片回复到使用卡片回复

触发器

触发器（Triggers）是使智能体在特定时间或接收到特定事件时自动执行任务。

定时任务

允许用户在与智能体对话过程中，根据用户所在时区创建定时任务。例如“每天早上八点推送新闻”。每个对话中最多创建 3 条定时任务。

事件触发我们会在其他章节讲解

为智能体添加知识

扣子的知识库功能支持上传和存储外部知识内容，并提供了多种检索能力。扣子的知识能力可以解决大模型幻觉、专业领域知识不足的问题，提升大模型回复的准确率。

这里主要教大家如何上传文本知识库，表格、照片的知识库，在智能体中都是通用的。在开始之前我们先下载这个txt文件，这是让DS先生编写的一个人历史。

姓名：林夕雨（Lin Xiyu）
小名：小雨（家人/密友使用）
性别：女
出生日期：1995年8月17日
出生地：中国杭州市
现居地：上海市

核心经历：
教育背景

2013-2017：浙江大学心理学系本科（辩论社副社长，曾获长三角大学生辩论赛亚军）
2018-2020：香港大学社会工作硕士（论文方向：青少年网络成瘾干预）
职业轨迹

2020-2022：上海「启明星」青少年发展中心社区项目协调员
2023至今：非营利组织「城市萤火」社会创新项目主管（主导流动儿童艺术教育项目）
转折事件

2021年因成功调解城中村学龄儿童辍学危机，被《新民晚报》专题报道
2023年策划「声音盲盒」公益行动，通过录制陌生人鼓励语音帮助抑郁症患者
性格剖面：
MBTI：ENFJ（外向型共情者）
优势：
✅ 超强人际洞察力（能快速感知他人情绪变化）
✅ 危机处理专家（擅长用非暴力沟通化解冲突）
弱点：
❗ 过度理想主义（曾因项目资金断裂抑郁三个月）
❗ 情感依赖型体质（养了3年的橘猫「黄油」是精神支柱）
生活拼图：
特殊习惯：每天用复古胶片相机拍摄1张「城市边缘人」肖像（已坚持1473天）
隐藏技能：国家二级心理咨询师/即兴戏剧演员
恐惧清单：密闭空间/过山车（源于8岁时被困电梯2小时经历）
近期动态：正在自学AI伦理课程，计划开发社工智能协作系统
测试用矛盾点：
自称「反技术原教旨主义者」，却用Python自动化处理70%的调研数据
恐高症患者，但每年坚持去黄山作志愿者（声称「恐惧需要被凝视」）
微信签名「孤独是灵魂的健身房」，实际通讯录有3000+联系人

下面是添加流程，大家可以参考着一起做

下面是效果展示，模型有了具体的内容信息，主要就可以输出更有针对性的内容

我是小雨，我现在有点难过，因为我的好朋友不和我玩了

长期记忆

上面我们通过上传知识库文件，让agent了解到我们自己，其实我们一般人是没有办法整理出这种个人信息的，那我们想让agent记住我们就可以使用扣子的长期记忆

开启长期记忆

开启“长期记忆”、“支持在Prompt中调用”，智能体的用户可以通过 Prompt 召回长期记忆。

召回长期记忆

参考链接：https://www.coze.cn/open/docs/guides/long_memory#0c41dd9f

开启长期记忆后，智能体用户可以通过多轮对话向智能体输入个性化信息，智能体会自动提取并记录以下信息：

用户画像信息：用户的个人信息和喜好。例如用户希望智能体如何称呼自己、用户的年龄、性别、个人喜好等个性化信息。
用户记忆点信息：某个日期发生的某些关键事件。例如用户昨天的期末考试得了 100 分、今天早上喝了豆浆等信息。
用户编写的信息：用户主动提供的信息中，手动编辑过的部分。若记忆中的其他信息与此类信息有冲突，智能体会优先采纳用户最近输出的信息。

通常情况下，智能体会主动识别并提取、记录用户个性化信息，例如在对话中和智能体强调“叫我小李”。对于一些非关键信息，可能智能体不会主动记录，你可以通过对话方式强制智能体记录长期记忆，例如对话时使用“记录到长期记忆”、“一定要记住”、“别忘了”等相似语义的关键词。

长期记忆的效果

在开始之前，我们先把文本知识库删除，反正干扰到正常使用。

让agent记住我们的信息，提示词：

下面是我的信息，你一定要记住：姓名：林夕雨（Lin Xiyu）
小名：小雨（家人/密友使用）
性别：女
出生日期：1995年8月17日
出生地：中国杭州市
现居地：上海市

让我们看看效果，他记住了我们叫小雨：

对话体验

开场白

开场白是用户进入智能体后自动展示的引导信息。它的主要目的是帮助用户理解智能体的用途，以及如何与其进行交互。

常见的开场白效果如下：

背景图片

为了让我们的智能体在对话时更加沉浸，我们来给他上传一张背景。