第5天上午_Python与智能体
大约 14 分钟教学文档Python基础
🌅 上午场细化方案（8:00-12:00）
Coze智能体基础搭建与核心配置
📋 细化原则：每分钟都有明确目标｜每环节都有产出物｜每知识点都有实操
🕗 模块一：Coze平台认知与智能体概览（8:00-8:30｜30分钟）
🔹 8:00-8:10｜开场破冰 & 培训目标对齐
| 时间 | 内容 | 讲师动作 | 学员动作 | 产出物 |
|---|---|---|---|---|
| 8:00-8:03 | 欢迎&自我介绍 | 展示讲师资质+Coze实战案例 | 扫码签到+入群 | 培训群建立 |
| 8:03-8:07 | 培训目标共识 | 明确"今天结束你能做出什么" | 写下个人学习目标 | 学习目标卡 |
| 8:07-8:10 | 课程地图预览 | 展示上午4模块逻辑关系图 | 快速浏览手册目录 | 建立学习预期 |
🔹 8:10-8:20｜Coze平台核心认知
| 知识点 | 关键内容 | 演示操作 | 学员跟练 | 避坑提醒 |
|---|---|---|---|---|
| 平台定位 | 字节出品｜零代码｜多端发布｜企业级权限 | 打开coze.cn展示首页 | 登录个人账号 | 确认使用企业/个人版 |
| 核心优势 | ✅ 插件生态丰富 ✅ 知识库RAG ✅ 多模型切换 ✅ 中文优化好 | 对比其他平台功能矩阵 | 记录3个最吸引自己的点 | 避免陷入"功能越多越好"误区 |
| 智能体本质 | 不是聊天机器人，而是"有角色+有工具+有记忆"的数字员工 | 展示客服Bot vs 普通Chat区别 | 思考：我的业务适合什么Bot？ | 区分"玩具"和"生产力工具" |
🔹 8:20-8:30｜智能体组成拆解 + 环境准备
🧩 智能体五大核心组件（图解记忆）：
┌─────────────────────────┐
│ 🎭 人设提示词 → "你是谁" │
│ 🧠 大模型基座 → "怎么想" │
│ 🔌 插件能力 → "能做什么" │
│ 📚 知识库 → "知道什么" │
│ 💭 记忆系统 → "记得什么" │
└─────────────────────────┘
| 实操步骤 | 详细指引 | 预期结果 | 问题预案 |
|---|---|---|---|
| Step1 创建工作空间 | 控制台→左上角切换/新建→命名"培训-姓名" | 拥有独立开发环境 | 如遇权限问题，提前联系管理员 |
| Step2 熟悉界面布局 | 左侧导航(Bot/插件/知识库)｜中间编辑区｜右侧预览区 | 能定位各功能入口 | 发放《界面功能速查卡》 |
| Step3 创建第一个Bot | 点击"创建Bot"→输入名称"我的学习助手"→选默认模型 | 进入Bot编辑页面 | 名称重复时自动添加后缀，正常现象 |
✅ 模块一结业检查：每位学员屏幕显示"Bot编辑页面"，讲师快速巡场确认
🕘 模块二：智能体创建与人设配置（8:30-9:30｜60分钟）
🔹 8:30-8:45｜Bot基础信息配置（15分钟）
| 配置项 | 填写规范 | 示例参考 | 学员练习 |
|---|---|---|---|
| Bot名称 | 简洁+场景+价值，≤10字 | "英语陪练小A""周报生成器" | 为自己的Bot起名 |
| 头像设置 | 建议512×512px，体现角色特征 | 上传预设素材/用AI生成 | 上传或生成头像 |
| Bot描述 | 一句话说明能力+适用人群 | "帮职场新人快速写周报，支持多种风格" | 撰写20字内描述 |
| 发布渠道预览 | 提前勾选目标平台(微信/飞书/网页) | 根据业务需求选择 | 标记1-2个首发渠道 |
💡 讲师话术："名称是用户第一印象，描述决定点击意愿，头像建立情感连接——这三项花3分钟，可能提升50%使用率"
🔹 8:45-9:15｜人设提示词深度配置（30分钟·核心环节）
📝 提示词结构模板（推荐四段式）
# 角色定义
你是一位[专业领域]专家，擅长[核心能力]，服务对象是[目标用户]。
# 任务目标
当用户[触发场景]时，你需要[具体行动]，最终帮助用户[达成价值]。
# 回复规范
- 语气风格：[亲切/专业/幽默等]
- 输出格式：[分点/表格/Markdown等]
- 长度控制：[简洁/详细/分步等]
- 边界约束：[不回答/需转人工/需确认等]
# 示例参考（Few-shot）
用户：[典型问题]
你：[标准回复]
🎯 分步实操指导（讲师演示+学员跟练）
| 步骤 | 操作指引 | 关键技巧 | 常见错误 |
|---|---|---|---|
| ① 清空默认提示词 | 点击"人设与回复逻辑"→全选删除 | 避免新旧指令冲突 | 直接在原文修改导致逻辑混乱 |
| ② 填写角色定义 | 用"你是..."开头，明确专业边界 | 加入"不是..."排除歧义 | 角色过于宽泛如"全能助手" |
| ③ 设定任务流程 | 用"当...时，你需要..."句式 | 拆解为2-3个可执行步骤 | 任务描述模糊如"帮用户解决问题" |
| ④ 规范输出格式 | 明确"请用...格式回复" | 结合业务场景设计模板 | 格式要求与模型能力不匹配 |
| ⑤ 添加示例参考 | 提供1-2组问答对 | 示例要覆盖高频场景 | 示例与指令矛盾 |
✍️ 学员实操任务（15分钟）
🎯 任务：配置"学习规划助手"Bot的人设提示词
📋 要求：
1. 角色：K12学习规划师，熟悉各科学习方法
2. 任务：根据学生年级+薄弱科目，给出3条可执行建议
3. 格式：分点输出+每条含"方法+原因+示例"
4. 边界：不代写作业，不推荐具体培训机构
✅ 验收标准：右侧预览区输入"初三数学不好怎么办"，Bot能按格式回复
🔹 9:15-9:30｜开场白&快捷指令配置（15分钟）
| 功能 | 配置位置 | 设计原则 | 案例参考 |
|---|---|---|---|
| 开场白 | 人设页下方"开场白" | 3秒内说清价值+引导行动 | "你好呀～我是你的学习规划师🎯 告诉我你的年级和薄弱科目，马上为你定制提升方案！" |
| 快捷指令 | "添加快捷指令"按钮 | 覆盖80%高频问题+动词开头 | "📝 制定周计划""🔍 分析错题原因""💡 推荐学习资源" |
| 问题建议 | 与开场白联动展示 | 降低用户思考成本 | 输入框上方显示3个气泡问题 |
🔧 实操练习：为自己的Bot设计1句开场白+3个快捷指令，同桌互测体验流畅度
✅ 模块二结业检查：随机抽取3位学员展示Bot，讲师点评提示词逻辑性
🕙 模块三：提示词工程深度实战（9:30-10:30｜60分钟）
🔹 9:30-9:50｜提示词设计四大原则（20分钟）
🎯 原则一：角色明确（Role Clarity）
❌ 模糊表述："你是一个助手"
✅ 精准定义："你是一位有5年经验的新媒体运营专家，专注小红书爆款内容创作"
💡 技巧：加入"背景+资历+专长"三要素
🎯 原则二：任务拆解（Task Decomposition）
❌ 笼统指令："帮用户写文案"
✅ 结构化流程：
1. 先询问产品卖点+目标人群+发布平台
2. 再提供3种风格草稿供选择
3. 最后给出优化建议和数据预判
💡 技巧：用"第一步/第二步/最后"明确流程
🎯 原则三：格式约束（Format Control）
✅ 有效指令：
"请用以下JSON格式回复：
{
"title": "标题",
"points": ["要点1", "要点2"],
"hashtag": ["#标签1", "#标签2"]
}"
❌ 无效指令：
"请规范输出"（模型无法理解"规范"具体指什么）
🎯 原则四：边界设定（Boundary Setting）
✅ 必加约束：
- "如果用户问题超出[范围]，请礼貌说明并引导至[替代方案]"
- "涉及医疗/法律等专业建议，必须标注'仅供参考，建议咨询专业人士'"
- "不确定答案时，诚实告知而非编造"
🔹 9:50-10:15｜高级技巧实战（25分钟）
🚀 技巧1：Few-shot示例增强
| 场景 | 示例写法 | 效果对比 |
|---|---|---|
| 风格控制 | 用户："写个活泼的促销文案" 你："[示例1：用emoji+短句+感叹号]" 用户："写个专业的产品介绍" 你："[示例2：用数据+术语+分段]" | 有示例时风格准确率提升70%+ |
| 复杂任务 | 提供"用户问题→思考过程→最终回复"完整链路示例 | 模型学会"先分析再回答"的思维链 |
🚀 技巧2：变量注入（Jinja2语法）
📌 适用场景：需要动态引用用户信息/知识库内容
💡 基础语法：
- {{user_name}} → 插入用户昵称
- {{query}} → 插入当前问题
- {{knowledge}} → 插入知识库召回片段
🎯 实操示例：
"你好{{user_name}}～关于你问的'{{query}}'，根据资料显示：{{knowledge}}"
🚀 技巧3：思维链引导（CoT）
✅ 在提示词末尾添加：
"请按以下步骤思考：
1. 用户的核心需求是什么？
2. 需要调用哪些知识/插件？
3. 如何组织语言让回复清晰有用？
4. 检查是否有遗漏或错误？
然后再给出最终回复。"
🔹 10:15-10:30｜参数调优+问题排查（15分钟）
⚙️ 关键参数详解（编辑页→模型设置）
| 参数 | 推荐值 | 调整逻辑 | 业务场景 |
|---|---|---|---|
| Temperature | 0.3-0.7 | 越低越稳定，越高越创意 | 客服Bot用0.3，创意文案用0.7 |
| Top-P | 0.8-0.95 | 控制采样多样性，通常与Temp联动 | 保持回复丰富性同时避免跑偏 |
| 上下文轮数 | 5-10轮 | 越多记忆越好，但增加成本/延迟 | 复杂咨询用10轮，简单问答用5轮 |
| 最大回复长度 | 500-2000字 | 根据业务需求平衡信息量与阅读体验 | 知识科普用长文本，快捷回复用短句 |
🔍 常见问题自查清单
❓ Bot回答太冗长？
→ 检查提示词是否添加"简洁回复""分点不超过3条"等约束
❓ Bot频繁答非所问？
→ 1.角色定义是否清晰 2.是否缺少示例参考 3.知识库是否干扰
❓ Bot拒绝回答合理问题？
→ 检查边界约束是否过严，添加"例外情况"说明
❓ 回复格式不稳定？
→ 用"必须用...格式""如果无法...请回复'暂不支持'"强化指令
✅ 模块三结业任务：优化上午创建的Bot提示词，实现"用户问学习方法时，固定输出'方法+原理+案例'三段式结构"
☕ 10:30-10:45｜茶歇交流（15分钟）
- 📊 设置"问题墙"：学员便签贴疑问，讲师课间收集
- 💬 组建"互助小组"：3人一组，下午实操可快速协作
- 🎁 彩蛋预告：下午将解锁"让Bot记住用户偏好"的记忆功能
🕚 模块四：插件配置与能力扩展（10:45-12:00｜75分钟）
🔹 10:45-11:05｜插件核心认知（20分钟）
🌐 插件价值图解
🤖 纯大模型Bot：能聊天+有知识 → "大脑"
🔌 +插件的Bot：能聊天+有知识+能操作 → "大脑+手脚"
✅ 插件典型能力：
• 获取实时信息：新闻/天气/股价/热搜
• 处理外部内容：读取网页/PDF/链接摘要
• 执行具体动作：生成图片/发送消息/查询数据库
• 连接业务系统：CRM/工单/日历API（需自定义）
🔍 插件市场使用指南
| 操作 | 路径 | 技巧 |
|---|---|---|
| 浏览插件 | Bot编辑页→"插件"→"添加插件" | 按"官方/热门/分类"筛选 |
| 搜索插件 | 顶部搜索框输入关键词 | 用"功能词"而非"场景词"，如搜"搜索"而非"查新闻" |
| 查看文档 | 点击插件→"使用说明" | 重点关注"输入参数"和"返回字段" |
| 授权管理 | 部分插件需单独授权 | 提前准备相关账号（如GitHub/飞书） |
🔹 11:05-11:35｜官方插件实战（30分钟·重点）
🎯 必学插件1：网页内容读取（Link Reader）
📌 场景：用户发链接，Bot自动总结内容
🔧 配置步骤：
1. 添加插件：搜索"Link Reader"→启用
2. 提示词补充："当用户提供网址时，自动调用Link Reader读取内容并摘要"
3. 测试：输入"https://example.com"，观察Bot是否调用插件
💡 进阶技巧：
- 在提示词指定摘要格式："请用'核心观点+3个要点+适用人群'格式总结"
- 添加边界："如果链接无法访问，礼貌告知并建议用户复制文字内容"
🎯 必学插件2：多路搜索（Web Search）
📌 场景：回答需要实时信息的问题（如"今天北京天气"）
🔧 配置步骤：
1. 添加"ByteDance Search"或"Google Search"插件
2. 提示词补充："涉及时间/事件/数据类问题，优先调用搜索插件验证"
3. 测试：问"2026年春节是哪天"，观察是否联网查询
⚠️ 注意事项：
- 搜索类插件可能增加响应时间，提示词中可加"如需搜索请先告知用户"
- 对搜索结果要做二次判断，避免直接引用不可靠来源
🎯 选学插件（根据学员业务选择1-2个）
| 插件类型 | 代表插件 | 适用场景 | 配置要点 |
|---|---|---|---|
| 图片生成 | AI Painting | 营销素材/头像设计 | 提示词中描述画面要素+风格 |
| 文档解析 | File Reader | 上传PDF/Word自动解读 | 说明支持的文件类型和大小限制 |
| 代码执行 | Code Runner | 简单计算/数据处理 | 严格限制代码权限，避免安全风险 |
🔹 11:35-11:55｜插件调用逻辑优化（20分钟）
🧠 智能体如何决定"用不用插件"？
✅ 有效策略：
1. 在提示词明确触发条件：
"当用户问题包含'网址/http/链接'时，调用Link Reader"
"当问题涉及'今天/最新/当前'等时间词，且答案可能变化时，调用搜索插件"
2. 设置插件优先级：
"优先使用知识库回答，如果知识库无相关信息，再调用搜索插件"
3. 添加fallback机制：
"如果插件调用失败，用大模型知识回答，并标注'以下回答基于训练数据，可能不是最新'"
🔧 学员实操任务（20分钟）
🎯 任务：为"学习助手"Bot添加插件能力
📋 要求：
1. 添加"Link Reader"：用户发学习资源链接时，自动总结核心知识点
2. 添加"Web Search"：回答"最新考试政策"类问题时联网查询
3. 优化提示词：明确插件调用条件+失败备选方案
✅ 验收标准：
- 输入"https://example.com/study" → Bot调用插件并输出结构化摘要
- 输入"2026年高考报名时间" → Bot搜索后给出带来源的回复
- 插件失效时 → Bot能优雅降级，不报错不卡死
🔹 11:55-12:00｜上午复盘&下午预告（5分钟）
📋 上午成果检查清单
✅ 每位学员应完成：
□ 1个可运行的Coze Bot（含基础人设）
□ 结构化提示词（四段式+示例）
□ 至少2个官方插件配置
□ 通过3个测试问题验证效果
🎁 彩蛋：保存好的Bot可一键复制，下午直接进阶配置
🔮 下午精彩预告
🌟 14:00-15:30｜知识库实战：让Bot拥有你的专属资料
🌟 15:45-17:00｜记忆功能：打造"越用越懂你"的个性化Bot
🌟 17:00-18:00｜发布运营：多端部署+持续优化方法论
💡 课前准备：整理1份业务文档（Word/PDF/TXT），下午用于知识库实操
📎 上午场配套物料（讲师备用）
🗂️ 学员实操包（提前发放）
📁 /上午实操素材/
├── 📝 提示词模板库.md（含4种业务场景模板）
├── 🔌 插件速查手册.pdf（20个高频插件参数说明）
├── 🧪 测试问题集.txt（30个验证Bot效果的典型问题）
├── 🎨 头像素材包.zip（50+免版权角色图标）
└── ❓ 常见问题FAQ.md（含截图+解决方案）
🛠️ 讲师应急方案
| 突发情况 | 应对措施 | 备用方案 |
|---|---|---|
| 学员网络卡顿 | 提前录屏关键操作，本地播放 | 发放《离线操作指南》图文版 |
| 插件授权失败 | 准备免授权替代插件 | 用"模拟调用"演示逻辑，课后单独协助 |
| 学员进度差异大 | 设置"基础版/进阶版"双任务 | 安排助教1对3辅导，讲师聚焦共性难点 |
| 时间紧张 | 标记⭐核心环节必讲，其他可课后自学 | 提供完整版录播+答疑群持续支持 |
💡 教学心法：上午重在"建立信心+跑通流程"，让学员带着"我能做出Bot"的成就感进入下午进阶学习。每个实操环节务必预留"成功体验"，避免陷入技术细节焦虑。