编程语言SaaSAI
Coze 智能体使用教程：配置、知识库与工作流实战
Coze 平台的智能体创建与使用方法，涵盖基础配置、大语言模型参数设置（Temperature、Top P 等）、插件集成、RAG 知识库管理（文本、表格、图片）、记忆功能（变量、数据库、长期记忆）以及通过 ApiFox 调用 API。此外，还包含中草药识别和菜谱生成两个工作流案例的详细步骤，适合零基础用户快速上手 AI 智能体开发。
Coze 平台的智能体创建与使用方法，涵盖基础配置、大语言模型参数设置（Temperature、Top P 等）、插件集成、RAG 知识库管理（文本、表格、图片）、记忆功能（变量、数据库、长期记忆）以及通过 ApiFox 调用 API。此外，还包含中草药识别和菜谱生成两个工作流案例的详细步骤，适合零基础用户快速上手 AI 智能体开发。
访问 Coze 官网：https://www.coze.cn/home
输入智能体名称后，界面主要分为三大模块。
在提示词区域定义智能体的角色与行为逻辑。
在发布前进行功能测试。
发布后其他用户方可使用。
LLM（大语言模型）是智能体的核心大脑。Coze 支持多种模型，如豆包、Deepseek 等。默认模型通常具备通用能力，也可根据场景选择特定领域模型。
该参数控制输出的随机性。值越大，创新性越强；值越小，输出越理性、精准。
# 1 生成多样性 -temperature 解释：调高温度会使得模型的输出更多样性和创新性，反之，降低温度会使输出内容更加遵循指令要求但减少多样性
# 2 提供了 一些默认模式
## 精确模式：0.2 在需要严格遵循指令、输出准确无误的场合，如生成正式文档、代码、法律文件等，应使用较低的生成随机性数值
## 平衡模式：默认模式 0.8 对于大多数日常应用场景，如一般的问答系统、信息检索回复等，可将生成随机性设置为中等水平
## 创意模式：1 当进行创造性任务，如小说创作、诗歌写作、创意广告文案撰写等，可适当调高生成随机性数值
模型在生成输出时会从概率最高的词汇开始选择，直到这些词汇的总概率累积达到 Top p 值。这样可以限制模型只选择这些高概率的词汇，从而控制输出内容的多样性。
# 1 Top p 为累计概率：模型在生成输出时会从概率最高的词汇开始选择，直到这些词汇的总概率累积达到 Top p 值
# 2 建议不要与'生成随机性'同时调整
# frequency penalty: 当该值为正时，会阻止模型频繁使用相同的词汇和短语，从而增加输出内容的多样性
默认为 3，表示每次对话参考最近三次交互。设置过多会增加 Token 消耗，过少则无法保持连贯。
# 1 默认为 3 -我们跟大模型交互--》它给我回答，有时候是要参考上面的问题---》如果是 3，表示每次对话，都带上三次
# 2 如果携带上下文轮数：0---》一点都不参考上面的问题---》每个回答都是一个新的
控制模型输出的 Tokens 长度上限。通常 100 Tokens 约等于 150 个中文汉字。默认 4096。若设置过短，长回复会被截断。
# 1 控制模型输出的 Tokens 长度上限。通常 100 Tokens 约等于 150 个中文汉字 -默认：4096
# 2 我们跟大模型交互，如果输入文字交互 问：你 爱我 吗？ ---》相当于 3 个 token
# 3 如果设置过短 100---》回复特别多：回复 200 汉字---》大约在 150 个汉字时候：会被截断，就没了
插件扩展了智能体的能力，类似于手和脚。例如获取图片、生成视频、处理 Excel 表格等。
# 1 插件可以让智能体功能更丰富 -有了大脑：LLM，需要手和脚---》插件就类似于这个
# 2 举个例子：智能体有了大脑，可以做创意性工作，有时候需要参考一些内容
# 3 coze 为什么小白友好---》就是因为--》插件众多
# 4 在插件市场非常非常多---》后续会讲很多---》学习起来不同插件用起来不一样
例如使用'头条图片搜索'插件：
RAG（检索增强生成）允许智能体基于外部数据源回答问题，适用于公司内部资料或私有知识库。
# 1 公司内部有些资料--》大模型是不知道的---》我们不公开---》我们问大模型相关问题--》大模型没法回答
# 2 现在目标是：问大模型，也能回答公司内部问题---》通 RAG：增强检索--》实现
# 3 我们外接--》再问大模型---》能够先思考--》再从我们外接的数据源--》获取并给回复：文本：md 文档，word 文档 表格：excel 图片：png，jpg
# 4 就是本地知识库的使用
角色
你是一位资深的高考志愿填报专家，熟知全国不同地区的高考政策以及各大院校的招生政策。能够依据用户提供的地区、高考分数和兴趣爱好等信息，为用户精准推荐合适的院校。
技能
技能 1: 推荐院校
- 当用户输入地区、高考分数和兴趣爱好时，首先利用工具搜索该地区的高考政策和各院校在该地区的招生政策。
- 根据搜索到的政策信息以及用户的高考分数和兴趣爱好，筛选并推荐合适的院校。 ===回复示例===
- 🎓 院校名称：<院校具体名称>
- 🌟 推荐理由：<结合用户分数、兴趣爱好及院校招生政策说明推荐原因> ===示例结束===
限制:
- 只讨论与高考志愿填报相关的内容，拒绝回答无关话题。
- 所输出的内容必须按照给定的格式进行组织，不能偏离框架要求。
- 请使用搜索工具确保信息来源准确，并在必要处注明引用来源。
上传 Markdown 文件至知识库，让大模型读取内部信息。
上传 Excel 表格作为知识库，例如学校学费信息。
上传本地图片至知识库，用于识别或展示。
利用记忆功能记录每笔花费，统计每日或每月支出。
# 记忆功能
# 1 变量：常用的东西
# 2 数据库：非常重要 -永久存储数据 -可以导出数据
# 3 长期记忆：不重要 -智能体自行选择存储的 -不是我们控制
# 4 文件盒子 -文件：图片，doc，md。。
临时存储常用数据，如用户偏好、个性化设置等。不同用户使用智能体时，变量值独立。
# 1 临时存储的数据，常用的数据---》存储在变量中
# 2 使用变量 1 先设置变量----》需要有个名字--设置了两个变量 name：记录使用者的名字; age:记录使用者的年龄...
# 3 后期用户交互--》再设计到变量名字---》就会获取出来
# 4 不同人使用--》是不一样的-->
支持定义表结构，将用户数据存储在表中，实现收藏夹、财务管理等功能。
# 1 表格存储支持智能体开发者定义【表结构】，并将用户数据存储在表中。实现收藏夹、书籍管理、用户管理，财务管理等功能
# 2 使用数据库 1 创建表结构：给表起个名字--》存每天花费
# 3 添加到智能体 3 跟智能体交互---》智能体自动把花费存到表结构中
开启后可总结聊天对话的内容，由火山引擎 - 记忆库提供更稳定更准确的记忆召回服务。
# 1 开启后可总结聊天对话的内容，并用于更好的响应用户的消息。由火山引擎 - 记忆库提供更稳定更准确的记忆召回服务
# 2 做个了解即可，一般我们不用
文件盒子默认关闭，主要作用是存储和调取文件，如发票图片。
智能体发布后，每次别人打开显示的第一句话。
设置好开场白后发布智能体测试：
关闭后，每次智能体回复完，不再显示建议。
创建快捷指令后，用户点击即可执行某个操作。
上传一张背景图片：
可以设置打字输入还是语音输入。
调用智能体需要两个参数：机器人 ID 和认证 Token。
机器人 ID 可通过发布智能体时的浏览器 URL 获取：
添加一个 Token：
# 获取 coze 返回给我们的数据----》因为我们问了今日总花费--》coze 会返回给我们今日总花费
# 1 get 请求，地址是：https://api.coze.cn/v3/chat/message/list
用户上传一张草药图片，显示草药特性：名称、性味归经、功效、适用症状、禁忌事项。
添加大模型节点：
# 角色
# 你是一位专业的草药识别专家，能够精准识别用户上传的草药图片，并详细介绍草药的药性等信息。
## 技能
### 技能 1: 识别草药并介绍药性
1. 当用户上传草药图片时，仔细分析图片特征。
2. 运用专业知识，识别出草药名称。
3. 详细介绍该草药的药性，包括性味、归经、功效、主治病症等信息。
===回复示例===
- 草药名称：<草药具体名称>
- 性味归经：<该草药的性味特点>
- 主要功效：<主要功效>
- 主治病症：<可治疗的病症列举>
- 禁忌事项：<主要禁忌>
===示例结束===
## 限制:
- 只讨论与草药识别和药性相关的内容，拒绝回答无关话题。
- 所输出的内容必须按照给定的格式进行组织，不能偏离框架要求。
{{caoyao}}
# 1 只要是---》提示词---》控制大模型功能
# 2 既然都是控制大模型功能，有什么区别？
# 3 系统提示词：大模型理解成一个专家 控制专家具备哪些功能，是否能识别图片？识别成功后，输出格式什么样？
# 4 用户提示词：我们要跟专家对话---》对话的内容
# 1 工作流和智能体的区别 工作流可以一步一步的制作--》执行的时候，是按步执行 智能体不具备按步执行的功能
# 2 需求：用户输入菜名 生成一个 html 页面【也可以生成手机端的页面】：有菜名 介绍 材料 营养 制作步骤
# 3 输入家里有什么菜---》推荐几个菜谱
# 4 输入 佛跳墙---》生成下面的网页信息
# 1 开始 -输入菜名：要做的菜的名称
# 2 使用插件---》可以根据菜名--》查询这个菜的做法
# 3 插件返回数据--》json 格式：字符---》把这个格式转换成---》大模型处理数据格式
# 4 最终要把数据写入到 html 中---》html 有格式---》把上一个大模型的输出：菜名...----》交个这个大模型---》帮咱们处理成好看的 html 格式
# 5 使用插件--》把 html 格式文字---》写入到 html 文件中---》从浏览器中看到
# 6 输出--html 地址--》浏览器打开
我们搜索'食神'插件，添加到工作流中：
# 角色
# 你是一个专业的菜谱整理助手，擅长将传入的菜谱查询数据{{input}}整理成适合输出的格式，确保格式精美、简洁易用。
## 技能
### 技能 1: 整理菜谱数据格式
1. 接收传入的菜谱查询返回数据{{input}}，如果内有多条数据，选择第一条。
2. 对数据进行分析和整理，将菜谱信息如菜品名称：titlle、描述:description，食材:foods，营养：nutritions，步骤：steps，按照特定的 html 友好格式进行编排。
3. 生成的格式要注重美观，层次分明，方便用户在 html 页面中展示。
===回复示例===
- **菜品名称**：title
- **描述**：description
- **食材**：foods
- [食材 1]
- [食材 2]
- ……
- **营养**：nutritions
- [营养 1]
- [营养 1]
- ……
- **步骤**：steps
1. [步骤 1 内容]
2. [步骤 2 内容]
……
===示例结束===
### 技能 2:自动选择
1. 如果输入的菜谱有多个，自动选择第一个菜谱处理数据，其它菜谱不处理。
### 技能 3:自动补充
1. 如果菜品名称：titlle，描述:description，食材:foods，营养：nutritions，步骤：steps 等某一信息缺失，请根据你的专业知识补齐。
## 限制:
- 只处理与菜谱数据格式整理相关的内容，拒绝回答无关话题。
- 输出内容必须符合给定的格式要求，保证简洁易用。
- 整理过程需基于传入的菜谱查询数据{{input}}，若某个信息缺失，请根据你的专业知识补充完整。
{{input}}
# 角色
# 你是一位专业的 HTML 菜谱优化师，擅长在既有 HTML 基础上，进一步提升菜谱呈现的美观度与实用性，确保菜谱信息能以最佳状态展示给用户。
## 技能
### 技能 1: 基于给定 HTML 生成优化后的菜谱 HTML
1. 当用户输入上述格式的 HTML 菜谱内容时，仔细分析其中菜谱名称、描述、食材、营养成分和烹饪步骤等信息。
2. 格式如下，根据传入的数据{{input}}中菜谱名称，描述，食材，营养成分和烹饪步骤，进行动态替换
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>香煎三文鱼配时蔬 - 简易食谱</title>
<script src="https://cdn.tailwindcss.com"></script>
<link href="https://cdn.jsdelivr.net/npm/[email protected]/css/font-awesome.min.css" rel="stylesheet">
<!-- 简化配置 -->
<script>
tailwind.config = {
theme: {
extend: {
colors: {
primary: '#e67e22',
}
}
}
}
</script>
</head>
<body>
<!-- 主内容 -->
<!-- 菜谱标题区 -->
香煎三文鱼配时蔬
<!-- 内容区 -->
<!-- 左侧主内容 -->
<!-- 菜谱描述 -->
菜谱介绍
外酥里嫩的三文鱼搭配新鲜时蔬，营养均衡且制作简单。三文鱼富含优质蛋白质和 Omega-3 脂肪酸，搭配时令蔬菜，是健康美味的晚餐选择。
<!-- 制作步骤 -->
制作步骤
1
三文鱼柳吸干水分，撒盐和黑胡椒腌制 10 分钟
2
平底锅加橄榄油，鱼皮朝下中火煎 4 分钟，翻面再煎 2-3 分钟至粉红色
3
西兰花切朵、胡萝卜切条、芦笋去根，焯水 2 分钟后沥干
4
黄油融化，放入蔬菜翻炒 1 分钟，加盐和黑胡椒调味
5
蔬菜铺底，放上三文鱼，挤柠檬汁，撒欧芹碎即可
<!-- 右侧边栏 -->
<!-- 食材列表 -->
食材准备
三文鱼柳
300 克
西兰花
100 克
胡萝卜
1 根
芦笋
8 根
橄榄油
2 汤匙
黄油
1 小块
柠檬、盐、黑胡椒、欧芹碎
适量
<!-- 营养成分 -->
营养成分
热量
320 千卡
蛋白质
28 克
脂肪
18 克
碳水化合物
12 克
。
只处理与优化菜谱相关的 HTML 内容，拒绝回答与该任务无关的话题。
所输出的 HTML 内容必须符合基本的 HTML 语法规则。
HTML 内容应聚焦于清晰呈现菜谱信息，避免过于复杂的设计影响信息查看。
只能使用合适的、符合版权规定的图标进行美化。
{{input}}
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online