智能体手册
大约 18 分钟教学文档Python基础
📚 Coze智能体培训·学员手册
📋 使用说明：本手册分为上午/下午两册，建议打印或保存至本地，培训过程中随时查阅记录。每模块含「核心要点+实操步骤+自查清单」，助你高效掌握Coze智能体开发技能。
🌅 上午场学员手册（8:00-12:00）
基础搭建与核心配置
👤 学员姓名：_____________ 📅 日期：_____________
🎯 今日目标：独立创建1个可运行的Coze智能体，掌握提示词配置+插件调用核心技能
📋 上午时间安排总览
| 时间 | 模块 | 核心产出 | 完成打勾 |
|---|---|---|---|
| 8:00-8:30 | 平台认知与环境准备 | 登录Coze+创建Bot编辑页 | □ |
| 8:30-9:30 | 智能体创建与人设配置 | 完成结构化提示词配置 | □ |
| 9:30-10:30 | 提示词工程深度实战 | 优化Bot实现固定格式输出 | □ |
| 10:30-10:45 | 茶歇交流 | - | - |
| 10:45-12:00 | 插件配置与能力扩展 | Bot成功调用2个官方插件 | □ |
🔹 模块一：平台认知与环境准备（8:00-8:30）
✅ 核心知识点速记
🧩 Coze智能体五大组件：
┌─────────────────────────┐
│ 🎭 人设提示词 → 定义"你是谁" │
│ 🧠 大模型基座 → 决定"怎么想" │
│ 🔌 插件能力 → 赋予"能做什么" │
│ 📚 知识库 → 补充"知道什么" │
│ 💭 记忆系统 → 实现"记得什么" │
└─────────────────────────┘
🎯 智能体 ≠ 聊天机器人：
✓ 有明确角色定位 ✓ 有工具调用能力 ✓ 有业务目标导向
🔧 实操步骤指引
Step1️⃣ 登录Coze平台
• 访问：https://www.coze.cn
• 使用手机号/字节账号登录
• ✅ 确认左上角显示个人工作空间
Step2️⃣ 创建第一个Bot
• 点击"创建Bot"按钮
• 填写：
- 名称：我的学习助手（示例）
- 描述：帮用户制定学习计划，提供方法建议
- 头像：上传预设素材或跳过
• 点击"创建"进入编辑页面
Step3️⃣ 熟悉界面布局
• 左侧：Bot列表/插件/知识库入口
• 中间：人设提示词编辑区（核心！）
• 右侧：实时预览对话窗口（测试用）
• 顶部：发布/设置/模型参数入口
📝 笔记区：_________________________________
⚠️ 常见问题FAQ
Q：创建Bot时名称重复怎么办？
A：系统会自动添加后缀，不影响使用，后续可在设置中修改
Q：预览区无法对话？
A：检查是否保存提示词，或刷新页面重试
Q：找不到插件入口？
A：在Bot编辑页中部，人设区域下方有"插件"标签页
🔹 模块二：智能体创建与人设配置（8:30-9:30）
✅ 核心知识点速记
📝 提示词四段式模板（推荐收藏）：
# 角色定义
你是一位[专业领域]专家，擅长[核心能力]，服务对象是[目标用户]。
# 任务目标
当用户[触发场景]时，你需要[具体行动]，最终帮助用户[达成价值]。
# 回复规范
- 语气风格：[亲切/专业/幽默]
- 输出格式：[分点/表格/Markdown]
- 长度控制：[简洁/详细/分步]
- 边界约束：[不回答/需转人工/需确认]
# 示例参考（Few-shot）
用户：[典型问题]
你：[标准回复]
🔧 实操步骤指引
Step1️⃣ 配置Bot基础信息
• 名称：≤10字，体现价值（如"周报生成器"）
• 描述：一句话说明能力+适用人群
• 头像：建议512×512px，体现角色特征
Step2️⃣ 编写人设提示词（关键！）
• 点击"人设与回复逻辑"编辑区
• 删除默认内容，粘贴四段式模板
• 按你的业务场景填充[ ]中内容
• ✅ 重点：角色要具体，任务要可执行
Step3️⃣ 设置开场白&快捷指令
• 开场白：3秒内说清价值+引导行动
示例："你好～我是你的学习规划师🎯 告诉我年级和薄弱科目，马上定制方案！"
• 快捷指令：添加3个高频问题，动词开头
示例："📝 制定周计划""🔍 分析错题""💡 推荐资源"
Step4️⃣ 实时测试验证
• 在右侧预览区输入测试问题
• 观察回复是否符合预期格式
• 不理想？回到提示词微调后重试
📝 我的提示词草稿：
_________________________________
_________________________________
_________________________________
✅ 模块二自查清单
□ Bot名称简洁有价值，描述清晰
□ 提示词包含角色+任务+格式+边界四要素
□ 添加了1句开场白+3个快捷指令
□ 预览区测试3个问题，回复格式稳定
□ 保存了当前配置（右上角"保存"按钮）
🔹 模块三：提示词工程深度实战（9:30-10:30）
✅ 核心技巧速查卡
🎯 四大设计原则：
1️⃣ 角色明确：加入"背景+资历+专长"，避免"全能助手"
2️⃣ 任务拆解：用"第一步/第二步/最后"明确流程
3️⃣ 格式约束：指定"请用JSON/分点/表格"等具体格式
4️⃣ 边界设定：明确"不回答什么"+"不确定时怎么说"
🚀 三个进阶技巧：
✨ Few-shot示例：提供1-2组问答对，风格准确率+70%
✨ 变量注入：用{{user_name}}/{{query}}动态引用上下文
✨ 思维链引导：末尾添加"请按以下步骤思考..."提升逻辑性
⚙️ 关键参数推荐值：
• Temperature：客服Bot用0.3，创意文案用0.7
• Top-P：保持0.8-0.95，与Temperature联动
• 上下文轮数：简单问答5轮，复杂咨询10轮
🔧 实操优化任务
🎯 任务：优化你的Bot，实现"三段式结构化输出"
Step1️⃣ 在提示词"回复规范"部分添加：
"请用以下格式回复：
【方法】具体可执行的建议
【原理】为什么这个方法有效
【案例】一个简短的应用示例"
Step2️⃣ 添加Few-shot示例（在提示词末尾）：
用户：初三数学不好怎么办？
你：
【方法】每天专注攻克1类错题，建立错题本
【原理】针对性练习比题海战术效率提升3倍
【案例】比如函数题，先分类再逐个突破...
Step3️⃣ 测试验证：
• 输入"英语单词记不住怎么办"
• 检查回复是否包含【方法】【原理】【案例】三部分
• 格式不稳定？在提示词开头加"必须严格按以下格式输出"
📝 优化前后对比记录：
优化前回复特点：_______________________
优化后回复特点：_______________________
⚠️ 问题排查指南
❓ 回答太冗长？
→ 提示词添加"简洁回复，分点不超过3条"
❓ 答非所问？
→ 1.检查角色定义是否清晰 2.补充示例参考 3.确认知识库未干扰
❓ 拒绝合理问题？
→ 检查边界约束是否过严，添加"例外情况"说明
❓ 格式不稳定？
→ 用"必须用...格式""如果无法...请回复'暂不支持'"强化指令
🔹 模块四：插件配置与能力扩展（10:45-12:00）
✅ 插件核心认知
🔌 插件价值：让Bot拥有"手脚"，能执行具体操作
✅ 官方插件推荐（新手必学）：
• Link Reader：读取网页内容并摘要
• Web Search：联网搜索实时信息
• AI Painting：根据描述生成图片
• File Reader：解析上传的PDF/Word文档
💡 插件调用逻辑：
在提示词中明确触发条件，例如：
"当用户提供网址时，自动调用Link Reader读取内容"
"涉及时间/事件类问题，优先调用搜索插件验证"
🔧 实操步骤指引（以Link Reader为例）
Step1️⃣ 添加插件
• Bot编辑页 → 点击"插件"标签 → "添加插件"
• 搜索"Link Reader" → 点击"启用"
Step2️⃣ 配置提示词
在人设区域补充：
"当用户提供包含http/https的链接时：
1. 自动调用Link Reader读取网页内容
2. 用'核心观点+3个要点+适用人群'格式摘要
3. 如果链接无法访问，礼貌告知并建议复制文字"
Step3️⃣ 测试验证
• 在预览区输入：https://example.com/study
• 观察Bot是否：
✓ 显示"正在读取链接内容..."
✓ 返回结构化摘要
✓ 标注信息来源
Step4️⃣ 添加第二个插件（Web Search）
• 同样方式启用"ByteDance Search"
• 提示词补充："当问题包含'今天/最新/当前'等时间词，且答案可能变化时，调用搜索插件"
• 测试：问"2026年春节是哪天"
📝 插件配置记录：
插件1名称：_________ 触发条件：_________________
插件2名称：_________ 触发条件：_________________
✅ 上午场结业检查清单
🎯 完成以下全部，即可进入下午进阶学习：
□ 1个可运行的Coze Bot（含基础人设）
□ 结构化提示词（四段式+至少1个示例）
□ 成功配置2个官方插件（Link Reader + Web Search）
□ 通过3个测试问题验证效果：
• 问题1（常规）：________________ 回复是否符合预期？□是 □否
• 问题2（带链接）：______________ 是否调用插件？□是 □否
• 问题3（实时信息）：____________ 是否联网搜索？□是 □否
□ 保存Bot并记录Bot ID：_____________
🎁 彩蛋：配置好的Bot可一键复制，下午直接进阶使用！
📎 上午场资源包
📁 配套素材（培训群下载）：
• 提示词模板库.md（4种业务场景可直接套用）
• 插件速查手册.pdf（20个高频插件参数说明）
• 测试问题集.txt（30个验证Bot效果的典型问题）
• 常见问题FAQ.md（含截图+解决方案）
💡 课后练习（可选）：
尝试为你的Bot添加第3个插件，并记录调用效果
🌇 下午场学员手册（14:00-18:00）
进阶配置与发布运营
👤 学员姓名：_____________ 📅 日期：_____________
🎯 今日目标：让Bot拥有私有知识+记忆能力，完成多端发布配置
📌 课前准备：整理1份业务文档（Word/PDF/TXT），用于知识库实操
📋 下午时间安排总览
| 时间 | 模块 | 核心产出 | 完成打勾 |
|---|---|---|---|
| 14:00-15:30 | 知识库(RAG)配置与应用 | Bot成功基于私有文档回答问题 | □ |
| 15:30-15:45 | 茶歇交流 | - | - |
| 15:45-17:00 | 记忆功能与高级配置 | Bot具备1项记忆能力（变量/数据库） | □ |
| 17:00-18:00 | 调试发布与最佳实践 | 完成1个渠道发布配置+结业路演 | □ |
🔹 模块五：知识库(RAG)配置与应用（14:00-15:30）
✅ 核心知识点速记
📚 知识库价值：让Bot访问你的私有数据，解决"大模型不知道"的问题
🔄 RAG工作流程：
用户提问 → 语义理解 → 向量检索知识库 → 召回相关片段 → LLM整合生成 → 标注来源回复
✅ 适用场景自查：
• 客服问答：FAQ文档/产品手册 → ✅ 强烈推荐
• 内部培训：制度流程/课件资料 → ✅ 强烈推荐
• 专业咨询：行业报告/案例库 → ✅ 推荐
• 创意创作：风格指南/素材库 → ⚠️ 辅助参考
• 闲聊陪伴：无需知识库 → ❌ 不需要
🔧 实操步骤指引
Step1️⃣ 文档预处理（关键！）
• 格式要求：.md/.txt/.docx（文本），.xlsx（表格），.png/.jpg（图片需含文字说明）
• 大小限制：单文件≤50MB，建议单次上传≤5个
• 预处理技巧：
✓ 用标题分级（#一级/##二级）帮助分段
✓ 删除页眉页脚/水印/无关页码
✓ FAQ类内容整理为"问题-答案"格式
✓ 关键术语加粗或标注
Step2️⃣ 创建知识库
• 路径：Coze控制台 → 左侧"知识库" → "创建知识库"
• 配置项：
- 名称：业务_产品知识库（示例）
- 描述：包含产品参数/售后政策等
- 分段策略：新手选"自动分段"，结构清晰文档选"按标题分段"
- 关联Bot：勾选上午创建的Bot
Step3️⃣ 上传与索引
• 点击"上传文件"选择预处理好的文档
• 等待系统完成：上传→分段→向量化→索引（约1-3分钟）
• 状态变为"可用"后，进入Bot编辑页确认已关联
Step4️⃣ 优化检索效果
• 术语管理：添加同义词（如"退货=退换=退款"）
• 权重设置：核心政策文档标记"高权重"
• 提示词补充：在Bot人设中添加
"优先引用知识库内容回答，并用【来源：文档名】标注依据"
Step5️⃣ 测试验证
• 测试问题1（精准匹配）："产品A支持七天无理由退货吗？"
✓ 预期：召回退货政策片段+标注来源
• 测试问题2（模糊问法）："买了不喜欢怎么办？"
✓ 预期：通过同义词匹配到退货规则
• 测试问题3（边界问题）："产品Z的退货政策？"
✓ 预期：知识库无内容时，Bot诚实告知而非编造
📝 知识库配置记录：
知识库名称：_____________ 上传文档数：_____
测试问题1：_____________ 召回效果：□优 □中 □差
优化措施：_________________________________
⚠️ 高频避坑指南
❌ 坑1：上传PDF扫描件（图片型）→ 系统无法提取文字
✅ 解：先用OCR工具转文字，或上传Word原版
❌ 坑2：文档含大量表格/公式 → 分段后语义断裂
✅ 解：表格转文字描述，复杂公式配文字解释
❌ 坑3：知识库与提示词冲突 → Bot优先信哪个？
✅ 解：在提示词明确："知识库内容与本指令冲突时，以知识库为准"
❌ 坑4：期望"上传即完美" → 实际需迭代优化
✅ 解：建立"测试-反馈-优化"闭环，小步快跑
🔹 模块六：记忆功能与高级配置（15:45-17:00）
✅ 记忆类型速查表
🧩 Coze四大记忆能力对比：
| 类型 | 存储内容 | 持久性 | 适用场景 | 配置难度 |
|------|----------|--------|----------|----------|
| 变量记忆 | 用户昵称/偏好/临时状态 | 会话级 | 个性化称呼、多轮任务 | ⭐ 简单 |
| 数据库 | 订单/进度/反馈等结构化数据 | 永久存储 | 记账Bot、学习打卡 | ⭐⭐ 中等 |
| 长期记忆 | 自动摘要用户历史交互 | 永久（系统自动） | "越用越懂你"的推荐 | ⭐⭐ 中等 |
| 文件盒子 | 用户上传的文档/图片临时存储 | 会话级 | 文件处理Bot | ⭐ 简单 |
🎯 选择建议：
• 新手起步：先用"变量记忆"实现基础个性化
• 业务沉淀：用"数据库"存储关键用户行为
• 体验升级：开启"长期记忆"实现智能推荐
🔧 数据库配置实操（以反馈收集为例）
Step1️⃣ 创建数据表
• 路径：Bot编辑页 → "记忆" → "数据库" → "创建数据表"
• 表结构设计示例：
表名：feedback_records
字段：
• id (主键，自动递增)
• user_id (文本，用户标识)
• feedback_content (文本，反馈内容)
• rating (数字，评分1-5)
• create_time (时间，系统自动)
Step2️⃣ 提示词中调用数据库
• 写入指令示例（添加到人设区域）：
"当用户说'反馈...'时，自动提取内容写入数据库：
- 表：feedback_records
- 字段：user_id={{user_id}}, feedback_content={{query}}, create_time=now()"
• 读取指令示例：
"当用户问'我之前的反馈是什么'，查询数据库：
- 表：feedback_records
- 条件：user_id={{user_id}} ORDER BY create_time DESC LIMIT 1
- 将结果融入回复"
Step3️⃣ 调试与验证
• 测试写入：输入"反馈：回复有点长，建议简洁些"
✓ 预期：数据库新增1条记录 + Bot回复"感谢反馈！已记录✨"
• 测试读取：输入"查看我的历史反馈"
✓ 预期：Bot回复最近1条反馈内容
• 问题排查：如未成功，检查提示词指令语法+字段名是否匹配
📝 记忆功能配置记录：
选择的记忆类型：□变量 □数据库 □长期记忆
配置的核心能力：_______________________
测试效果：□一次成功 □调整后成功 □需课后完善
💡 个性化Bot设计Checklist
✅ 基础层：用变量记住本次会话关键信息（如用户年级）
✅ 进阶层：用数据库沉淀用户行为数据（如历史反馈）
✅ 高阶层：用长期记忆实现"越用越懂你"（自动总结偏好）
✅ 安全层：在提示词添加"涉及隐私数据需用户确认"
🚀 效果倍增组合：
知识库（知道什么）+ 数据库（记得什么）+ 提示词（怎么回复）
= 专业又贴心的智能体
🔹 模块七：调试发布与最佳实践（17:00-18:00）
🔍 高效调试技巧速查
💬 右侧预览区深度使用：
• 实时对话：用"典型用户口吻"提问，测试边界问题
• 显示思考：点击"显示思考"观察插件调用/知识库召回逻辑
• 会话回放：复现用户反馈的问题，对比优化前后效果
• 运行日志：控制台→"运行日志"筛选ERROR快速定位问题
🛠️ 常见问题速解：
❓ Bot响应慢？
→ 检查：1.是否同时调用多个插件 2.知识库文档是否过大 3.上下文轮数是否过高
❓ 回复内容不稳定？
→ 检查：1.提示词是否有模糊指令 2.Temperature是否过高 3.知识库片段是否冲突
❓ 用户说"听不懂"？
→ 检查：1.专业术语是否解释 2.回复是否过长 3.是否缺少示例
🌐 多端发布配置指引（三选一实操）
□ 方案A（推荐新手）：网页嵌入
• 路径：Bot页→"发布"→"网页"→复制iframe代码
• 测试：新建HTML文件，粘贴代码，浏览器打开
• 注意：提前测试移动端适配，设置域名白名单
□ 方案B（办公场景）：飞书机器人
• 路径：发布→"飞书"→扫码授权→设置可见范围
• 测试：邀请讲师账号@机器人测试对话
• 注意：提前申请企业权限，配置@触发规则
□ 方案C（技术向）：API对接
• 路径：发布→"API"→获取Bot ID+Token
• 测试：用Postman发送POST请求验证
• 注意：Token妥善保管勿泄露，设置QPS限流
📝 我的发布配置：
选择渠道：□网页 □飞书 □微信 □API
关键配置项：_______________________
测试结果：□成功收到回复 □需调整 □课后完善
📈 Bot持续优化四步法
🔄 PDCA循环：
Plan（计划）：基于业务目标设定优化方向（如"提升首问解决率"）
Do（执行）：小范围A/B测试新提示词/知识库/插件配置
Check（检查）：分析用户对话日志+反馈数据，量化效果
Act（行动）：全量发布有效方案，进入下一轮迭代
📊 关键指标参考：
• 用户体验：平均对话轮数↓、用户满意度↑
• 业务价值：问题解决率↑、人工转接率↓
• 系统健康：响应时间<3s、错误率<1%
🎓 结业任务与成果提交
🏆 终极任务（10分钟完成）
Step1️⃣ 完善个人Bot
• 整合上午+下午所学，确保核心功能流畅
• 重点检查：提示词逻辑+知识库关联+记忆配置+插件调用
Step2️⃣ 填写《Bot配置清单》
• 下载模板：培训群→/结业材料/Bot配置清单.xlsx
• 填写：提示词要点/知识库文档/插件列表/发布渠道/测试记录
Step3️⃣ 1分钟路演准备
• 模板：
"我是[姓名]，我的Bot叫[名称]，主要解决[业务问题]。
核心亮点：[1个最满意的设计，如'能自动总结网页内容'+ '记住用户偏好']。
下一步计划：[上线测试/收集反馈/迭代优化]。"
✅ 提交方式：
• 配置清单：培训群上传/讲师邮箱
• 路演：小组内分享+讲师随机抽取3位展示
🎁 结业礼包领取
✅ 电子结业证书：含个人Bot二维码，培训群统一发放
✅ 《Coze智能体开发手册》PDF：含今日所有模板+进阶技巧
✅ 专属答疑群入口：讲师+助教持续支持30天
✅ 进阶学习路径图：工作流/多Bot协作/企业部署学习路线
💡 课后行动建议：
1️⃣ 本周：上线1个MVP版Bot，收集3位真实用户反馈
2️⃣ 本月：迭代2-3个版本，打磨核心场景体验
3️⃣ 本季：探索多Bot协作/与企业系统深度集成
📎 下午场资源包
📁 配套素材（培训群下载）：
• 知识库模板库/
├── FAQ标准格式.docx（问题-答案-标签三列）
├── 产品说明书清洗指南.pdf
└── 分段策略选择决策树.png
• 数据库设计手册/
├── 常见业务表结构示例.sql
├── 字段命名规范.md
└── 读写指令提示词模板.txt
• 发布配置指南/
├── 网页嵌入代码示例.html
├── 飞书机器人权限申请流程图.png
└── API调用Postman集合.json
• 结业材料/
├── Bot配置清单.xlsx（自动计算公式）
├── 1分钟路演脚本模板.md
└── 进阶学习资源链接.md
❓ 课后答疑：
• 常见问题：培训群置顶FAQ文档
• 技术问题：答疑群@助教，24小时内响应
• 业务咨询：预约讲师1v1沟通（限前20名）
✍️ 个人学习笔记区
上午关键收获：
1. _________________________________
2. _________________________________
3. _________________________________
下午关键收获：
1. _________________________________
2. _________________________________
3. _________________________________
我的Bot优化计划：
• 短期（1周）：_____________________
• 中期（1月）：_____________________
• 长期（1季）：_____________________
讲师/同学金句记录：
• _________________________________
• _________________________________
💡 使用提示：
- 本手册为实操导向设计，建议边学边记，重点标注个人业务相关知识点
- 每个"✅自查清单"完成后打勾，确保关键技能不遗漏
- 课后7天内回顾手册+实操Bot，巩固学习效果
- 遇到问题先查手册FAQ，再群内提问，效率更高
🎯 记住：最好的智能体不是"功能最多"，而是"最懂用户"。期待看到你们创造的惊喜！✨
📌 附：快速索引
🔍 想找提示词模板？→ 上午手册 P3「四段式模板」
🔍 插件不会配置？→ 上午手册 P6「实操步骤指引」
🔍 知识库效果差？→ 下午手册 P3「优化检索效果4技巧」
🔍 发布遇到问题？→ 下午手册 P7「多端发布配置指引」
🔍 课后想进阶？→ 下午手册 P9「进阶学习路径图」
需要我为您生成配套的《讲师逐字稿》《实操任务卡》或《学员反馈表》模板吗？🎯