Storage
Amazon S3
Durchsucht und liest Dateien aus einem S3-Bucket oder kompatiblen Dienst (MinIO, R2, Exoscale).
- Token oder Zugangsdaten
- Aktionen mit Bestätigung
- Auch über VPN-Tunnel
- Synchronisierbare Quelle
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_objects | Listet Ordner und Dateien des Buckets unter einem Präfix auf (jeweils einen Ordner). | Lesen |
read_object | Liest eine Datei aus dem Bucket und gibt den Text zurück (PDF, Word, Excel, CSV, Text). | Lesen |
upload_text | Lädt eine Textdatei (z. B. CSV, Markdown, JSON) in den Bucket hoch. Erfordert Bestätigung. | Mit Bestätigung |
Aktionen, die Daten ändern, sind standardmässig deaktiviert. Sie werden in der Verbindung mit der Option Datei-Upload 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 Amazon S3 und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- Erstellen Sie einen dedizierten IAM-Benutzer mit minimaler Policy:
s3:ListBucketauf dem Bucket unds3:GetObjectaufarn:aws:s3:::<bucket>/*(pluss3:PutObjectnur, wenn Sie Upload aktivieren). - Erstellen Sie einen Access Key für den Benutzer und fügen Sie ihn hier ein: Das Secret bleibt im Vault.
- Für MinIO/R2 geben Sie den Endpoint an und aktivieren Sie bei Bedarf Path-Style.
Felder des Formulars: Bucket, Region, Endpoint (kompatible Dienste), Access key ID, URL Path-Style, Auf Ordner beschränken (Präfix).
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Secret access key.
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.
- Auch als synchronisierte Quelle des Knowledge nutzbar: Agent → Tab Synchronisierung → Quelle hinzufügen. Siehe Synchronisierte Quellen.
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.