Zum Inhalt springen
Kaiross

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.

ToolFunktionTyp
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.

  1. entra.microsoft.com → App registrations → New registration: Konten nur in diesem Verzeichnis (Single-Tenant).
  2. Redirect URI vom Typ Web: Fügen Sie den unten angezeigten Redirect URI ein.
  3. 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.
  4. Certificates & secrets → New client secret (mit Ablaufdatum): Kopieren Sie den Value.
  5. 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)

  1. Kopieren Sie im Formular der Verbindung den Wert Rücksprungadresse (Redirect URI), die in der OAuth-App registriert werden muss (Symbol Rücksprungadresse kopieren).
  2. Registrieren Sie die OAuth-App beim Anbieter (Schritte oben) und fügen Sie diese Redirect URI ein.
  3. 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.
  4. 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.Read
  • Files.Read.All
  • Sites.Read.All
  • Files.ReadWrite
  • User.ReadBasic.All
  • GroupMember.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

  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

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.

Weitere Integrationen der Kategorie Dokumente

Alle Integrationen