第一章 入门与核心概念

第一章 入门与核心概念

1.1 Coze 平台初识

1.1.1 核心价值：为什么选择 Coze？

大家好，欢迎来到我们的 Coze 学习之旅。在正式开始之前，我们先来聊一个问题：在 Coze 出现之前，如果我们想开发一个 AI 聊天机器人，通常需要做什么？

我们可能需要学习 Python 编程，了解并调用 OpenAI 或其他大模型的 API 接口，自己处理上下文记忆，甚至还要操心服务器部署的问题。整个过程对非技术人员来说，门槛非常高。而 Coze 的核心价值，就是把这一切都改变了。

我们可以把传统的 AI 开发比作“自己动手烧制砖块、挑水和泥，最后才开始盖房子”。而 Coze 则像一套先进的乐高积木，它已经把大模型、插件、数据库这些复杂的“砖块”都预先制作好了，我们只需要根据自己的蓝图，通过一个可视化的界面，将这些“积木”拼装起来，就能快速搭建出属于我们自己的 AI 应用。

这，就是 Coze 最大的魅力：它让我们能将精力从繁琐的技术实现中解放出来，真正聚焦于“创意”本身。 无论你是什么职业，只要你有想法，就有可能在几分钟或几小时内，创造出一个可用的 AI Bot。

1.1.2 平台定位：与 LangChain、Dify 等工具的对比

市面上还有像 LangChain、Dify 这样的工具，Coze 和它们有什么不同呢？搞清楚平台的定位，能帮助我们更好地选择合适的工具。我们可以通过一个表格来清晰地理解它们的差异：

特性维度CozeDifyLangChain
产品形态一站式SaaS平台开源、可私有化部署的平台面向开发者的代码框架/库
目标用户所有人（产品、运营、设计师、开发者）开发者、有一定技术背景的团队纯粹的 Python/JS 开发者
技术门槛极低，核心是可视化编排较低，需要懂部署和一些技术概念高，需要扎实的编程能力
灵活性适中，在平台框架内实现功能较高，可以修改源码进行深度定制极高，几乎不受任何限制
上手速度最快，分钟级即可见到雏形较快，需要先完成环境部署慢，需要编写大量代码

简单来说，我们的选择逻辑是：

  • 如果你追求最高的开发效率和最低的技术门槛，希望快速验证想法，那 Coze 是不二之选。
  • 如果你的团队有一定技术能力，并且对数据隐私、私有化部署有强需求，那么可以考虑 Dify。
  • 如果你是一名硬核开发者，需要最大限度地控制代码和架构，那么 LangChain 框架会是你的好伙伴。

1.2 工作区与界面导览

理论说完了，我们现在就登录 Coze 平台，亲眼看一看它的样子。当我们第一次进入 Coze 时，主要会接触到三个核心区域。

1.2.1 我的 Bot

这是我们的个人创作空间，我们创建的所有 Bot 都会在这里以卡片的形式列出，方便我们管理和查找。可以把它想象成我们自己的“机器人车间”。

image-20250730142856312

1.2.2 Bot 商店

这里是 Coze 的官方应用市场，汇集了大量由社区用户创建的优秀 Bot。我强烈建议初学者多来这里逛逛，它不仅能给你带来很多创作灵感，你还可以直接“复刻”这些 Bot 到自己的工作区，通过研究它们的配置来学习别人的最佳实践。

image-20250730142921987

1.2.3 核心编辑区

这是我们之后花费时间最多的地方。当我们在工作空间点击“创建 Bot”或编辑一个现有 Bot 时，就会进入这个三栏式的核心编辑界面。

image-20250730143111849

  • 左侧（技能区）： 这里陈列着我们 Bot 的所有“武器”，包括我们为它设定的提示词 (Prompt)、可供使用的插件 (Plugins)、挂载的知识库 (Knowledge)、以及数据库 (Database) 等。
  • 中间（编排区/主舞台）： 这是我们定义 Bot 行为的核心区域。我们主要在这里编写和优化我们的提示词，或者设计复杂的工作流 (Workflow)。
  • 右侧（预览与调试区）： 这里是一个实时的聊天窗口，我们对 Bot 的任何修改，都可以立刻在这里与它对话进行测试，极大地提升了调试效率。

1.3 Bot 开发的黄金法则

在 Coze 平台上开发一个 Bot 的完整流程，就像我们玩游戏做任务一样，遵循“创建 -> 调试 -> 发布 -> 迭代”这四个步骤，构成了一个闭环。

1.3.1 创建

一切始于一个想法。比如，我想做一个能帮我写周报的 Bot。于是，我点击“创建 Bot”，给它起个名字叫“深夜情感助手”，并加上描述，一个 Bot 的雏形就诞生了。

image-20250730144037791

1.3.2 调试

雏形有了，但它好用吗？我们需要对他进行初步定义，即我们创建出来的机器人他的底层角色究竟如何。我们可以通过Coze官方提供的提示词优化工具，它会基于你对于智能体的角色名与描述去简要填写提示词作为他的角色定义

image-20250730144414831

一个基础的提示词示例如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 角色
你是一个情感呵护机器人，专为内心脆弱的单身男女提供情感陪护，只传递正
向的情绪价值，绝不涉及任何负面内容，避免给对方带来负面情绪影响。

## 技能
### 技能1：倾听与回应
1. 认真倾听聊天对象分享的各种事情。
2. 基于对方的话语，给出积极、鼓励、安慰且充满正能量的回应。

### 技能2：主动引导积极话题
1. 在对话中适时主动开启积极向上的话题，如美好的回忆、有趣的爱好等。
2. 引导聊天对象关注生活中的美好和积极面。

## 限制：
- 对话内容必须围绕提供正向情感呵护展开，杜绝任何负面信息。
- 回应需简洁明了，符合积极正能量的风格。

至此，我们已经拥有了一个最简单的智能体，通过右侧的对话页面，我们即可对他进行快速的调试与沟通。

image-20250730144649414

1.3.3 发布

当我们的 Bot 在调试中表现良好后，就可以将它“发布”出去了。发布就像是把我们车间里的产品上架到商店。我们可以选择将它发布到飞书、微信公众号，甚至是豆包App上。只有发布之后，最终用户才能真正使用到我们的 Bot。

image-20250730144742589

点击确认后，我们可以选择接入到各个平台上，后续我们会详细讲解如何接入。

image-20250730144830880

1.3.4 迭代

发布不意味着结束，恰恰是优化的开始。当用户开始使用我们的 Bot 后，我们可以通过后台的“日志”功能，看到用户与 Bot 的真实对话记录。通过分析这些记录，我们会发现很多意想不到的问题，比如用户的一些提问方式我们没考虑到，或者某个插件偶尔会调用失败。这时，我们就要回到编辑区，针对性地进行修改和优化，然后发布新版本。

这个**“创建-调试-发布-迭代”**的闭环，就是我们在 Coze 平台上进行 Bot 开发的黄金法则。