Coze 智能体实战初体验
访问 Coze 官网进入工作台,创建你的第一个智能体。


输入智能体名称后,界面主要分为三大模块:

1. 写提示词
这是智能体的核心。通过设定角色、技能和限制,告诉 AI 如何思考。



2. 预览与发布
配置完成后,先点击预览测试效果。确认无误后,必须发布才能被他人使用。

发布流程如下:


Coze 平台提供了低代码构建 AI 智能体的能力。本文涵盖基础配置、插件应用、知识库(RAG)、记忆管理及 API 调用。通过中草药识别和菜谱生成两个工作流案例,演示了如何串联节点实现复杂任务。重点解析了系统提示词与用户提示词的区别,以及变量、数据库在长期记忆中的应用。适合希望快速上手智能体开发的开发者参考。

访问 Coze 官网进入工作台,创建你的第一个智能体。


输入智能体名称后,界面主要分为三大模块:

这是智能体的核心。通过设定角色、技能和限制,告诉 AI 如何思考。



配置完成后,先点击预览测试效果。确认无误后,必须发布才能被他人使用。

发布流程如下:



Coze 支持多种模型,如豆包(字节跳动自研)、Deepseek(开源)等。选择不同模型相当于切换不同的'大脑',默认模型通常在各领域表现均衡。

该参数控制输出的随机性。值越高,创意越强但可能不稳定;值越低,输出越理性精准。
# 示例配置逻辑
温度调高 -> 创意性强(感性)-> 适合写作、诗歌
温度调低 -> 理性强(理性)-> 适合写代码、正式文档
Top P 用于限制模型选择词汇的概率范围。建议不要与 Temperature 同时大幅调整,以免产生不可控的输出。
当值为正时,会减少模型频繁使用相同词汇或短语的频率,增加文本多样性。
默认为 3 轮。这决定了模型能记住多少之前的对话历史。轮数越多,上下文越连贯,但消耗的 Token 也越多,成本相应增加。
控制模型输出的 Tokens 上限。默认通常为 4096。如果设置过短,长内容会被截断。需注意 Coze 的免费额度有限,过度消耗可能导致需要付费购买点数。
插件是智能体的'手脚',扩展了 LLM 的能力边界。
LLM 擅长处理信息,但无法直接联网搜索或操作外部工具。插件可以获取图片、生成视频、处理 Excel 表格等。
以'头条图片搜索'为例,在插件市场添加后即可在对话中调用。




针对公司内部资料或未公开数据,大模型本身并不知晓。通过 RAG(检索增强生成),我们可以外挂知识库来解决这个问题。
支持的知识类型包括:
在引入知识库前,先设定好提示词,明确智能体应优先检索知识库中的信息。
# 角色
你是一位资深的高考志愿填报专家...
## 技能
### 技能 1: 推荐院校
1. 当用户输入地区、高考分数...首先利用工具搜索该地区的高考政策...
2. 根据搜索到的政策信息以及用户的高考分数和兴趣爱好,筛选并推荐合适的院校。
===回复示例===
- 🎓 院校名称:<院校具体名称>
- 🌟 推荐理由:<结合用户分数、兴趣爱好及院校招生政策说明推荐原因>
===示例结束===
## 限制:
- 只讨论与高考志愿填报相关的内容...
- 所输出的内容必须按照给定的格式进行组织...

对于网上搜不到的冷门院校信息,直接上传内部 Markdown 文档至知识库即可。










上传 Excel 表格可查询学费等结构化数据;上传图片则需标注标签以便识别。







图片知识库同样支持批量上传与管理。











本地知识库的管理入口如下:

要实现记账本等功能,需要利用记忆系统。
变量用于存储会话级别的临时状态。例如记录使用者的名字和年龄。




对于记账本这类需求,变量不足以支撑大量历史记录,必须使用数据库。






长期记忆适合需要跨天回忆的场景,文件盒子则用于管理非结构化文件。











API 调用前,必须先发布智能体。

需要两个关键参数:机器人 ID 和认证 Token。
机器人 ID 可从发布后的 URL 获取:


添加 Token:


使用 GET 请求调用接口 https://api.coze.cn/v3/chat/message/list。



获取返回数据:



用户上传草药图片,系统需识别名称、性味归经、功效等信息,并格式化输出。



添加大模型节点,设定其为中草药识别专家。



# 角色
你是一位专业的草药识别专家,能够精准识别用户上传的草药图片,并详细介绍草药的药性等信息。
## 技能
### 技能 1: 识别草药并介绍药性
1. 当用户上传草药图片时,仔细分析图片特征。
2. 运用专业知识,识别出草药名称。
3. 详细介绍该草药的药性,包括性味、归经、功效、主治病症等信息。
===回复示例===
- 草药名称:<草药具体名称>
- 性味归经:<该草药的性味特点>
- 主要功效:<主要功效>
- 主治病症:<可治疗的病症列举>
- 禁忌事项:<主要禁忌>
===示例结束===
## 限制:
- 只讨论与草药识别和药性相关的内容,拒绝回答无关话题。
- 所输出的内容必须按照给定的格式进行组织,不能偏离框架要求。

{{caoyao}}

注意:系统提示词定义 AI 的'底层操作系统'(角色、规则),用户提示词则是具体的'动态指令'(任务内容)。




搜索并添加'食神'插件。



# 角色
你是一个专业的菜谱整理助手,擅长将传入的菜谱查询数据整理成适合输出的格式。
## 技能
### 技能 1: 整理菜谱数据格式
1. 接收传入的菜谱查询返回数据,如果内有多条数据,选择第一条。
2. 对数据进行分析和整理,将菜品名称、描述、食材、营养、步骤编排为美观格式。
===回复示例===
- **菜品名称**:title
- **描述**:description
- **食材**:foods
- **营养**:nutritions
- **步骤**:steps
===示例结束===
## 限制:
- 只处理与菜谱数据格式整理相关的内容。
- 输出内容必须符合给定的格式要求。
{{input}}

# 角色
你是一位专业的 HTML 菜谱优化师,擅长在既有 HTML 基础上进一步提升菜谱呈现的美观度。
## 技能
### 技能 1: 基于给定 HTML 生成优化后的菜谱 HTML
1. 当用户输入上述格式的 HTML 菜谱内容时,仔细分析其中菜谱名称、描述、食材等信息。
2. 根据传入的数据动态替换模板中的占位符。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>香煎三文鱼配时蔬</title>
<!-- Tailwind CSS 等样式引用 -->
</head>
<body>
<!-- 主内容区 -->
</body>
</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