Coze 智能体开发：插件、知识库与数据库实战指南

2. 按收费方式分类

申请密钥型：调用前需要先申请第三方平台的 API 密钥（如调用百度地图、微信接口等）。

扣资源点型：每次调用扣除 Coze 资源点（普通用户每天有 500 个免费资源点，足够日常开发测试）；

2.3 插件的使用：3 步快速集成，零代码也能上手

Coze 的插件使用非常简单，无需编写复杂代码，通过可视化界面即可完成添加和调用，具体步骤如下：

第一步：创建插件智能体

访问 Coze 开发平台，进入'工作空间'→'项目开发'；点击'创建智能体'，选择'标准创建'，填写名称（如'天气查询助手'）和功能描述（如'实时查询各地天气，提供出行建议'）；选择模式为'单 Agent（自主规划模式）'，完成基础创建。

第二步：添加插件（核心步骤）

选中插件后点击'添加'，系统自动将其集成到智能体技能库中，无需额外代码开发。

在插件市场中搜索目标插件（如'墨迹天气'），支持按功能分类筛选（如'数据查询'）；

进入智能体开发页面，找到左侧'技能'→'插件'功能区，点击'添加插件'；

小贴士：添加插件后，一定要查看插件的参数说明（如天气插件需要'城市名称'参数，地图插件需要'起点'和'终点'参数），后续编写提示词时要确保传参正确。

第三步：编写提示词，调用插件

要让智能体在合适的场景自动调用插件，需要在提示词中明确触发条件和参数传递。以下是两个常用插件的调用示例：

示例 1：天气查询插件

# 角色 你是一个专业的天气查询助手，能为用户提供实时天气信息和出行建议。
# 技能
## 技能 1：查询天气
1. 当用户询问"XX 天气"、"XX 今天天气"等相关问题时，自动提取城市名称；
2. 调用【墨迹天气】插件，传入城市名称参数，获取实时天气数据；
3. 整理天气结果（气温、风向、湿度），并给出出行建议（如带伞、防晒等）。
# 限制
- 只处理天气查询相关问题，拒绝回答无关话题；
- 若用户未指定城市，默认查询当前 IP 所在地天气；
- 严格按照插件返回数据回复，不编造天气信息。

示例 2：图片生成插件

# 角色 你是一个创意图片生成助手，能根据用户描述生成高质量图片。
# 技能
## 技能 1：生成图片
1. 当用户说"生成 XX 图片"、"画一张 XX"等需求时，提取核心关键词（主题、风格、色调）；
2. 调用【ByteArtist】图片生成插件，传入关键词参数；
3. 将生成的图片链接返回给用户，并询问是否需要调整。
# 示例
用户：生成一张"秋日森林里的小鹿，水彩风格，暖色调"
智能体：已为你生成图片，请查收：[图片链接]，是否需要调整风格或细节？
# 限制
- 不生成违法、低俗、侵权的图片内容；
- 若用户描述不清晰，先追问补充信息（如风格、尺寸、场景）。

第四步：调试插件，确保正常运行

插件调用可能会遇到参数错误、接口异常等问题，需要通过'预览与调试'面板测试：

若插件返回结果异常，可查看'调试日志'，确认是参数问题还是插件本身故障（如第三方接口宕机）。

查看智能体是否自动调用插件，若调用失败，检查提示词中的触发条件和参数是否正确；

在智能体开发页面右侧，输入测试问题（如'查询北京今天的天气'）；

三、知识库：给智能体装上'大脑外挂'，让 AI'懂专业、不胡说'

3.1 什么是知识库？——智能体的'私人图书馆'

在 Coze 平台中，知识库是用于存储和管理外部数据的核心功能模块，允许开发者上传各类文本、表格、图片等内容，通过 AI 技术进行处理和检索，为智能体提供准确的信息支持。

简单来说，知识库是智能体专属的、可信任的'私人图书馆'或'大脑外挂硬盘'，它存储了公共 AI 模型不知道的、你私有的信息（如公司制度、产品手册、行业资料、个人笔记等），让智能体的回答不再泛泛而谈，而是精准、具体、有据可查。

