扣子AI网页版目前分为国内版和海外版两个完全独立的入口。国内版地址为 https://www.coze.cn ，海外版地址为 https://www.coze.com 。两个版本的账号体系、模型资源、插件生态和发布渠道都不互通，使用手机号登录国内版时，系统并不会识别你在海外版注册的账号。国内用户通常建议优先使用 coze.cn，因为它的访问速度更稳定，支持抖音、飞书扫码授权，同时与豆包、微信公众号、飞书机器人等国内发布渠道连接更顺畅。如果你之前用邮箱注册过海外版，回到国内版登录就会发现账号不存在的提示，这是高频问题之一。
一、扣子AI网页版登录入口与账号选择
打开扣子AI网页版后，登录流程并不复杂，但入口选择会直接影响后续功能。国内版支持手机号加验证码登录，也支持抖音、飞书扫码授权登录。手机号验证码登录时，如果收不到验证码，需要先检查是否被手机安全软件拦截，再确认是否在短时间内频繁请求导致触发风控。连续多次获取验证码失败后，建议等待五分钟再尝试，不要反复点击发送。
登录成功后会进入个人空间，右上角头像区域可以切换个人空间和团队空间。团队空间适合多人协作开发同一个 Bot，但需要先由企业管理员创建团队并邀请成员加入。个人创建的 Bot 默认只对自己可见，切换到团队空间后，新建的 Bot 才会归属团队。这里有一个容易踩坑的地方：你以为 Bot 丢失了，其实只是当前空间切换到了另一个账号或团队。
登录态通常会在浏览器中保留较长时间，但如果清除了站点数据、使用了无痕窗口，或者浏览器开启了退出时自动清理 Cookie，就需要重新验证。网页版与客户端共用账号，但部分客户端保存的登录状态不会同步到网页版，反之亦然。遇到网页版频繁掉登录，可以先关闭广告拦截插件和隐私模式再试。
二、在线使用第一步：创建 Bot 与编排对话逻辑
进入扣子AI网页版的工作台后，点击创建 Bot 即可开始编排。扣子的 Bot 编排界面核心区域包括人设与回复逻辑、插件、工作流、触发器、知识库、变量和数据库。人设与回复逻辑决定了 Bot 的基础行为，你需要用自然语言描述 Bot 的身份、任务边界、回复风格和限制条件。提示词写得越清楚，模型越不容易跑偏。
下面是一段面向电商客服场景的基础人设提示词，可以直接在网页版的人设输入框中参考修改：
你是一个面向电商售后场景的智能客服助手，名称是小扣。你的主要任务是根据知识库中的退换货政策回答用户问题。回复时优先使用中文，语气简洁、礼貌，不使用夸张表达。如果用户询问物流信息，可以调用快递查询插件；如果用户要求转人工，直接回复转人工引导语。遇到政策不明确的问题，不要编造答案，应该明确告诉用户需要人工确认。
在人设配置下方，需要选择模型。扣子国内版会根据账号权限提供不同模型，包括豆包系列以及部分合作模型。模型的选择会影响回复质量和响应速度，一般场景使用默认推荐模型即可。如果是需要复杂推理的逻辑任务，可以选择更高规格的模型，但要注意调用成本和延迟。人设提示词和模型选择可以随时修改，修改后需要用右侧的调试窗口进行多轮测试，确认 Bot 没有出现忘记人设、重复询问或擅自承诺退款等问题。
三、插件、工作流与知识库配置要点
插件是扩展 Bot 能力的重要手段。扣子AI网页版内置了插件商店，你可以搜索新闻、天气、图片生成、表格处理、快递查询等插件。点击添加后，插件会出现在当前 Bot 的插件列表中。使用插件时要注意查看插件的输入参数和输出字段，很多插件需要先配置 API Key 或授权信息，否则调用时会返回鉴权失败。建议先单独调试插件，确认返回数据符合预期后再与 Bot 回复逻辑联调。
工作流适合处理多步骤任务，例如用户上传一张图片后，先经过图像识别节点，再根据识别结果调用大模型节点生成文案，最后通过 API 请求节点写入外部系统。工作流节点类型包括开始节点、大模型节点、代码节点、条件分支、API 请求和结束节点。代码节点允许你写一段 JavaScript 或 Python 来处理变量，下面是一个简单的 JavaScript 代码节点示例，用来检查订单号是否为空：
let orderId = args.order_id;
let result = {};
if (!orderId) {
result.status = '缺少订单号';
} else {
result.status = '已接收订单号 ' + orderId;
}
return result;
知识库配置同样关键。你可以上传 PDF、Word、Excel、飞书文档或直接粘贴网页链接，扣子会自动进行分段和向量化处理。知识库不是上传后立刻就能精准回答，需要检查分段效果，并为重要内容设置问答对。很多 Bot 回答不够准确，问题并不在模型，而是知识库切片过粗或原始文档中包含大量表格、图片，导致召回信息不完整。建议将核心政策拆成短句，避免一个分段里混杂多个主题。
四、发布与 API 接入：从网页版到生产环境
Bot 调试完成后，可以在扣子AI网页版的发布页面选择发布渠道。国内版支持发布到豆包、飞书、微信公众号、Web 浮窗和自定义 API。发布到微信公众号时，需要先完成公众号授权，并确保公众号已完成认证。发布到飞书机器人时，需要创建飞书应用并填写 App ID 和 App Secret。每个渠道的审核和配置要求不同，发布前最好先阅读平台上的发布说明。
如果你需要把 Bot 接入自己的网站或应用，可以使用扣子提供的 API。首先在发布页面开启 API 渠道，然后创建访问令牌。调用时使用 https://api.coze.cn/v3/chat 作为请求地址，并通过 Authorization 请求头传递 Bearer Token。下面是一个不依赖浏览器的 JavaScript 调用示例：
const botId = '你的bot_id';
const token = '你的API访问令牌';
function askCoze(question) {
return fetch('https://api.coze.cn/v3/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + token,
'Content-Type': 'application/json'
},
body: JSON.stringify({
bot_id: botId,
user_id: 'web_user_001',
stream: false,
additional_messages: [
{
role: 'user',
content: question,
content_type: 'text'
}
]
})
})
.then(function(response) { return response.json(); })
.then(function(data) { return data; });
}
askCoze('你好').then(function(res) { console.log(res); });
API 接入时，user_id 用于区分不同终端用户，建议每个真实用户使用固定且唯一的标识。如果开启流式返回，需要将 stream 字段设为 true，并使用流式读取方式处理响应。API 调用会产生模型和插件费用，开发阶段可以通过设置每日调用上限避免超额。Web 浮窗嵌入代码可以在发布页面直接获取，将生成的嵌入代码放入网页容器即可完成前端集成。
五、常见登录与使用问题排查
第一个高频问题是指向错误版本。手机号登录提示账号不存在时，先确认浏览器地址栏是 www.coze.cn 而不是 www.coze.com。第二个问题是登录后 Bot 列表为空，这通常是因为当前处于团队空间，而该团队下还没有创建 Bot，或者账号加入了多个团队需要切换查看。第三个问题是验证码频繁失效，验证码一般只有五分钟有效期，且每次发送后旧验证码会失效，以最新一条短信为准。
第四个问题涉及发布失败。例如发布到微信公众号时提示权限不足，需要检查公众号是否已授权给扣子，以及管理员是否完成了扫码确认。发布到飞书时，如果机器人无法回复消息，可能是飞书应用的机器人能力没有开启，或者事件订阅地址没有配置正确。第五个问题是网页版加载异常，可以尝试清除浏览器缓存、更换网络环境，或者使用 Chrome 或 Edge 的最新版本访问。扣子AI网页版会不断迭代，登录入口和功能位置可能发生调整，但账号与发布的基本逻辑相对稳定，遇到入口找不到时可以先回到工作台首页，再按左侧导航逐项定位。