综合实训项目及安排
大约 17 分钟教学文档综合实训
“智慧校园助手”智能体开发项目详细方案
一、 项目背景与宏伟蓝图
- 项目名称:智慧校园助手 (Smart Campus Assistant)
- 核心服务对象:在校大学生。本项目假设用户具备基础的计算机操作能力,例如使用浏览器、手机App、进行文字输入等,但无需具备任何编程或人工智能相关的专业知识。这确保了项目的焦点在于智能体功能的构建,而非底层技术实现。
- 开发实战平台:Coze (扣子)。我们将利用Coze这一强大的智能体开发平台,通过其可视化、低代码/无代码的特性,让每一位同学都能亲手打造出属于自己的AI应用。
- 战略发展目标: 通过本项目的实战开发,使参与者不仅掌握前沿的AI应用开发技能,更能深刻理解大语言模型在实际场景中的应用范式。具体目标分解如下:
- 精通LLM提示词工程:深入理解并实践如何通过设计精妙的提示词,来引导和控制大语言模型的行为,使其能够准确、高效地完成特定任务,这是所有后续开发的基础。
- 熟练运用Coze核心功能:全面掌握Coze平台的各种组件,包括知识库(文本、表格、图片)、插件、工作流、变量、数据库和记忆能力,并能灵活组合它们来解决复杂问题。
- 掌握逻辑编排与数据处理:能够设计清晰、健壮的工作流来处理多步骤的任务逻辑。同时,具备在必要时使用Python代码节点进行自定义数据处理和算法实现的能力,以应对更复杂的计算需求。
- 构建上下文感知的智能体:深刻理解并应用短期记忆(在同一轮对话中理解上下文)和长期记忆(跨对话记住用户偏好和历史信息),从而打造出更加个性化、智能化的用户体验。
- 交付完整的可交互产品:最终目标是完成一个功能完善、交互友好、能在真实校园场景中提供切实帮助的智能体,并进行成功的项目答辩,展示从构思到实现的完整项目开发能力。
二、 核心功能模块详述 (与技术点的深度融合)
为了系统地学习和应用Coze的各项关键技术,我们将“智慧校园助手”的复杂功能拆解为四个相辅相成的核心模块,每个模块都对应并侧重于特定的技术点。
模块一:校园百事通 —— 知识库应用的深度实践
- 功能描述:本模块旨在构建一个无所不知的“校园万事通”。它能够准确回答学生关于校园生活的各类静态、确定性问题,例如:
- 校规校纪:“学生公寓的晚归时间是几点?”“考试作弊的处分规定是什么?”
- 办事流程:“如何补办学生证?”“申请助学贷款需要哪些步骤?”
- 校园指引:“第二食堂在哪里?”“校医院的急诊电话是多少?”“图书馆的研讨室怎么预约?”
- 技术实现与要点:
- 文本知识库:将《学生手册》、《办事指南》等官方文档整理成规范的文本格式(如TXT、PDF),上传至Coze的知识库中。这是智能体获取权威信息的核心来源。关键在于对原始文档进行预处理,如分段、清洗,以提高知识检索的准确率。
- 图片知识库:上传校园地图、主要建筑外观图、路标指示牌等图片。智能体不仅能调取这些图片直接展示给用户,更关键的是,可以通过提示词让LLM根据图片内容生成描述性的回答。例如,当学生询问“信息学部图书馆怎么走?”时,智能体可以先检索到相关的校园地图图片,然后结合图片上的标记,生成“请参考下图,您当前位于XX位置,沿图中红色路线步行约5分钟即可到达”这样的指引。
模块二:奖学金与课程管家 —— 表格知识与数据库的联动应用
- 功能描述:此模块负责处理结构化的数据和用户的个性化存储需求,提供更精准的查询和个人化管理功能。
- 奖学金查询:学生可以询问各类奖学金的详细信息,如“国家奖学金的申请条件是什么?”“校长奖学金的金额是多少?”“新生奖学金的评定标准主要看高考成绩还是入学后的表现?”
- 个人学习进度存储:学生可以记录自己的课程安排、作业截止日期、考试时间等。例如,用户可以说“帮我记一下,下周二下午3点有《人工智能导论》的期末考试”,或者“我的《高等数学》作业截止日期是这周五”。
- 技术实现与要点:
- 表格知识库:将奖学金评定细则整理成结构化的Excel表格。表格的列可以包括:奖学金名称、等级、金额、申请资格(GPA要求、年级、专业限制等)、评选流程、截止日期等。当用户提问时,智能体能够像查询数据库一样,从这张表格中精确地检索出匹配的信息,并以清晰、结构化的方式呈现给用户。
- 数据库 (Table):利用Coze的数据库功能,为每个用户创建一个私人的“学习日程”表。表的字段可以设计为:事项类型(课程/作业/考试)、课程名称、具体描述、截止日期/时间、完成状态。当用户发出“帮我记下...”的指令时,智能体通过意图识别,触发一个数据写入流程,将信息结构化地存入这个数据库。当用户查询“我有哪些作业快到期了?”时,智能体则从数据库中检索并返回个性化结果。这完美地结合了知识库的广泛性与数据库的个性化。
模块三:生活小管家 —— 插件与工作流的集成应用
- 功能描述:本模块负责处理需要实时信息或多步骤逻辑的复杂任务,让智能体成为学生日常生活的贴心助手。
- 天气查询:“明天下午学校操场有雨吗?”(实时天气)
- 快递查询:“帮我查一下申通快递1234567890到哪了?”(调用快递API)
- 校园新闻:“最近学校有什么重要的学术讲座或社团活动吗?”(可扩展链接校园官网或公众号RSS)
- 开销预算计算:“我这个月生活费还剩2000元,想预留500元作为话费和网费,剩下的钱如果每天吃饭花50元,还能剩多少?”(多步逻辑运算)
- 技术实现与要点:
- 插件 (Plugin):集成Coze插件市场中的“天气查询”、“快递查询”等官方或第三方插件。智能体在接收到用户的相关请求后,能够自动识别意图,调用对应的插件获取实时数据,并将结果返回给用户。这是连接智能体与外部动态世界的关键。
- 工作流 (Workflow):针对“开销预算计算”这类需要多步推理和计算的复杂问题,我们不再依赖单一的LLM或插件,而是设计一个可视化的工作流。例如,一个“预算计算器”工作流可能包含以下节点:
- 开始节点:接收用户输入的总预算、固定预留和每日开销。
- 代码节点 (或LLM节点):解析用户输入,提取关键数字。
- 计算节点:执行
剩余可支配金额 = 总预算 - 固定预留的运算。 - 计算节点:执行
可维持天数 = 剩余可支配金额 / 每日开销的运算。 - 结束节点:将计算结果(剩余金额和可维持天数)组织成友好的语言返回给用户。 工作流使得复杂的逻辑变得清晰、可控且易于调试。
模块四:学习伴侣 —— Python代码与记忆机制的进阶应用
- 功能描述:此模块展示了智能体在定制化计算和个性化交互方面的强大能力。
- GPA计算器:用户输入课程学分和成绩,智能体可以按照学校的特定算法(如4.0/5.0分制)精确计算出GPA(平均学分绩点)。
- 个性化偏好记忆:智能体能够记住用户的个人偏好,并在后续的交互中主动应用。例如,用户曾说过“我习惯坐图书馆3楼的靠窗位置”,那么下次当用户问“帮我预约个图书馆座位”时,智能体可以优先推荐或询问是否要预约3楼靠窗的座位。
- 技术实现与要点:
- Python代码节点:在Coze的工作流中嵌入一个代码节点,编写Python函数来实现GPA计算。例如:这突破了无代码工具的局限,赋予了智能体进行任意复杂计算的能力。
def main(成绩: str, 学分: str) -> dict: # 解析输入字符串,例如 "高等数学:95,4; 大学物理:88,3.5" # 按照特定规则(如4.0分制:绩点 = (成绩/10)-5)计算加权平均绩点 # 返回计算结果 return {'gpa': 3.78, 'total_credits': 7.5} - 变量与记忆:
- 变量:在对话的短期上下文(Session)中使用变量,临时存储用户本次对话中提到的偏好,如“靠窗位置”。
- 长期记忆:将用户偏好通过“记忆”功能进行存储。这通常在用户明确表示“我喜欢/习惯...”时触发,通过LLM提取关键信息(
偏好类型: 座位位置, 偏好值: 3楼靠窗),并写入到用户的长期记忆存储中。当用户发起相关的新对话(如“帮我预约座位”)时,智能体首先从长期记忆中检索该用户的偏好,从而提供真正个性化的服务。
- Python代码节点:在Coze的工作流中嵌入一个代码节点,编写Python函数来实现GPA计算。例如:
三、 项目实施步骤与时间规划
“智慧校园助手”智能体开发实训日程安排
实训总时长:4天(32学时)
每日时间:上午 8:00-12:00,下午 14:00-18:00
实训形式:理论讲解 + 动手实操 + 项目开发 + 分组指导
方式一:文本版日程安排
第一天:基础入门与知识库应用(校园百事通模块)
上午(8:00-12:00):平台入门与提示词工程
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 8:00-9:30 | Coze平台介绍与智能体创建 | 注册/登录Coze平台,熟悉界面布局;创建一个空白智能体,了解基本配置(名称、头像、人设) |
| 9:30-10:45 | 提示词工程核心技巧 | 学习提示词编写原则(清晰、具体、结构化);练习角色设定、格式约束、示例引导等技巧 |
| 10:45-12:00 | 实战演练:智能体人设优化 | 为“智慧校园助手”编写人设提示词;测试不同提示词对回答风格的影响,迭代优化 |
下午(14:00-18:00):知识库构建与应用
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 14:00-15:30 | 文本知识库的原理与创建 | 学习知识库工作原理;准备《学生手册》文本片段,上传并创建文本知识库 |
| 15:30-16:30 | 文本知识库的测试与优化 | 设计10个校园常见问题,测试智能体回答效果;调整知识库分段方式和检索参数 |
| 16:30-17:30 | 图片知识库的应用 | 上传校园地图、主要建筑图片;测试“根据图片回答问题”的效果 |
| 17:30-18:00 | 第一天总结与答疑 | 回顾当天知识点,解答实操中遇到的问题 |
第二天:结构化数据处理与个性化存储(奖学金与课程管家模块)
上午(8:00-12:00):表格知识库应用
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 8:00-9:30 | 表格知识库的原理与创建 | 学习表格知识与文本知识的区别;准备奖学金Excel表格,上传至知识库 |
| 9:30-11:00 | 表格查询的提示词优化 | 设计针对表格的查询提示词,练习精确检索技巧;测试“奖学金对比查询”等复杂问题 |
| 11:00-12:00 | 综合练习:奖学金问答 | 整理10个奖学金相关问答题,测试智能体的回答准确率 |
下午(14:00-18:00):数据库与个性化存储
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 14:00-15:30 | 数据库(Table)概念与创建 | 学习Coze数据库的功能;创建“个人学习进度”数据表,设计字段(课程、作业、截止日期等) |
| 15:30-17:00 | 数据库的读写操作 | 练习向数据库中添加、查询、更新数据;实现“帮我记一下...”和“我有哪些任务”功能 |
| 17:00-18:00 | 模块整合与实战 | 将表格知识库与数据库结合,实现“查询奖学金+记录我的申请进度”联动场景 |
第三天:外部能力集成与逻辑编排(生活小管家模块)
上午(8:00-12:00):插件应用与工作流入门
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 8:00-9:30 | 插件市场探索与集成 | 浏览Coze插件市场,了解各类插件功能;集成天气、快递查询等实用插件 |
| 9:30-10:45 | 插件调用实战 | 测试天气查询、快递查询、新闻搜索等插件的调用效果;优化提示词使插件调用更精准 |
| 10:45-12:00 | 工作流概念与入门 | 学习工作流的基本概念、节点类型;创建一个简单的“信息汇总”工作流 |
下午(14:00-18:00):工作流深入与变量应用
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 14:00-16:00 | 复杂工作流设计 | 设计“开销预算计算器”工作流:输入解析、多步计算、结果返回;测试不同输入场景 |
| 16:00-17:00 | 变量概念与应用 | 学习变量的作用;在工作流中使用变量暂存中间结果 |
| 17:00-18:00 | 模块整合与实战 | 将插件和工作流整合,实现“查询天气+提醒带伞+计算今日开销”的复合场景 |
第四天:高级功能与项目答辩(学习伴侣模块+项目完善)
上午(8:00-12:00):Python代码与记忆机制
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 8:00-9:45 | Python代码节点入门 | 学习在工作流中添加代码节点;编写简单的数据处理函数(如字符串解析) |
| 9:45-11:00 | GPA计算器实现 | 根据学校绩点算法,编写Python函数实现GPA计算;测试多门课程、不同学分的情况 |
| 11:00-12:00 | 长期记忆机制应用 | 学习变量与长期记忆的区别;实现“记住用户偏好”(如座位偏好、常去食堂)功能 |
下午(14:00-18:00):项目完善与答辩准备
| 时间段 | 内容 | 具体任务 |
|---|---|---|
| 14:00-15:30 | 项目整合与调试 | 将四个模块整合到同一个智能体中;全面测试各功能,修复发现的问题 |
| 15:30-16:30 | 交互体验优化 | 优化智能体的欢迎语、引导语;设计几个典型的对话场景,使展示更流畅 |
| 16:30-17:30 | 答辩准备与模拟演练 | 准备项目介绍PPT或演示文档;分组进行模拟答辩,互相点评 |
| 17:30-18:00 | 正式答辩与总结 | 每组进行5-8分钟项目演示;教师点评,颁发优秀项目证书 |
方式二:表格版日程安排
| 天数 | 时间段 | 模块 | 内容主题 | 具体任务 |
|---|---|---|---|---|
| 第1天 | 上午 8:00-12:00 | 基础入门 | 平台介绍与智能体创建 | 注册登录Coze,创建第一个智能体 |
| 提示词工程核心技巧 | 学习提示词编写原则,练习角色设定、格式约束 | |||
| 实战:人设优化 | 编写并迭代优化“智慧校园助手”人设提示词 | |||
| 下午 14:00-18:00 | 校园百事通 | 文本知识库创建 | 上传学生手册,创建文本知识库 | |
| 知识库测试优化 | 设计10个校园问题,测试并优化回答效果 | |||
| 图片知识库应用 | 上传校园地图,测试图文结合问答 | |||
| 第2天 | 上午 8:00-12:00 | 奖学金管家 | 表格知识库创建 | 准备奖学金Excel,上传表格知识库 |
| 表格查询优化 | 设计奖学金问答,练习精确检索技巧 | |||
| 综合练习 | 完成10个奖学金相关问题测试 | |||
| 下午 14:00-18:00 | 课程管家 | 数据库概念与创建 | 设计“个人学习进度”表结构 | |
| 数据库读写操作 | 实现任务记录与查询功能 | |||
| 模块整合 | 实现“奖学金+申请进度”联动场景 | |||
| 第3天 | 上午 8:00-12:00 | 生活小管家 | 插件应用 | 集成天气、快递查询等插件 |
| 插件调用实战 | 测试插件调用效果,优化触发提示词 | |||
| 工作流入门 | 学习工作流概念,创建简单工作流 | |||
| 下午 14:00-18:00 | 复杂工作流设计 | 实现“开销预算计算器”工作流 | ||
| 变量应用 | 在工作流中使用变量暂存中间结果 | |||
| 模块整合 | 实现“天气+提醒+预算”复合场景 | |||
| 第4天 | 上午 8:00-12:00 | 学习伴侣 | Python代码节点 | 学习代码节点,编写数据处理函数 |
| GPA计算器实现 | 根据学校算法实现GPA计算功能 | |||
| 长期记忆应用 | 实现用户偏好记忆功能 | |||
| 下午 14:00-18:00 | 项目完善 | 项目整合调试 | 四个模块整合,全面测试修复 | |
| 交互体验优化 | 优化欢迎语、引导语,设计演示场景 | |||
| 答辩准备 | 准备PPT,分组模拟演练 | |||
| 正式答辩 | 项目演示,教师点评 |
实训成果交付要求
4天实训结束后,每位学员/每组需提交:
- 可运行的智能体:在Coze平台上完成并发布的“智慧校园助手”智能体
- 项目文档:包含智能体功能介绍、技术实现要点、测试用例及结果
- 答辩PPT:5-8分钟的项目展示,包含功能演示、技术亮点、遇到的问题及解决方案
实训注意事项
- 课前准备:建议提前熟悉校园常用信息(学生手册关键条款、奖学金种类、校园地图等),方便知识库素材准备
- 节奏把控:每天下午最后半小时为总结答疑时间,及时解决当天问题
- 分组安排:建议2-3人一组,分工协作(一人负责提示词优化,一人负责知识库/数据库,一人负责工作流/代码)
- 素材准备:第1天前需准备好:学生手册文本片段、奖学金Excel表、校园地图图片