没有知识库的智能体，就像一个'只会背课本的学生'——回答问题全靠训练数据，遇到专业问题或私有信息就会'胡说八道'（即 AI 幻觉）；有了知识库，智能体就变成了'有参考书的学霸'，能精准引用专业知识，给出权威答案。

我们用'新员工助手'案例理解知识库的价值：假设你是公司 HR，搭建了一个'新员工助手'智能体。没有知识库时，新员工问'报销流程怎么走'，智能体只能回答'一般企业报销需要提交单据、主管审批、财务审核'——正确但无用；有了知识库后，你上传《财务报销制度.docx》，智能体能直接回复：'根据公司制度第四章，出差车费报销流程：1. 准备出差申请单和票据；2. 登录钉钉→审批→费用报销；3. 直属上级→部门总监→财务部审核，5 个工作日内完成'，精准又具体。

知识库的核心价值在于：解决 AI'幻觉'问题，提供权威答案，将通用聊天机器人升级为专业领域专家。

3.2 什么是 RAG？——知识库的'智能检索引擎'

提到知识库，就必须提到 RAG（Retrieval-Augmented Generation，检索增强生成）——这是知识库能发挥作用的核心技术。RAG 的核心思想很简单：在大模型生成答案之前，先让它去指定的知识库中查找相关信息，再根据找到的准确信息组织答案。

我们用'考试'来比喻 RAG 的作用：

没有 RAG 的大模型：像闭卷考试的学生，只能靠自己的记忆（训练数据）答题，记不住或记错了就会答错； 有 RAG 的大模型：像开卷考试的学生，遇到问题先翻参考书（知识库），找到相关段落再答题，准确率大幅提升。

RAG 的工作流程分为三步：

检索：用户提问后，系统从知识库中搜索与问题最相关的内容片段； 增强：将检索到的内容和用户问题组合成提示词，传给大模型； 生成：大模型基于检索到的准确信息，生成符合要求的答案。

举个实际例子：知识库内容：'公司 2024 年团建将于 1 月 15 日在三亚举行'用户问题：'我们今年团建在哪举办？'

无 RAG：模型可能回答'团建通常在本地公园或酒店举行'（幻觉）； 有 RAG：模型先检索到知识库中的相关片段，再生成答案'根据公司计划，2024 年团建将在三亚举行'（准确）。

简单来说，知识库是'图书馆里的藏书'，RAG 是'专业的图书管理员'，二者结合才能让智能体快速找到所需知识，给出精准答案。

3.3 知识库的分类：支持多格式，覆盖全场景

Coze 知识库支持多种格式和来源，能满足不同场景的知识存储需求：

1. 按存储格式分类

2. 按构建来源分类

本地文件上传：直接上传电脑中的文件（支持.txt、.pdf、.docx、.csv 等），最常用、最快捷； 在线网站抓取：输入 URL 网址，抓取指定网页或整个站点的内容（支持自动采集和手动采集），适合整合实时资讯； 第三方平台集成：直接从飞书文档、Notion 等平台导入内容，方便企业对接已有知识管理体系； API 接口同步：通过 API 方式将 JSON 数据上传至知识库，适合动态更新的数据（如商品库存、实时价格）； 手动自定义输入：直接在 Coze 平台手动输入文本或表格数据，适合添加零散知识点。

3.4 知识库的使用：从创建到应用，全程零代码

第一步：创建知识库

选择知识类型（文本 / 表格 / 照片），点击'添加知识'，选择导入方式（本地文件 / URL / 手动输入）。

点击'创建知识库'，填写名称（如'公司新员工知识库'）和描述（如'包含入职指南、报销制度、考勤规定'）；

访问 Coze 开发平台，进入智能体开发页面，找到左侧'知识'→'知识库'；

示例：上传《新员工入职指南.pdf》，系统会自动将文档分割成一个个内容片段（分段），便于后续检索。

第二步：配置知识库检索规则

进入知识库设置，设置检索策略（默认'混合检索'，兼顾准确率和召回率）；调整最小匹配度（默认 0.8，数值越高检索越精准，避免无关内容干扰）；开启'查询改写'和'结果重排'（优化检索效果，提升答案准确性）。

第三步：编写提示词，关联知识库

