Einen Linked Service erstellen

Linked Services werden pro Assistent konfiguriert, zusammen mit seinen übrigen Einstellungen.

Bevor Sie beginnen

• Sie haben bereits einen Assistenten erstellt. Siehe [Den perfekten

Assistenten bauen](build-assistant.md), falls Sie noch keinen haben.

• Sie kennen den Endpoint, den Sie aufrufen möchten – seine URL, Methode und (falls nötig) den Header

und Wert für die Authentifizierung.

Schritte

1. Öffnen Sie Ihren Assistenten und gehen Sie zum Tab Linked services.
2. Wählen Sie Add linked service.
3. Füllen Sie im Dialog Folgendes aus:

• Service ID – ein eindeutiges, kurzes Kürzel, das Ihre Aktionen verwenden (z. B. orders_api).
• Method – GET, POST, PUT oder DELETE.
• URL – der vollständige Endpoint, beginnend mit https://.

1. (Optional) Legen Sie unter Authentication einen Header name (etwa Authorization)

und seinen Secret value fest. Siehe Anfragen authentifizieren.

1. (Optional) Fügen Sie unter Headers Anfrage-Header hinzu, deren Werte Platzhalter {{params.x}}

enthalten können. Siehe Dynamische Werte übergeben.

1. Wählen Sie Save service und dann Apply für die Konfiguration des Assistenten.

Das Ergebnis prüfen

Der Service erscheint in der Liste mit Methode, Endpoint und – falls Sie einen hinzugefügt haben – einem Badge Auth. Lösen Sie die Aktion aus, die ihn aufruft (oder das damit verbundene Formular), und prüfen Sie, ob die Antwort im Gespräch erscheint.

Fehlerbehebung

• Speichern ist deaktiviert – ein Pflichtfeld (Service ID oder URL) ist leer, oder die URL beginnt nicht

mit http:// oder https://.

• „Set an auth header name to attach the secret to.“ – Sie haben einen geheimen Wert eingegeben, aber

den Header-Namen leer gelassen. Ergänzen Sie den Header-Namen oder löschen Sie den geheimen Wert.

Verwandte Dokumentation

• Einen Linked Service aufrufen – eine Aktion damit verbinden.
• Anfragen authentifizieren – eine Anmeldeinformation hinzufügen, die serverseitig bleibt.