Datové zdroje SharePoint
Datový zdroj SharePoint synchronizuje dokumenty z týmových webů a knihoven dokumentů do kolekce Siesta AI. Uložené SharePoint connection zajišťuje autentizaci; datový zdroj určuje web, knihovnu, složky a plán aktualizací. Siesta AI vyhledá soubory a zpracuje podporovaný obsah, aby v něm mohli vyhledávat agenti s přístupem ke kolekci.
Pro soubory vlastněné Microsoft uživatelem použijte Datové zdroje OneDrive.
Příprava připojení
- Vytvořte nebo si zajistěte přístup k SharePoint connection.
- Ověřte, že připojený Microsoft účet může číst požadovaný web, knihovnu dokumentů a složku. Úspěšné přihlášení neuděluje přístup ke všem webům.
- Vyberte cílovou kolekci a její uživatele. Pro sdílené produkční znalosti použijte spravovaný účet a zaznamenejte vlastníka jeho autorizace.
Pokud máte privátní instanci Siesta AI, nastavte Microsoft Entra app registration daného nasazení, doplňte oprávnění Microsoft Graph pro SharePoint a udělte admin consent. Před vytvořením connection postupujte podle API oprávnění a admin consent v Developers → Private Deployment. Připojený účet musí mít také přístup k vybranému webu a knihovně.
U systémového připojení SharePoint před přidáním zdroje ověřte jeho vlastní Application ID a Tenant ID. Tato pole připojení dodávají identifikátory klienta a tenantu datového zdroje; chybějící hodnoty se nenahrazují obecným Microsoft OAuth providerem. Viz nastavení systémového připojení. Požadavky na účet, Graph consent a přístup k webu/knihovně platí nadále.
Nastavení zdroje
Otevřete požadovanou kolekci, přidejte datový zdroj a zvolte SharePoint.
| Pole | Co zadat |
|---|---|
| Name | Účel a web/knihovna, například HR SharePoint — Policies |
| Description | Vlastník, web, knihovna, rozsah složek a výjimky |
| Connection ID | Uložené SharePoint connection |
| Sync frequency | On Demand, Daily, Weekly nebo Monthly |
| Folder paths | Cesty určující web, knihovnu a případně složku; viz příklady níže |
Zachycený formulář SharePoint nabízí Retriever i Processing. Dostupné ovládací prvky se mohou lišit podle nasazené verze.
Zadávání složek
Upřednostněte úplné URL složky, které určuje tenant, web, knihovnu a složku:
https://example.sharepoint.com/sites/HR/Shared%20Documents/Policies
https://example.sharepoint.com/teams/Operations/Shared%20Documents/Runbooks
Příklad hostitele, webu, knihovny a složky nahraďte skutečnými hodnotami. Názvy knihoven se mohou lišit podle tenantu a jazyka. Cesta relativní pouze ke knihovně, například Shared Documents/Policies, nestačí, protože neobsahuje web.
Konektor zpracuje také server-relative cesty jako /sites/HR/Shared Documents/Policies a URL zobrazení knihovny obsahující Forms/AllItems.aspx?id=…. U URL zobrazení musí parametr id určovat požadovanou knihovnu nebo složku. Pokud potřebujete jednoznačně určit hostitele tenantu, použijte úplné URL a před rozšířením rozsahu ověřte nalezené soubory.
Nepoužívejte písmeno Windows disku, lokální cestu ani client secret. Upřednostněte trvalý přístup účtu k webu a knihovně před odkazem pro sdílení s omezenou platností.
Zpracování
Před uložením zkontrolujte profil zpracování a dostupné volby. Pokud je v nasazení k dispozici Discovery mode, použijte ho ke kontrole nalezených souborů, odhadů a schválení před indexací. Retrieval nastavení měňte až na základě testů reprezentativních otázek.
Store source files je volitelné a ve výchozím stavu vypnuté. Řídí uchování původních vzdálených binárních souborů; neurčuje, zda se podporovaný obsah parsuje a indexuje. Viz Ukládání zdrojových souborů.
Ověření první synchronizace
- Začněte jednou malou složkou v požadovaném webu a knihovně a zdroj uložte.
- Projděte Overview → Updates. Ve stavu Waiting for confirmation před schválením zkontrolujte nalezené složky, názvy souborů a odhady.
- V Files ověřte, že dokumenty pocházejí ze správného webu a knihovny. Zkontrolujte jejich stavy zpracování a ukázky extrahovaného obsahu.
- Položte testovací otázku agentovi s přístupem ke kolekci a porovnejte odpověď i zdroje s originálními SharePoint dokumenty.
- Změňte jeden testovací dokument a spusťte další aktualizaci nebo vyčkejte na nastavený plán. Ověřte, jak se změny projeví ve vašem nasazení.
Přístup ke kolekci musí odpovídat zamýšleným uživatelům. Úspěšný import přes připojený účet nepotvrzuje, že se Microsoft oprávnění vynucují zvlášť pro každého čtenáře kolekce.
Řešení potíží
| Příznak | Co zkontrolovat jako první |
|---|---|
The SharePoint system connection requires an application ID and tenant ID. | Požádejte správce systémového připojení SharePoint o doplnění obou ID z příslušné Entra app registration a zopakujte vytvoření zdroje. |
| Nebyly nalezeny žádné soubory | Hostitele tenantu, cestu /sites/ nebo /teams/, název knihovny, složku a přístup připojeného účtu |
| Microsoft vyžaduje schválení administrátorem | Oprávnění aplikace a consent v privátní instanci |
| Connection funguje, ale web je nedostupný | Oprávnění připojeného účtu k webu/knihovně a nastavená Graph oprávnění |
| Byly nalezeny nesprávné dokumenty | Úplné URL složky, parametr id v URL zobrazení a zvolené connection |
| Soubory byly nalezeny, ale nelze v nich vyhledávat | Schválení aktualizace, podporované typy, stavy souborů a limity zpracování |
Projděte Overview → Updates, detail souborů a Logs zdroje, pokud jsou k dispozici. Před změnou retrieval nastavení použijte Zpracování, synchronizace a řešení potíží. Zpracování cest i aktualizací ověřte na nasazené verzi před rozšířením na produkční knihovny.