Zum Inhalt springen
Kaiross

Web

HTTP Request

Ruft REST API von erlaubten Domains auf (Lesen; Schreiben optional mit Bestätigung).

  • Token oder Zugangsdaten
  • Aktionen mit Bestätigung
  • Auch über VPN-Tunnel

Tools für den Agenten

Der Agent wählt selbst das passende Tool für die Frage. Im Tab MCP und Datenbanken des Agenten können Sie nicht benötigte Tools deaktivieren.

ToolFunktionTyp
http_get GET-Anfrage an eine URL der erlaubten Domains. Gibt Status und Body zurück (JSON oder Text). Lesen
http_request Schreibanfrage (POST, PUT, PATCH, DELETE) an eine erlaubte Domain. Erfordert Bestätigung. Mit Bestätigung

Aktionen, die Daten ändern, sind standardmässig deaktiviert. Sie werden in der Verbindung mit der Option POST/PUT/PATCH/DELETE erlauben (mit Bestätigung) aktiviert; danach zeigt jede Aktion im Chat eine Zusammenfassung und wird erst mit Bestätigen und ausführen ausgeführt.

Einrichtung Schritt für Schritt

Öffnen Sie in Kaiross Integrationen, wählen Sie HTTP Request und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.

  1. Listen Sie nur die Domains der zu erreichenden API auf: alles andere ist blockiert (auch private IPs und Cloud-Metadaten, ausser über VPN-Tunnel).
  2. Wenn die API ein Token erfordert, geben Sie den Namen des Headers und den Wert an: Der Wert bleibt im Vault.
  3. Schreibaufrufe sind standardmässig deaktiviert; wenn Sie sie aktivieren, verlangt jeder Aufruf eine Bestätigung im Chat.

Felder des Formulars: Erlaubte Domains, Basis-URL (optional), Authentifizierungs-Header.

Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Header-Wert.

Gut zu wissen

  • Liegt der Dienst im Netzwerk Ihres Unternehmens, erstellen Sie zuerst einen Tunnel unter Einstellungen → Netzwerk / VPN und wählen Sie in der Verbindung bei Erreichbar über den Tunnel. Siehe Datenbanken und ERP.

Mit einem Agenten verbinden

  1. Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
  2. Wählen Sie unter Hinzufügen die Option Bestehende Integration verbinden und die Verbindung, oder Aus dem Katalog für eine neue (die Schaltfläche heisst dann Speichern und verknüpfen).
  3. Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
  4. Klicken Sie auf Im Chat testen und stellen Sie eine Frage, die Daten aus dem Dienst braucht.

Häufige Fehler

Ungültige Zugangsdaten
Prüfen Sie Token, Passwort oder API-Schlüssel: Oft fehlt ein Zeichen oder das Token ist abgelaufen. Erstellen Sie ein neues und aktualisieren Sie die Verbindung.
Unzureichende Berechtigungen
Dem Konto oder Token fehlen Berechtigungen: Vergleichen Sie sie mit der Konfiguration oben (Leitfaden und empfohlene Berechtigungen in der App) und erstellen Sie bei Bedarf ein neues Token.
Dienst nicht erreichbar
Prüfen Sie Adresse, Port und Firewall. Ein Server im Firmennetz braucht einen VPN-Tunnel; ohne Tunnel sind nur öffentliche Adressen erlaubt.
Zu viele Anfragen
Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.

Weitere Integrationen der Kategorie Web

Alle Integrationen