要让智能体在回答问题时自动检索知识库，需要在提示词中明确关联，示例如下：

# 角色 你是公司的新员工助手，负责解答新员工的各类咨询，提供准确的公司相关信息。
# 技能
## 技能 1：解答入职相关问题
1. 当用户询问入职流程、Wi-Fi 密码、部门联系方式等问题时，自动检索【公司新员工知识库】；
2. 基于知识库中的内容，用简洁明了的语言回答，避免使用专业术语；
3. 若知识库中没有相关信息，回复"该问题暂未收录，建议咨询直属上级或 HR"。
## 技能 2：解答报销相关问题
1. 当用户询问报销流程、票据要求、审批节点等问题时，检索知识库中的《财务报销制度》；
2. 详细说明步骤和注意事项，必要时提供操作截图（知识库中上传的截图）；
3. 主动询问是否需要提供相关模板链接。
# 限制
- 只回答与公司相关的问题，拒绝回答无关话题；
- 严格按照知识库内容回复，不编造信息；
- 语言亲切，使用"亲~"、"呢"等语气词，增强亲和力。
# 开场白 哈喽~ 我是你的新员工小助手！关于入职流程、报销制度、考勤规定等问题，都可以问我哦，我会为你提供准确答案和实用建议～

第四步：测试知识库效果

在'预览与调试'面板输入测试问题（如'公司 Wi-Fi 密码是多少？'、'出差车费怎么报销？'）；查看智能体是否自动检索知识库，回答是否准确引用文档内容；若回答不准确，检查知识库中是否有相关内容，或调整检索策略（如降低最小匹配度）。

四、数据库：给智能体装上'长期记忆'，让 AI'记得你、懂你'

4.1 什么是数据库？——智能体的'记忆中枢'

Coze 数据库是字节跳动提供的结构化数据存储服务，采用类 NoSQL 的文档模型，支持通过自然语言或 SQL 语句进行数据的增删改查操作。作为智能体的'长期记忆'组件，它能够持久化存储用户交互数据、业务配置信息和应用状态，是构建复杂 AI 应用的核心基础设施。

简单来说，数据库是智能体结构化、可查询的'长期记忆系统'，用来存储需要长期保存和随时查询的用户个人数据和交易数据（如健身记录、消费明细、偏好设置等）。

没有数据库的智能体，就像一个'失忆症患者'——每次对话都是新的开始，记不住用户的历史数据，无法提供个性化服务；有了数据库，智能体就变成了'贴心管家'，能记住你的习惯、偏好和历史记录，提供千人千面的个性化服务。

我们用'个人健身教练'案例理解数据库的价值：假设你搭建了一个'健身教练'智能体，没有数据库时，你问'我上次深蹲多少公斤'，智能体只能回答'新手建议从空杆开始'；有了数据库后，你每次记录训练数据（如'今天深蹲 5 组 5 次，65 公斤'），智能体都会存入数据库，下次你询问时，它能回复'你上次深蹲是 65 公斤，比上上次进步了 2.5 公斤，下周可以尝试 67.5 公斤'，真正实现个性化指导。

数据库的核心价值在于：实现真正的个性化服务，让智能体从'一视同仁'的百科全书，变成了解你个人历史和行为的专属助手。

4.2 数据库与知识库的区别：别再搞混了！

很多新手会混淆数据库和知识库，其实二者的核心区别很明确：

简单总结：知识库管'知识'，数据库管'数据'；知识库让智能体'懂专业'，数据库让智能体'懂用户'。

4.3 数据库的使用：从创建到操作，零代码也能搞定

Coze 数据库支持零代码操作，无需编写复杂 SQL 语句（当然也支持 SQL 查询），具体使用步骤如下：

第一步：创建数据库

填写数据库名称（如'健身训练记录'）和描述（如'存储用户的训练动作、重量、组数等数据'），点击'创建'。

点击'创建数据库'，选择数据库类型（推荐'扣子数据库'，适合数据量较小的场景；'火山数据库'适合大规模数据）；

访问 Coze 开发平台，进入智能体开发页面，找到左侧'知识'→'数据库'；

第二步：设计数据表（核心步骤）

