Was sind Linked Services
Ein Linked Service ist ein benannter Verweis auf einen Ihrer HTTP-Endpoints. Jeder Eintrag hat:
- eine Service ID – das kurze Kürzel, über das Aktionen ihn aufrufen (zum Beispiel
orders_api); - eine Method –
GET,POST,PUToderDELETE; - eine URL – den Endpoint, an den die Anfrage gesendet wird;
- optional einen Authentifizierungs-Header und seinen geheimen Wert.
Wenn eine Aktion einen Linked Service aufruft, stellt das Backend von Seekdown die Anfrage im Namen des Assistenten, hängt den Authentifizierungs-Header an, falls Sie einen konfiguriert haben, und gibt die Antwort an das Gespräch zurück. Da der Assistent den Service immer nur über seine ID referenziert, bleiben die echte URL und jede Anmeldeinformation auf dem Server – sie sind nie Teil der öffentlichen Assistenten-Konfiguration, die das Widget herunterlädt.
Wann sich ein Linked Service lohnt
- Live-Daten abrufen, die der Datensatz nicht enthalten kann – einen Bestellstatus, einen Lagerbestand oder einen Kontostand –
als Antwort auf die Frage eines Nutzers.
- Eine Anfrage an Ihre Systeme senden – ein Ticket erstellen, Interesse registrieren, einen
Workflow auslösen – aus einem Formular, das der Assistent anzeigt.
- Einen API-Schlüssel von der Seite fernhalten – Sie möchten einen authentifizierten Endpoint aufrufen, ohne
den Schlüssel im Frontend-Code preiszugeben.
Verwandte Dokumentation
- Erweiterte Anpassung – wo Aktionen und der
Helper executeProxyRequest zu finden sind.
- Formulare im Assistenten – Eingaben sammeln, die der Assistent an einen Linked Service senden kann.