Dokumente
SharePoint / OneDrive
Sucht und liest Dokumente von SharePoint und OneDrive (PDF, Word, Excel, Text); erstellt Textdateien im eigenen OneDrive mit Bestätigung.
- Zugang mit Verbinden (OAuth)
- Aktionen mit Bestätigung
- Synchronisierbare Quelle
- Beachtet Dateiberechtigungen
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 |
|---|---|---|
search_files | Sucht Dokumente nach Inhalt oder Name in SharePoint und OneDrive (Microsoft Search). | Lesen |
list_sites | SharePoint-Sites (mit Namenssuche) und ihre Dokumentbibliotheken. | Lesen |
list_folder | Inhalt eines Ordners (driveId + itemId; ohne = Stammverzeichnis meines OneDrive). | Lesen |
read_file | Text eines über die Suche oder die Ordnerliste gefundenen Dokuments (bis 15 MB). | Lesen |
upload_text | Erstellt eine Textdatei (CSV, Markdown, …) im eigenen OneDrive. Erfordert Bestätigung. | Mit Bestätigung |
Aktionen, die Daten ändern, sind standardmässig deaktiviert. Sie werden in der Verbindung mit der Option Upload nach OneDrive 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 SharePoint / OneDrive und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- entra.microsoft.com → App registrations → New registration: Konten nur in diesem Verzeichnis (Single-Tenant).
- Redirect URI vom Typ Web: Fügen Sie den unten angezeigten Redirect URI ein.
- API permissions → Microsoft Graph → Delegated:
User.Read,Files.Read.All,Sites.Read.All(Admin consent),Files.ReadWrite,User.ReadBasic.All,GroupMember.Read.All(Admin consent); danach falls erforderlich Grant admin consent. - Certificates & secrets → New client secret (mit Ablaufdatum): Kopieren Sie den Value.
- Geben Sie Tenant, Application (client) ID und Secret ein, speichern Sie und klicken Sie auf Verbinden mit dem zu verwendenden Konto.
Felder des Formulars: Directory (tenant) ID oder Domain, Application (client) ID.
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Client secret.
Dateiberechtigungen (synchronisierte Quellen): Mit Berechtigungen der Quelle respektieren ist jedes Dokument im Chat nur für Personen sichtbar, die es in SharePoint/OneDrive öffnen können: Nutzer, Microsoft 365-/Sicherheitsgruppen (aufgelöst mit GroupMember.Read.All), «Jeder»-Links und Links für «Personen in Ihrer Organisation» (verifizierte Domains des Tenants). User.ReadBasic.All wird benötigt, um die E-Mail-Adresse der Nutzer zu lesen. SharePoint-Websitegruppen (Besitzer/Mitglieder/Besucher) können über Graph nicht aufgelöst werden und bleiben nicht aufgelöst: Teilen Sie die Bibliotheken mit Microsoft 365-Gruppen oder Nutzern.
Zugang mit «Verbinden» (OAuth)
- Kopieren Sie im Formular der Verbindung den Wert Rücksprungadresse (Redirect URI), die in der OAuth-App registriert werden muss (Symbol Rücksprungadresse kopieren).
- Registrieren Sie die OAuth-App beim Anbieter (Schritte oben) und fügen Sie diese Redirect URI ein.
- Geben Sie in Kaiross Client ID und Client secret ein und klicken Sie auf Speichern und verbinden: Das Fenster des Anbieters öffnet sich, melden Sie sich mit dem gewünschten Konto an und erteilen Sie die Berechtigung.
- Meldet der Test später «Zugang abgelaufen», klicken Sie in der Verbindung auf Neu verbinden.
Erforderliche Berechtigungen (Scopes)
Kaiross verlangt beim Anbieter nur diese Berechtigungen; Schreibaktionen bleiben deaktiviert, bis Sie sie einschalten.
User.ReadFiles.Read.AllSites.Read.AllFiles.ReadWriteUser.ReadBasic.AllGroupMember.Read.All
Gut zu wissen
- Auch als synchronisierte Quelle des Knowledge nutzbar: Agent → Tab Synchronisierung → Quelle hinzufügen. Siehe Synchronisierte Quellen.
- Mit Berechtigungen der Quelle beachten (standardmässig aktiv) ist jedes synchronisierte Dokument im Chat nur für Personen sichtbar, die es im Dienst öffnen können.
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
- Konto nicht verbunden oder Zugang abgelaufen
- Die OAuth-Verbindung wurde nie abgeschlossen oder ist nicht mehr gültig: Klicken Sie in der Verbindung auf Verbinden oder Neu verbinden.
- Unzureichende Berechtigungen
- Dem Konto fehlen Scopes: Vergleichen Sie sie mit der Liste oben. Prüfen Sie bei Microsoft 365 auch die Administratorzustimmung.
- Zu viele Anfragen
- Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.
Nützliche Links
In den Schritten genannte Konsolen des Anbieters: