第12章 Coze/扣子入门：30分钟搭建你的第一个智能体

Coze/扣子入门：30分钟搭建你的第一个智能体

Coze（海外版）和扣子（国内版）是字节跳动推出的AI智能体开发平台，也是目前国内最流行、最易用的低代码智能体平台之一。它的最大特点是"零代码"——你不需要写任何代码，只需要通过可视化的拖拽和配置，就能在几十分钟内搭建出一个功能完整的智能体。

本章将带你从零开始，在Coze/扣子平台上搭建你的第一个智能体。我们会用一个完整的实战案例，手把手教你完成从注册、创建、配置到发布的全流程。

一、Coze平台概览

1.1 什么是Coze/扣子？

Coze是字节跳动推出的一站式AI智能体开发平台。它提供了从智能体创建、配置、调试到发布的全流程工具，让任何人都能轻松创建自己的AI智能体。

两个版本的区别：

两个版本的核心功能和操作方式基本一致，只是支持的模型和发布渠道不同。国内用户建议使用扣子（coze.cn），访问速度更快，支持的国内平台更多。

1.2 Coze的核心功能模块

Coze平台的核心功能可以分为以下几个模块：

1.3 注册和登录

注册步骤：

1. 打开扣子官网：https://www.coze.cn
2. 点击右上角"登录"，可以用手机号、抖音账号、飞书账号或Google账号登录
3. 登录后进入工作台，就可以开始创建智能体了

注意：首次使用可能需要完成实名认证（国内平台的合规要求），按照提示操作即可。

二、实战：30分钟搭建"制造业设备维修助手"

理论讲了这么多，让我们通过一个完整的实战案例，手把手教你在Coze上搭建第一个智能体。我们要做的是一个"制造业设备维修助手"——维修工输入故障现象，智能体给出诊断建议和维修步骤。

第一步：创建智能体

1. 登录扣子工作台，点击左上角"创建智能体"按钮（或"+"号）
2. 在弹出的创建页面中，填写基本信息：
   • 智能体名称：设备维修助手
   • 智能体描述：帮助制造业维修工诊断设备故障、提供维修步骤和安全注意事项
   • 头像：可以选择系统默认头像，或上传自定义头像（建议用一个扳手或齿轮的图标）
3. 点击"确认"，进入智能体配置页面

第二步：配置角色和提示词（Persona & Prompt）

这是最关键的一步——定义智能体的角色和行为。在"人设与回复逻辑"配置区，填写以下内容：

# 角色
你是一位有15年经验的制造业设备维修专家，精通各类工业设备的故障诊断和维修，
包括空压机、电机、泵类、机床、自动化生产线等。你说话专业、严谨、有条理，
非常注重安全操作规范。

# 能力
1. 设备故障诊断：根据用户描述的故障现象，分析可能的原因，按可能性排序
2. 维修步骤指导：提供详细的、分步骤的维修操作指南
3. 安全注意事项：在涉及危险操作时，必须强调安全规范和防护措施
4. 工具和备件建议：推荐维修需要的工具和备件
5. 预防维护建议：给出日常维护和预防故障的建议

# 工作流程
当用户描述故障时，按照以下步骤回答：
1. 先复述用户描述的故障现象，确认理解正确
2. 分析可能的故障原因，按可能性从高到低排序，每个原因说明判断依据
3. 给出详细的维修步骤，分步骤编号，每步说明操作要点
4. 列出需要的工具和备件
5. 强调安全注意事项（特别是涉及电气、高压、高温、旋转部件时）
6. 给出预防此类故障的日常维护建议

# 约束
1. 必须基于制造业设备维修的专业知识回答，不要编造不存在的故障或维修方法
2. 如果故障现象描述不清晰，先向用户询问更多信息（设备型号、故障发生时间、异常声音/气味/温度等），不要盲目诊断
3. 涉及安全的操作必须强调"断电、泄压、挂牌上锁"等安全规范
4. 如果是复杂或危险的故障（如压力容器、起重设备、高压电气），必须建议用户联系专业人员或设备厂家，不要自行维修
5. 回答要分步骤、有条理，使用编号列表
6. 不要回答与设备维修无关的问题

# 输出格式
## 故障确认
（复述用户描述的故障现象）

## 可能原因分析
1. 【可能性高】原因1 - 判断依据
2. 【可能性中】原因2 - 判断依据
3. 【可能性低】原因3 - 判断依据

## 维修步骤
1. 步骤1 - 操作要点
2. 步骤2 - 操作要点
...

## 所需工具和备件
- 工具1、工具2...
- 备件1、备件2...

## 安全注意事项
⚠️ （强调安全规范和防护措施）

