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.

Das Wiring Lab

Das Wiring Lab ist der Ort, wo du eine Persona mit einer Engine verbindest. Diese Verbindung heißt Link — sie koppelt genau eine Persona mit einer Engine, sodass die Engine in der Stimme dieser Persona läuft. Jeder Link erhält seine eigene api_slug, eine eindeutige Kennung für diese spezifische Verdrahtung, damit die Plattform immer weiß, zu welcher Persona-Engine-Kombination eine Anfrage gehört.

So verdrahtest du einen Link:

  • Öffne das Wiring Lab und wähle die Persona, die du online bringen möchtest.
  • Ziehe eine Engine aus der Bibliothek auf die Canvas, um sie mit dieser Persona zu verknüpfen.
  • Klicke auf Speichern (den Verdrahtung bestätigenButton), um den Link zu sichern. Bis du bestätigst, wird die Verdrahtung nicht gespeichert.

Du kannst mehrere Persona-Engine-Links in einem Konto verdrahten — jeder ist eine eigene Verbindung mit seiner eigenen api_slug.

API-Keys

Ein API-Key ist die Art, wie sich ein externer Bot oder eine Integration bei FluidTalk authentifiziert. Es gibt zwei Möglichkeiten, einen zu erstellen:

  • Erstellen — generiere einen einfachen, kontoweiten Key, der noch nicht mit einer Persona oder Engine verknüpft ist.
  • Provisionieren — generiere einen Key, der in einem Schritt auf eine bestimmte Persona und Engine zugeschnitten ist . Das ist der empfohlene Weg, weil ein bereits zugeschnittener Key sofort bereit ist, Live-Traffic zu bedienen.

Du verwaltest Keys im Wiring Lab:

  • Verknüpfen / Zuschneiden eines Keys — binde einen bestehenden kontoweiten Key an eine Persona und Engine (und benenne ihn optional um). Ein Key, der nie zugeschnitten wird, kann keine Live-Aufrufe bedienen.
  • Auflisten — sieh jeden Key im Konto.
  • Widerrufen — lösche einen Key, damit er nicht mehr verwendet werden kann.

Achtung

Das Secret eines API-Keys wird nur einmalangezeigt, im Moment seiner Erstellung. Kopiere es dann und bewahre es sicher auf — wenn du es verlierst, kannst du es nicht mehr einsehen. Widerrufe einfach diesen Key und erstelle einen neuen.

Achtung

Ein Key muss einer Persona zugeordnet sein (und einer Engine), bevor er Live-Traffic bedienen kann. Ein nicht zugeordneter, kontoweiter Key wird bei Live-Aufrufen abgelehnt — provisioniere zuerst einen zugeordneten Key oder verknüpfe einen bestehenden.

Go-Live-Checkliste

Wenn alle vier zutreffen, bist du live:

  1. Persona bereit — Identität und Fotos eingerichtet.
  2. Engine verknüpft — die Engine mit dieser Persona verdrahtet und im Wiring Lab bestätigt.
  3. Ein zugeordneter API-Key — provisioniert (oder verknüpft) für genau diese Persona und Engine.
  4. Richte deinen Bot auf den Handshake — deine Integration sendet jede eingehende Nachricht an den Live-Handshake-Endpunkt und übergibt den Key im X-API-Key Header. FluidTalk antwortet mit der nächsten Nachricht und der auszuführenden Aktion.

Für die genauen Endpunkte, Anfragefelder und Antworten, siehe die Developer-API-Referenz.

Tipp

Du musst nicht live gehen, um es auszuprobieren. Führe das gesamte Gespräch zunächst im integrierten Simulator durch — dieselbe Engine, kein Key und kein echter Traffic — und verdrahte es dann, sobald es sich so verhält, wie du es möchtest.

Achtung

Live-Serving erfordert einen aktiven bezahlten Plan. Ein kostenloses oder abgelaufenes Konto wird beim Handshake abgelehnt, sodass dein Bot ab dem Moment des Plan-Endes nicht mehr bedient wird. Siehe Abrechnung & Pläne.

Verwandte Anleitungen

Wiring & Going Live — FluidTalk Docs | FluidTalk