Coze 快速入门：从注册到发布一个可用的 Bot

Coze 是一个用于搭建对话式 Bot 的平台。它把「写提示词、挂工具、配变量、调试、发布」这几件事收在同一个界面里，让不写代码的人也能做出一个能对话、能查资料、能按固定人设回应的 Bot；对熟悉开发的用户，它同样提供了插件与工具这一层扩展能力。这篇教程面向第一次上手的人：从注册账号开始，走完创建、配置、调试、发布的完整链路，最后说明如何用平台自带的预置 Bot 缩短起步时间。如果你只是想先看看站内还有哪些同类工具，可以从 Coze 这一页进入。

需要先说明一点：Coze 的界面、套餐、可用模型与插件清单会随时间调整，本文只讲流程与概念，涉及价格、配额、版本、地区可用性的内容请以官网当前信息为准。

准备工作

在动手之前，把下面几件事确认清楚，后面会顺很多。

• 一个可用的账号。Coze 需要注册或登录后才能进入工作台。注册时通常需要一个可接收验证的邮箱或第三方账号，具体支持哪些登录方式以官网当前提供的选项为准。
• 想清楚 Bot 要解决什么问题。这是最容易被跳过、却最影响成败的一步。是回答某类常见问题？是抓取并汇总新闻？是做互动式讲故事？目标不同，提示词写法、要不要挂插件、要不要配变量都会不同。
• 准备好提示词草稿。先在文本编辑器里把 Bot 的身份、职责边界、回答风格、禁止事项写下来，再粘进平台。直接在网页输入框里现想，往往会漏掉约束条件。
• 确认目标发布渠道。Bot 做完之后要发布到哪里，决定了你在发布环节需要做哪些额外配置。这一步在创建之前想清楚，可以避免做完发现渠道不支持而返工。
• 浏览器环境。平台是网页端操作，建议使用较新版本的浏览器，避免在编辑长提示词时出现输入异常。

不需要提前准备服务器、数据库或 API 密钥。Coze 的定位就是把基础设施挡在界面之后，插件与工具由平台侧提供，你只需要在配置里选用。

操作步骤

第一步：注册或登录

打开 Coze 平台，完成注册或登录。登录成功后进入的是工作台界面，左侧是导航栏，右侧是内容区。第一次进入时，平台会给出一个快速上手的引导，可以顺着它熟悉一下布局，但不必严格照做——下面的步骤会覆盖创建 Bot 所需的全部环节。

如果团队协作，注意区分个人空间与团队空间。Bot 建在哪个空间下，后续的可见范围与发布权限就跟着哪个空间走。这一点在多人共用账号体系时尤其容易出错。

第二步：进入 Bots 标签页并新建

在左侧导航栏找到 Bots 标签页，点击进入 Bot 列表。列表页会展示当前空间下已有的 Bot，右上角或列表区域提供 Create（创建）入口，点击后进入新建流程。

新建时平台会要求你填写两项基础信息：

• 名称（identifier）。用一句话概括这个 Bot 是干什么的，让使用者在列表里一眼能认出来。名称会出现在后续的调试与发布环节，起名时避免使用过于宽泛的词。
• 描述（description）。简要说明 Bot 的能力范围。描述不只是给人看的，它也会影响使用者对这个 Bot 的预期，写得具体比写得漂亮更有用。

填完基础信息后进入 Bot 的编辑页面。这个页面是后续所有配置的主战场，通常包含人设与提示词、插件与工具、变量、预览调试等几个区域。

第三步：编写 Persona & Prompt

在 Persona & Prompt 区域填写 Bot 的核心指令。这一段决定了 Bot 的行为方式，是整个配置里权重最高的部分。它需要同时交代三件事：

• 身份。Bot 扮演什么角色，服务哪类用户。例如「面向新用户的售后答疑助手」。
• 能力与约束。能回答什么、不能回答什么、遇到超出范围的问题该怎么处理。把「不知道就说不知道，并引导用户走人工渠道」这类兜底规则写进去，比事后调试省力得多。
• 行为与风格。回答长度、语气、是否使用列表、是否主动追问澄清。风格描述越具体，输出越稳定。

写提示词时，建议用分点结构而不是一整段散文。分点让模型更容易区分「必须遵守」和「建议遵守」的内容。另外，把示例对话（用户问什么、Bot 该怎么答）写进提示词，通常比单纯描述规则效果更好。

提示词不是一次写完就结束的。写完先跑几轮预览，把答得不对的案例记下来，回头补规则，再跑。这个循环会重复若干次。

第四步：挂载插件与工具

如果 Bot 需要获取实时信息或执行外部动作，仅靠提示词是不够的，需要挂载插件。插件是平台提供的能力包，每个插件下包含若干具体工具（tool），你需要选用到具体工具这一层，而不是只选插件。

素材里给出的典型例子是：挂载 Google News Search 插件，并选用其中的 searchNews 工具，从而做出一个能抓取新闻的 Bot。这个例子说明了配置的粒度——插件是分类，工具才是实际被调用的能力。

挂载时需要注意几点：

• 只挂需要的。工具挂得越多，模型在决定调用哪个工具时越容易犹豫或选错。按 Bot 的实际职责挑选，不要为了「功能全」而堆砌。
• 在提示词里说明何时调用。挂上工具不等于模型会自动用。在人设与提示词里写清「当用户询问近期新闻时，调用 searchNews 检索后再回答」，能显著提高调用准确率。
• 考虑工具失败的情况。外部检索可能返回空结果或报错，提示词里应约定失败时的回应方式，避免 Bot 编造内容。

