Wiring Lab
Wiring Lab では、ペルソナとエンジンをつなぎます。このつながりを リンク: と呼びます。1つのペルソナと1つのエンジンをちょうど1対1で結びつけるので、エンジンはそのペルソナの声で動きます。各リンクには固有の api_slugが割り当てられます。これはその配線を一意に示す識別子で、リクエストがどのペルソナとエンジンの組み合わせに属するかをプラットフォームが常に判別できるようにします。
リンクを作るには:
- Wiring Lab を開き、稼働させたいペルソナを選びます。
- エンジンをドラッグ してライブラリからキャンバスに置き、そのペルソナに紐づけます。
- 保存 （ 配線を確定ボタン）を押すとリンクが保存されます。確定するまで配線は保存されません。
1つのアカウントで複数のペルソナ・エンジンのリンクを作れます。それぞれが独立した接続で、固有の api_slugを持ちます。
APIキー
APIキー は、外部のボットや連携がFluidTalkに対して認証するための仕組みです。作り方は2通りあります:
- 作成: まだどのペルソナにもエンジンにも紐づいていない、 アカウント全体で使える 素のキーを発行します。
- 発行（紐づけ込み）: 1ステップで、最初から 特定のペルソナとエンジンに限定された キーを発行します。こちらが 推奨 の方法です。限定済みのキーはそのまま本番トラフィックを処理できるからです。
キーの管理はWiring Labから行います:
- キーの紐づけ・限定: 既存のアカウント全体キーをペルソナとエンジンに結びつけます（必要なら名前も変更できます）。一度も限定していないキーは本番の呼び出しを処理できません。
- 一覧: アカウント上のすべてのキーを確認します。
- 失効: キーを削除して、それ以上使えないようにします。
ご注意
APIキーのシークレットが表示されるのは、作成した瞬間の 一度きりです。そのときにコピーして、安全な場所に保管してください。紛失した場合は二度と見られません。そのキーを失効させて、新しく作り直してください。
ご注意
本番トラフィックを処理する前に、キーは ペルソナに限定 （およびエンジンに限定）されている必要があります。限定されていないアカウント全体のキーは本番の呼び出しで拒否されます。まず限定済みのキーを発行するか、既存のキーを紐づけてください。
公開前チェックリスト
次の4つがすべて満たされていれば、本番稼働しています:
- ペルソナの準備完了: アイデンティティと写真が設定済み。
- エンジンをリンク済み: そのペルソナにエンジンを配線し、Wiring Labで確定済み。
- 限定されたAPIキー: そのペルソナとエンジンにぴったり紐づけて発行（または紐づけ）済み。
- ボットをハンドシェイクに向ける: 連携側が受信メッセージごとに本番のハンドシェイクエンドポイントへ送信し、キーを次のヘッダーで渡します: X-API-Key 。FluidTalkは次に送るメッセージと取るべきアクションを返します。
正確なエンドポイント、リクエストのフィールド、レスポンスについては 開発者向けAPIリファレンスをご覧ください。
ヒント
試すために本番公開する必要はありません。まずは組み込みの シミュレーター で会話を丸ごと動かしてください（同じエンジン、キー不要、実トラフィックなし）。狙いどおりの挙動になってから配線しましょう。
ご注意
本番での配信には有効な 有料プランが必要です。無料または期限切れのアカウントはハンドシェイクの時点で拒否されるため、プランが切れた瞬間にボットは配信を停止します。参照: 請求とプラン。
関連ガイド
- エンジンビルダー: 配線する前に会話を設計します。
- シミュレーターでのテスト: キーなしでエンジンを最初から最後まで試します。
- 開発者向けAPIリファレンス: ハンドシェイクの正確な呼び出しとヘッダー。
- 請求とプラン: 有料プランで本番配信のために何が解放されるか。