Docs

Wiring & going live

Once your persona and engine are ready, the Wiring Lab connects them and gives you a key your bot can use. This is the no-code path from a built engine to a live conversation.

Wiring Lab

Wiring Lab 里,你把一个人设接到一个引擎上。这条连接叫做 链接: :它把恰好一个人设和一个引擎配成一对,让引擎用这个人设的口吻说话。每条链接都有自己的 api_slug,也就是这套接线的唯一标识,好让平台永远知道某个请求属于哪一对人设与引擎。

要接一条链接:

  • 打开 Wiring Lab ,选中你想让它上线的人设。
  • 把引擎拖过来 ,从库里拖到画布上,挂到那个人设身上。
  • 保存 (也就是 提交接线按钮)把链接固化下来。在你提交之前,接线是不会被保存的。

同一个账户里可以接多条人设—引擎链接。每一条都是独立的连接,各有自己的 api_slug

API 密钥

API 密钥 是外部机器人或集成向 FluidTalk 表明身份的方式。有两种创建方法:

  • 创建: 生成一个还没有绑定任何人设或引擎的 账户级 普通密钥。
  • 签发(带绑定): 一步生成一个已经 绑定到指定人设和引擎 的密钥。这是 推荐 做法,因为绑定好的密钥可以直接承接真实流量。

密钥在 Wiring Lab 里管理:

  • 绑定密钥: 把已有的账户级密钥绑到某个人设和引擎上(也可以顺便改名)。从未绑定过的密钥无法承接真实调用。
  • 列出: 查看账户下的所有密钥。
  • 吊销: 删除一个密钥,让它再也不能被使用。

注意

API 密钥的明文只在创建的那一刻显示 一次。请当场复制并妥善保存。一旦丢了就再也看不到了——吊销那把密钥,重新生成一个即可。

注意

密钥必须先 绑定到某个人设 (以及引擎)才能承接真实流量。未绑定的账户级密钥在真实调用中会被拒绝。请先签发一个已绑定的密钥,或者把已有的绑上去。

上线检查清单

当这四条全部成立,你就上线了:

  1. 人设已就绪: 身份和照片都配置好了。
  2. 引擎已连接: 引擎已接到该人设上,并在 Wiring Lab 里提交过。
  3. 一把已绑定的 API 密钥: 正好签发(或绑定)到那个人设和那个引擎上。
  4. 把机器人指向握手接口: 你的集成把每一条来信都发到线上握手端点,并在请求头里带上密钥: X-API-Key 。FluidTalk 会回给你下一条消息和该执行的动作。

具体的端点、请求字段和响应,见 开发者 API 参考

提示

想试用不必真的上线。先在内置的 模拟器 里把整段对话跑一遍(同一个引擎,不需要密钥也没有真实流量),等它表现符合预期了再去接线。

注意

承接真实对话需要一个有效的 付费套餐。免费或已过期的账户会在握手阶段被拒,所以套餐一到期,你的机器人就会停止服务。见 账单与套餐

相关指南

Wiring & Going Live. FluidTalk Docs | FluidTalk