Zum Hauptinhalt springen
connic

SharePoint und OneDrive

Von connic
Automatischer Sync

Mach Dateien aus SharePoint und OneDrive für Agenten durchsuchbar

SharePoint und OneDrive verbindenSprich mit Sales
Publisher
Von connic
Synchronisiert
Dokumente, Bilder, Dateiinformationen
Einrichtung
Retrieval → Sources
Dokumentation
Retrieval-Docs

So funktioniert die SharePoint und OneDrive Source

Teams legen Richtlinien, Verträge und Handbücher in SharePoint-Dokumentbibliotheken und OneDrive ab. Die Quelle SharePoint und OneDrive überträgt diese Dateien in das connic-Retrieval, damit Agenten aus dem Dokument antworten, das dein Team pflegt, statt aus einer veralteten Kopie.

Die Verbindung nutzt eine App-Registrierung in deinem Microsoft Entra ID Tenant. Nach der ersten Synchronisierung fragt jeder Lauf bei Microsoft Graph nur geänderte Dateien ab. Bibliotheken mit Zehntausenden Dateien bleiben so aktuell, ohne erneut vollständig gelesen zu werden. Eine große erste Synchronisierung läuft über mehrere Läufe weiter, bis alle Dateien indexiert sind, und in SharePoint oder OneDrive gelöschte Dateien verschwinden bei der nächsten Synchronisierung aus dem Retrieval.

Das wird synchronisiert

Dokumente
Word-, Excel-, PowerPoint-, OpenDocument-, PDF-, RTF-, HTML-, E-Mail- und Textdateien werden wie hochgeladene Dateien extrahiert und in Chunks aufgeteilt. Andere Dateitypen werden übersprungen und im Synchronisierungslauf gezählt.
Bilder
PNG-, JPEG-, GIF- und WebP-Dateien, wenn „Bilder einbeziehen“ aktiviert ist.
Dateiinformationen
Website, Bibliothek, Ordnerpfad, Autor und Änderungszeitpunkt bleiben in den Metadaten des Eintrags erhalten, und jeder Eintrag verlinkt auf die Datei.
SharePoint and OneDriveActiveFile storage
Configuration
Content scope
Include imagesNo
Sync behavior
Target namespacesources.sharepoint
Sync intervalDaily
When content is deleted at the sourceRemove it from the retrieval
Recent syncsSync now
  • Completed13 Oct, 09:00
    4 new · 11 updated · 1 removed
  • CompletedManual12 Oct, 21:00
    0 new · 2 updated · 0 removed
  • Completed12 Oct, 09:00
    0 new · 6 updated · 0 removed

SharePoint und OneDrive Source einrichten

Füge die Source unter Retrieval → Sources im Environment hinzu, in dem deine Agenten laufen. Jedes Environment hat eigene Sources.

  1. Registriere im Microsoft Entra Admin Center unter App-Registrierungen eine App und erstelle dafür einen geheimen Clientschlüssel.

  2. Füge unter API-Berechtigungen die Microsoft Graph Anwendungsberechtigung Sites.Selected hinzu, erteile die Administratorzustimmung und gib der App über den Endpunkt für Websiteberechtigungen in Microsoft Graph Lesezugriff auf jede zu synchronisierende Website. Für OneDrive oder alle Websites ohne einzelne Freigaben verwende stattdessen Files.Read.All.

  3. Gib die Verzeichnis-ID (Mandanten-ID), die Anwendungs-ID (Client-ID) und den Wert des geheimen Clientschlüssels ein.

  4. Gib die URLs der zu synchronisierenden SharePoint-Websites an, eine pro Zeile, und begrenze sie optional auf bestimmte Dokumentbibliotheken. Füge OneDrive-Nutzer mit ihrer Anmelde-E-Mail hinzu.

  5. Optional lassen sich ältere Dateien mit einem Datum unter „Geändert seit“ ausschließen.

Konfiguration im Detail

Alle Einstellungen zum Verbinden von SharePoint und OneDrive mit einem Projekt.

Verbindung