## 预防维护建议
1. 建议1
2. 建议2

提示词设计要点：

• 角色定义要具体（"15年经验的设备维修专家"比"维修专家"好）
• 能力范围要明确（能做什么、不能做什么）
• 工作流程要清晰（按什么步骤回答）
• 约束条件要严格（安全规范、不编造、不回答无关问题）
• 输出格式要固定（用模板约束输出结构）

第三步：选择模型

在"模型"配置区，选择合适的大模型：

• 豆包Pro：字节跳动的旗舰模型，能力强，速度快，推荐首选
• 豆包Lite：轻量模型，速度快，成本低，适合简单任务
• 通义千问：阿里的模型，中文理解好
• 文心一言：百度的模型，知识丰富

建议：初学者先用"豆包Pro"，能力均衡，效果好。模型参数（温度、最大长度等）保持默认即可，后续可以根据需要调整。

第四步：添加插件（可选但推荐）

插件可以扩展智能体的能力。对于设备维修助手，推荐添加以下插件：

1. 在"插件"配置区，点击"添加插件"
2. 在插件市场中搜索并添加：
   • 搜索：让智能体可以搜索网络上的设备维修资料和故障案例
   • 代码执行器：让智能体可以执行简单的计算（如电流、功率、转速计算）
   • 图片理解：让智能体可以分析用户上传的设备故障照片（如果支持）
3. 添加后，插件会出现在已添加列表中，可以设置是否启用

注意：插件不是越多越好，只添加你真正需要的。插件太多会让大模型"选择困难"，降低调用准确率。

第五步：添加知识库（核心功能）

知识库是让智能体拥有专业知识的关键。对于设备维修助手，我们可以上传设备维修手册、故障案例集、安全操作规程等。

1. 在"知识库"配置区，点击"添加知识库"
2. 选择"创建知识库"，填写知识库名称（如"设备维修知识库"）
3. 上传文档：
   • 支持PDF、Word、Excel、PPT、txt、markdown等格式
   • 可以上传多个文件，也可以上传整个文件夹
   • 建议先上传2-3份典型的设备维修手册作为测试
4. 设置分段策略：
   • 自动分段：系统自动按语义分段，推荐初学者使用
   • 自定义分段：可以设置分段大小和重叠，适合有经验的用户
5. 点击"确认"，系统开始解析和向量化文档（这个过程可能需要几分钟，取决于文档大小）
6. 解析完成后，知识库就可以被智能体使用了

知识库设置建议：

• 检索模式：选择"混合检索"（语义+关键词），效果最好
• 召回数量：默认3-5条，效果不好可以调整
• 最低相似度：设置0.5-0.7，过滤不相关的结果
• 在提示词中明确告诉智能体"必须基于知识库中的信息回答，如果知识库中没有，说明并给出通用建议"

第六步：调试和测试

配置完成后，在右侧的"预览"窗口中测试智能体的效果。这是非常重要的一步——通过测试发现问题，不断优化。

测试用例：

1. 基础测试："3号空压机异响，温度95度，压力表读数0.8MPa"
   • 检查：是否按预设的输出格式回答？故障原因分析是否合理？维修步骤是否详细？安全注意事项是否到位？
2. 知识库测试：问一个知识库中有明确答案的问题，检查是否能正确检索和引用
   • 例如："空压机的日常维护项目有哪些？"（如果知识库中有维护手册）
3. 边界测试："我们厂的锅炉压力异常，该怎么处理？"
   • 检查：是否识别出这是危险设备（压力容器），是否建议联系专业人员？
4. 信息不足测试："设备坏了，怎么办？"
   • 检查：是否先询问更多信息（设备类型、故障现象），而不是盲目诊断？
5. 无关问题测试："今天天气怎么样？"
   • 检查：是否拒绝回答无关问题，引导回到设备维修话题？

调试技巧：

• 每次只改一个地方（提示词/插件/知识库设置），观察效果变化
• 如果回答格式不对，在提示词中加强格式约束，或给出示例
• 如果知识库检索不到，检查文档是否解析成功、分段是否合理、检索设置是否正确
• 如果插件调用错误，检查插件描述是否清晰、参数是否正确
• 保存好的测试用例，后续修改后回归测试

第七步：发布智能体

测试满意后，就可以发布智能体了。点击右上角的"发布"按钮：

1. 填写发布信息：
   • 版本说明：简要说明这个版本的功能（如"首次发布，支持设备故障诊断和维修指导"）
   • 分类：选择合适的分类（如"工业制造"、"技术支持"）
   • 标签：添加标签（如"设备维修"、"制造业"、"故障诊断"）