创建数据库后，需要设计数据表结构，添加字段（列），示例如下（以健身训练记录为例）：

Coze 数据库支持的字段类型包括：**字符串（String）、整数（Integer）、浮点数（Number）、布尔值（Boolean）、时间（Time）**等，可根据需求选择。

第三步：添加测试数据

数据表创建完成后，点击'添加行'，手动输入测试数据（如 user_id="user123"，exercise_name="深蹲"，weight=65，sets=5，reps=5）；支持批量导入（上传.csv 或.xlsx 文件），适合已有数据的场景。

第四步：编写提示词，操作数据库

要让智能体自动读写数据库，需要在提示词中明确触发条件和操作类型（增删改查），示例如下：

# 角色 你是专业的个人健身教练，负责记录用户的训练数据，提供个性化训练建议。
# 技能
## 技能 1：记录训练数据（新增数据）
1. 当用户说"记录训练"、"今天练了"等语句时，提取关键信息（训练动作、重量、组数、次数）；
2. 自动写入数据库"workout_records"表，user_id 默认当前用户，training_date 默认当前日期；
3. 回复确认信息，并简单分析进步情况（如"已记录深蹲 5×5@65kg，比上次进步 2.5kg，真棒！"）。
## 技能 2：查询训练记录（查询数据）
1. 当用户询问"上次 XX 多少"、"XX 历史记录"等语句时，检索数据库对应记录；
2. 按训练日期排序，展示最近 3 次训练数据，生成进步曲线描述；
3. 基于历史数据给出下次训练建议。
## 技能 3：修改训练数据（更新数据）
1. 当用户说"修改 XX 记录"、"上次记录错了"等语句时，找到对应记录；
2. 按用户要求修改重量、组数等信息，修改后确认；
3. 若未找到对应记录，提示用户重新提供训练日期和动作。
## 技能 4：删除训练数据（删除数据）
1. 当用户说"删除 XX 记录"、"取消 XX 训练"等语句时，找到对应记录；
2. 询问用户确认后删除，删除后提示"已删除 XX 年 XX 月 XX 日的 XX 训练记录"；
3. 禁止批量删除数据，每次只能删除单条记录。
# 限制
- 只处理训练相关数据操作，拒绝其他数据操作请求；
- 严格按照用户指令操作数据库，不擅自修改或删除数据；
- 保护用户隐私，不泄露其他用户的训练数据。
# 开场白 哈喽~ 我是你的专属健身教练！可以帮你记录训练数据、查询历史记录、提供个性化建议～请告诉我你的训练情况，或询问历史记录哦！

第五步：测试数据库操作

在'预览与调试'面板输入测试指令：查看智能体是否正确操作数据库，回复是否准确；若操作失败，检查提示词中的字段名称是否与数据表一致，或数据类型是否匹配（如重量必须是数字）。

五、资源使用避坑指南：新手必看

插件调用：一定要确认参数是否必填（如天气插件必须传'城市名称'），避免因参数缺失导致调用失败； 知识库：上传文档时尽量选择清晰、结构化的内容，避免杂乱无章的文本（影响检索效果）； 数据库：设计字段时明确必填项和数据类型，避免后续操作时因数据格式错误导致失败； 资源组合：不是资源越多越好，根据智能体的核心功能选择必要的资源（如简单的天气查询只需要插件，无需数据库）； 免费额度：普通用户每天有 500 个免费资源点，调用插件时注意控制次数（复杂插件消耗更多资源点）； 隐私保护：数据库中存储用户隐私数据（如手机号、消费记录）时，设置访问权限，避免泄露。

总结

Coze 的资源系统是智能体开发的核心，插件让智能体'能做事'，知识库让智能体'懂专业'，数据库让智能体'记得住'——三者结合，就能让你的 AI 助手从'会聊天'进化为'能办事、办好事'的实用工具。

作为新手，无需一开始就掌握所有资源，建议先从插件入手（最容易上手，效果立竿见影），再逐步学习知识库和数据库，最后尝试三者协同使用。随着对资源的熟悉，你会发现 Coze 智能体的能力边界不断扩展，从简单的信息查询到复杂的业务流程自动化，都能轻松实现。