Voraussetzungen
Was du brauchst, bevor du dein Produkt mit Tuix AI Agents verbindest.
Bevor du aus deinem Code mit deinem Agenten sprichst, brauchst du:
- Ein Tuix-Konto für den Zugriff auf das Dashboard.
- Eine Anwendung und ihre Application ID. Siehe Erstelle eine Anwendung.
- Eine Möglichkeit zur Authentifizierung: entweder die eigenen Anmeldedaten des Nutzers oder einen API-Schlüssel aus dem Tuix-Dashboard. Siehe API-Schlüssel.
- Die API-Basis-URL (siehe unten).
Basis-URL
Alle Anfragen an die Chat- und Session-Endpunkte deines Agenten gehen an:
Authentifizierung
Jeder Aufruf der Session- und Chat-Endpunkte deiner Anwendung wird mit einem der folgenden Header authentifiziert:
| Header | Verwende ihn, wenn ... |
|---|---|
Authorization | Du deine Nutzer bereits einloggst und möchtest, dass der Agent mit den Anmeldedaten dieses Nutzers handelt. |
X-Api-Key | Es keinen eingeloggten Nutzer gibt, für den gesprochen wird (ein öffentlicher Chat, eine Backend-Automatisierung), sodass sich der Agent stattdessen mit einem von dir erstellten Schlüssel authentifiziert. |
Beide werden im Detail in
Anwendungs-Endpunkte beschrieben,
zusammen mit dem Header x-session-secret, den jede Chat-Anfrage ebenfalls
benötigt.
Ein API-Schlüssel gibt vollen Zugriff auf die Anwendung, zu der er gehört. Bewahre ihn auf dem Server auf; ein öffentlicher Chat, der einen benötigt, braucht ein Backend zwischen Browser und Tuix AI Agents. Siehe API-Schlüssel.