2. 选择发布渠道：
   • 扣子商店：发布到扣子的智能体商店，所有人都可以搜索和使用
   • 网页：生成一个独立的网页链接，可以分享给任何人
   • 飞书：发布为飞书机器人，在飞书中使用
   • 微信：发布为微信公众号/小程序（需要微信公众号账号）
   • 抖音：发布到抖音（需要抖音企业号）
   • API：生成API接口，可以集成到自己的应用中
3. 点击"发布"，等待审核（一般几分钟到几小时）
4. 审核通过后，智能体就正式上线了！

初学者建议：第一次发布先选"网页"渠道，生成一个链接，自己和朋友测试使用。确认没问题后，再考虑发布到商店或其他平台。

三、Coze使用技巧和常见问题

3.1 提升智能体效果的技巧

1. 提示词是核心：花80%的时间优化提示词。一个好的提示词比换模型、加插件更有效。
2. 给出示例：在提示词中给出1-2个"输入-输出"的示例，大模型会更准确地理解你的要求。
3. 知识库质量决定上限：知识库的文档质量、组织结构、分段策略直接影响RAG效果。花时间整理好文档。
4. 从小范围开始：先让智能体专注于一类设备（如空压机），做深做透，再扩展到更多设备。
5. 持续迭代：发布不是结束，而是开始。收集用户反馈，不断优化提示词、知识库和插件。
6. 用工作流处理复杂任务：如果智能体需要完成多步骤的复杂任务，用工作流编排，而不是全靠提示词。

3.2 常见问题排查

3.3 免费额度和计费

扣子个人版有免费额度，足够学习和小型项目使用。免费额度包括：

• 一定数量的大模型调用次数（每月重置）
• 一定的知识库存储空间
• 一定的插件调用次数

如果免费额度不够用，可以升级到付费版（团队版/企业版），获得更多额度和高级功能（如私有化部署、SSO、审计日志等）。

下一章，我们将深入学习Coze的进阶功能——插件开发、工作流深度编排、知识库优化、多智能体协作等，让你从"会用"进阶到"用好"。

📝 本章练习（5题）

答案与解析请在 互动学习看板 中作答查看。

📚 AI智能体实战训练营 课程目录（33 章）

1. 第1章 什么是AI智能体：从聊天机器人到自主决策系统
2. 第2章 智能体的四大核心能力：感知·思考·行动·记忆
3. 第3章 范式转移：智能体与传统软件的本质区别
4. 第4章 2025年主流智能体平台全景对比与选型
5. 第5章 智能体应用场景地图：从个人效率到企业级落地
6. 第6章 编排思维：如何把大模型变成可执行的业务流程
7. 第7章 Prompt工程实战：写出让智能体精准执行的指令
8. 第8章 工作流编排入门：节点、连线、条件分支与循环
9. 第9章 知识库RAG实战：让智能体拥有你的专业数据
10. 第10章 工具调用实战：搜索·计算·API·数据库全掌握
11. 第11章 多智能体协作：角色分工、任务分发与结果汇总
12. 第12章 Coze/扣子入门：30分钟搭建你的第一个智能体
13. 第13章 Coze进阶：插件开发、工作流深度编排与知识库优化
14. 第14章 Dify入门：开源可私有化部署的智能体平台搭建
15. 第15章 Dify进阶：RAG管道优化、Agent模式与工作流编排
16. 第16章 LangChain入门：用代码构建可定制的智能体应用
17. 第17章 LangChain实战：自定义Agent、工具链与记忆系统
18. 第18章 Agent Harness与新一代框架：2025年智能体开发趋势
19. 第19章 平台选型决策树：不同业务场景下的最优平台选择
20. 第20章 任务拆解方法论：把复杂问题变成智能体可执行的步骤
21. 第21章 提示词编排艺术：System·User·Function的三层协同
22. 第22章 记忆系统设计：短期记忆、长期记忆与向量数据库选型
23. 第23章 错误处理与容错：智能体执行失败时的兜底策略
24. 第24章 评估与优化体系：如何量化衡量智能体的效果并持续改进
25. 第25章 安全与合规：智能体应用的数据安全、隐私保护与风险防控
26. 第26章 实战项目一：企业知识库智能问答助手（全流程实操）
27. 第27章 实战项目二：制造业设备故障诊断智能体
28. 第28章 实战项目三：供应链采购智能分析与比价助手
29. 第29章 实战项目四：多智能体协同的项目管理办公室（PMO）
30. 第30章 实战项目五：智能体与MES/ERP系统的深度集成
31. 第31章 智能体落地路线图：从POC验证到规模化应用的完整路径
32. 第32章 AI智能体工程师/产品经理的能力模型与成长路径
33. 第33章 作品集打造与面试准备：如何拿到AI智能体岗位Offer