ERP
Abacus
Daten aus dem Abacus ERP (Kunden, Lieferanten, Adressen, Dokumente) über die REST API im Nur-Lesen-Modus.
- Token oder Zugangsdaten
- Nur Lesen
- 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.
| Tool | Funktion | Typ |
|---|---|---|
list_entities | Verfügbare Entitäten in der REST API des Mandanten (aus dem $metadata-Dokument). | Lesen |
query_entity | Liest eine Entität mit OData-Filter, Feldern und Sortierung; gibt eine Tabelle zurück (Diagramme und Export). | Lesen |
Einrichtung Schritt für Schritt
Öffnen Sie in Kaiross Integrationen, wählen Sie Abacus und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- In Abacus (Programm 12): Erstellen Sie einen Service User für die REST API mit Nur-Lesen-Zugriff auf den Mandanten und die nötigen Entitäten.
- Generieren Sie Client ID und secret (Client-Credentials-Flow) und geben Sie Server-URL und Mandantennummer an.
- Wenn Abacus on-premise ist, machen Sie es über einen VPN-Tunnel erreichbar.
- Häufige Entitäten: Subjects, Addresses, Customers, Suppliers. Verwenden Sie list_entities für die vollständige Liste.
Felder des Formulars: URL des Abacus-Servers, Mandant, Client ID (Service User).
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Client secret.
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
- Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
- 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).
- Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
- 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.