第五步：配置变量

变量用于保存 Bot 在对话中需要记住或反复使用的信息，比如用户称呼、所在地区、偏好设置等。在变量配置区域添加变量时，需要给出变量名、类型与用途说明。

变量不是越多越好。只添加那些确实会影响回答内容的字段，并在提示词中说明这些变量在什么场景下被读取、被更新。变量定义得含糊，模型就不知道什么时候该用，最终等于没配。

第六步：预览与调试

编辑页面提供 Preview & Debug 区域，可以在不发布的情况下直接与 Bot 对话。这是整个流程里最需要花时间的环节。

调试时建议按下面的顺序推进：

1. 跑正常路径。用最典型的几个问题测试，确认 Bot 能给出符合预期的回答。
2. 跑边界情况。问一些超出职责范围的问题，看它是否按提示词里的兜底规则回应，而不是硬答。
3. 验证工具调用。针对需要插件的场景提问，确认工具确实被触发、返回结果被正确使用。
4. 验证变量。如果配置了变量，测试变量在对话中是否被正确读取与更新。
5. 检查风格一致性。多轮对话之后，观察 Bot 是否还维持着设定的人设与语气。

发现问题的处理方式通常是回到提示词补规则，而不是反复重试期待它自己变好。如果某个问题反复出现，说明提示词里缺少对应的约束，或者约束写得不够明确。

第七步：发布

调试满意后，点击 Publish（发布）。发布环节会让你选择 Bot 要投放的渠道，平台支持把 Bot 发布到若干外部平台，具体可选渠道以官网当前提供的列表为准。不同渠道对 Bot 的能力支持程度不同，发布前需要确认目标渠道是否支持你已配置的插件与变量。

发布之后，Bot 就可以在所选平台上与用户交互了。后续如果修改了提示词或插件配置，通常需要重新发布才能让改动在已投放的渠道上生效——这一点在迭代阶段容易被忽略，导致「明明改了却没效果」。

一个完整示例

下面用一个最小但完整的例子把上面的步骤串起来。目标是做一个「行业新闻速递」Bot：用户问某个话题的近期新闻，Bot 检索后给出摘要。

基础信息

• 名称：行业新闻速递
• 描述：根据用户给出的话题，检索近期新闻并给出简要摘要。

Persona & Prompt

你是「行业新闻速递」，一个帮助用户快速了解近期新闻的助手。

职责：
1. 当用户提出话题时，调用 searchNews 工具检索该话题的近期新闻。
2. 从检索结果中挑选 3 到 5 条最相关的，每条用一到两句话概括。
3. 每条摘要后注明来源与时间（若检索结果中包含）。

约束：
- 只基于检索结果作答，不得自行补充或推测未出现在结果中的事实。
- 若检索结果为空或工具调用失败，直接告知用户「暂时没有检索到相关新闻」，不要编造内容。
- 若用户未说明话题，先追问澄清，不要自行假设。

风格：
- 使用简洁的列表输出，不使用夸张措辞。
- 全程使用中文回答。

插件与工具

• 插件：Google News Search
• 工具：searchNews

变量

• 话题偏好（文本）：记录用户常关注的话题，用于后续追问时提供默认方向。

调试用例

1. 输入「最近人工智能领域有什么新闻」——预期：触发 searchNews，返回 3 到 5 条带来源的摘要。
2. 输入「你好」——预期：不触发工具，追问用户想了解什么话题。
3. 输入一个检索不到结果的小众话题——预期：明确告知未检索到，不编造。

发布

三个用例都通过后点击 Publish，选择目标渠道完成投放。发布后如果调整了提示词里的摘要条数或风格，记得重新发布。

复用预置 Bot

平台提供了一批预置 Bot，覆盖常见需求，例如常见问题解答、对话策略设计、互动式讲故事等。这些预置 Bot 可以直接使用，也可以作为起点复制后修改。

对新手来说，预置 Bot 的价值在于它展示了「一个配置完整的 Bot 长什么样」——提示词怎么组织、插件怎么挂、变量怎么定义。与其从空白页开始，不如先打开一个职责相近的预置 Bot，看它的 Persona & Prompt 结构，再按自己的需求改写。这比凭空设计要快得多。

使用预置 Bot 时注意两点：一是预置 Bot 的提示词是按通用场景写的，直接拿来用往往过于宽泛，需要收窄到你的具体场景；二是预置 Bot 挂载的插件与工具未必都是你需要的，多余的应当移除。

注意事项

• 提示词是主要抓手。Bot 表现不符合预期时，第一反应应该是回到 Persona & Prompt 补规则，而不是换模型或加插件。绝大多数「答得不对」源于约束没写清。
• 工具要选到具体工具层。只挂插件不选工具，等于没挂。配置时确认到 searchNews 这一级的粒度。
• 提示词里要写清工具调用时机。挂了工具但没说明何时使用，模型可能始终不调用，也可能在不该调用时调用。
• 为失败路径写兜底。外部检索可能返回空结果，提示词里必须约定这种情况下的回应方式，否则 Bot 容易编造内容。
• 改动后需要重新发布。在编辑页面修改配置，不会自动同步到已投放的渠道。
• 渠道能力存在差异。不同发布渠道对插件、变量的支持程度不同，发布前确认目标渠道是否支持你已配置的能力。
• 变量宜少不宜多。只保留真正影响回答的字段，并在提示词中说明读取与更新时机。
• 价格、配额、可用模型与插件清单会变动。本文不涉及具体数值，实际使用前请以官网当前信息为准。