Wiring Lab
在 Wiring Lab 里,你把一个人设接到一个引擎上。这条连接叫做 链接: :它把恰好一个人设和一个引擎配成一对,让引擎用这个人设的口吻说话。每条链接都有自己的 api_slug,也就是这套接线的唯一标识,好让平台永远知道某个请求属于哪一对人设与引擎。
要接一条链接:
- 打开 Wiring Lab ,选中你想让它上线的人设。
- 把引擎拖过来 ,从库里拖到画布上,挂到那个人设身上。
- 点 保存 (也就是 提交接线按钮)把链接固化下来。在你提交之前,接线是不会被保存的。
同一个账户里可以接多条人设—引擎链接。每一条都是独立的连接,各有自己的 api_slug。
API 密钥
API 密钥 是外部机器人或集成向 FluidTalk 表明身份的方式。有两种创建方法:
- 创建: 生成一个还没有绑定任何人设或引擎的 账户级 普通密钥。
- 签发(带绑定): 一步生成一个已经 绑定到指定人设和引擎 的密钥。这是 推荐 做法,因为绑定好的密钥可以直接承接真实流量。
密钥在 Wiring Lab 里管理:
- 绑定密钥: 把已有的账户级密钥绑到某个人设和引擎上(也可以顺便改名)。从未绑定过的密钥无法承接真实调用。
- 列出: 查看账户下的所有密钥。
- 吊销: 删除一个密钥,让它再也不能被使用。
注意
API 密钥的明文只在创建的那一刻显示 一次。请当场复制并妥善保存。一旦丢了就再也看不到了——吊销那把密钥,重新生成一个即可。
注意
密钥必须先 绑定到某个人设 (以及引擎)才能承接真实流量。未绑定的账户级密钥在真实调用中会被拒绝。请先签发一个已绑定的密钥,或者把已有的绑上去。
上线检查清单
当这四条全部成立,你就上线了:
- 人设已就绪: 身份和照片都配置好了。
- 引擎已连接: 引擎已接到该人设上,并在 Wiring Lab 里提交过。
- 一把已绑定的 API 密钥: 正好签发(或绑定)到那个人设和那个引擎上。
- 把机器人指向握手接口: 你的集成把每一条来信都发到线上握手端点,并在请求头里带上密钥: X-API-Key 。FluidTalk 会回给你下一条消息和该执行的动作。
具体的端点、请求字段和响应,见 开发者 API 参考。
提示
想试用不必真的上线。先在内置的 模拟器 里把整段对话跑一遍(同一个引擎,不需要密钥也没有真实流量),等它表现符合预期了再去接线。
注意
承接真实对话需要一个有效的 付费套餐。免费或已过期的账户会在握手阶段被拒,所以套餐一到期,你的机器人就会停止服务。见 账单与套餐。
相关指南
- 引擎构建器: 接线之前先把对话设计好。
- 在模拟器里测试: 不用密钥,把引擎从头到尾试一遍。
- 开发者 API 参考: 确切的握手调用与请求头。
- 账单与套餐: 付费套餐为线上服务解锁了什么。