Verzeichnis-ID (Mandanten-ID)*
Die Mandanten-ID von Microsoft Entra ID oder eine verifizierte Domain des Mandanten.
Anwendungs-ID (Client-ID)*
Die ID der App-Registrierung, zu finden auf ihrer Übersichtsseite.
Geheimer Clientschlüssel*
Der Wert des geheimen Clientschlüssels der App-Registrierung. Die Synchronisierung liest nur Dateien, auf die die App zugreifen kann.

Inhaltsumfang

SharePoint-Websites
Website-URLs, eine pro Zeile. Alle Dokumentbibliotheken einer Website werden synchronisiert, sofern unten keine Bibliotheken angegeben sind.
Dokumentbibliotheken
Synchronisiere nur diese Bibliotheken der angegebenen Websites, durch Kommas getrennt. Lass das Feld leer, um alle zu synchronisieren.
OneDrive-Nutzer
Anmelde-E-Mails der Nutzer, deren OneDrive synchronisiert wird, eine pro Zeile.
Geändert seit
Synchronisiere nur Dateien, die an oder nach diesem Datum geändert wurden (JJJJ-MM-TT). Lass das Feld leer, um alle Dateien zu synchronisieren.
Bilder einbeziehen
Indexiere auch Bilddateien aus den Bibliotheken.

Synchronisierungsverhalten

Wo synchronisierte Inhalte abgelegt werden und wie häufig sie aktualisiert werden.

Ziel-Namespace
Der Retrieval-Namespace legt fest, unter welchem Namen die synchronisierten Einträge abgelegt werden. Verwende Punkte für Verschachtelungen, z. B. sources.sharepoint.
Synchronisierungsintervall
Wie häufig die Quelle auf Änderungen geprüft wird. Bei jedem Lauf werden nur geänderte Inhalte erneut verarbeitet.
Wenn Inhalte an der Quelle gelöscht werden
In SharePoint oder OneDrive gelöschte oder nicht mehr zu diesen Einstellungen passende Dateien können bei der nächsten Synchronisierung aus dem Retrieval entfernt oder in der zuletzt synchronisierten Version beibehalten werden.

Aus einem Agenten durchsuchen

Agenten durchsuchen synchronisierte Inhalte mit dem Tool retrieval_query. Ein kleines Tool, das den Namespace festlegt, beschränkt einen Agenten auf diese Source.

tools/knowledge.py
from connic.tools import retrieval_query


async def search_sharepoint(question: str) -> dict:
    return await retrieval_query(
        question, namespace="sources.sharepoint"
    )
agents/support-agent.yaml
version: "1.0"

name: support-agent
type: llm
model: connic/gemini-3.7-flash
system_prompt: |
  Answer only from what search_sharepoint returns.
tools:
  - knowledge.search_sharepoint

SharePoint und OneDrive Retrieval Source FAQ

Lesende Microsoft Graph Anwendungsberechtigungen mit Administratorzustimmung. Sites.Selected beschränkt die App auf die Websites, die du ihr freigibst, und Files.Read.All umfasst OneDrive und alle Websites des Mandanten. Die Synchronisierung liest nur und schreibt nie nach Microsoft 365 zurück.

Die erste Synchronisierung arbeitet eine große Bibliothek über mehrere Läufe ab, die automatisch starten, bis alle Dateien indexiert sind. Danach fragt jeder Lauf nur geänderte Dateien ab, sodass unveränderte Dateien weder erneut heruntergeladen noch erneut berechnet werden.

Word-, Excel-, PowerPoint-, OpenDocument-, PDF-, RTF-, HTML- und E-Mail-Dateien (EML und MSG), Textdateien wie Markdown, CSV und JSON sowie Bilder, wenn „Bilder einbeziehen“ aktiviert ist. Andere Dateitypen und Dateien über 100 MiB werden übersprungen, ihre Anzahl steht im Synchronisierungslauf.

Ja. Gib nur die Websites und Dokumentbibliotheken an, die Agenten brauchen, und schließe ältere Dateien mit einem Datum unter „Geändert seit“ aus. Jede synchronisierte Datei verbraucht Projektguthaben, ein engerer Umfang macht also auch die erste Synchronisierung kleiner.

Weitere Retrieval Sources

Zum Marketplace