Přidání SharePoint jako zdroje znalostí

SharePoint jako zdroj znalostí funguje spárováním agenta s SharePoint adresou URL nebo SharePoint seznamy. Tento článek se zabývá úplnými funkcemi integrace SharePoint, které poskytuje výběr možnosti SharePoint v dialogovém okně Přidat znalostní bázi.

Note

• V dialogovém okně Přidat znalostní bázi jsou dvě možnosti SharePointu. Možnost SharePoint v části pro nahrání souboru slouží k nahrání jednotlivých SharePoint souborů nebo složek a umožňuje možnosti synchronizace souborů. Tento článek popisuje možnost SharePoint, která poskytuje plnou podporu SharePoint v Copilot Studiu.

• Seznam omezení a podporovaných funkcí SharePointu najdete v tématu Omezení webových aplikací SharePointu.

• Pokud chcete přidat jednotlivé sharepointové soubory nebo složky, přečtěte si článek Přidání sharepointových souborů a složek.

• Odpovědi agenta, které používají SharePoint jako zdroj znalostí, nejsou součástí přepisů .

• Pro agenty vycházející ze zdrojů znalostí SharePoint Turn on Work IQ poskytuje lepší kvalitu načítání znalostí a odezvy. Tato funkce využívá špičkové nástroje pro interní vyhledávání, které umožňují agentovi získat větší objem kontextu s větší přesností. Nicméně kvůli zvýšené složitosti systému mohou někteří uživatelé a dotazy zaznamenat mírné zvýšení latence.

Když publikujete agenta, volání pomocí generativních odpovědí se uskutečňují jménem uživatele, který chatuje s agentem, podle nastavení ověřování nakonfigurovaného v agentovi. Ve výchozím nastavení se agenti vytvořená v Copilot Studiu a v Microsoft Teams konfigurují s možností ověřování Authenticate s Microsoftem, která funguje v prostředích, jako jsou Microsoft Teams, Power Apps a Microsoft 365 Copilot.

Note

V chatech Microsoft Teams je možné používat generované odpovědi s daty SharePoint, aniž by bylo vyžadováno ruční ověřování. Pokud chcete použít tuto metodu pro dříve publikovaného agenta, překonfigurujte agenta tak, aby používal Authenticate s Microsoftem a pak ho znovu publikujte na Microsoft Teams. Může trvat několik hodin, než se změna projeví. Pokud je uživatel uprostřed konverzace a zdá se, že se změna neprojevila, může do chatu napsat "začít znovu" a vynutit tak restartování konverzace s nejnovější verzí agent. Tyto změny jsou teď dostupné pro osobní chaty Teams mezi uživatelem a agentem. Zatím nejsou k dispozici pro skupinové chaty ani zprávy kanálu.

Pokud chcete pro svého agenta použít ruční ověřování, přečtěte si část Pokročilé scénáře ověřování.

Přidání SharePoint webů jako zdroje znalostí

Když uživatel položí otázku a agent nemá téma, na které by mohl odpovědět, agent prohledá adresu URL a všechny dílčí cesty. Například adresa URL contoso.sharepoint.com/sites zahrnuje také dílčí cesty, například contoso.sharepoint.com/sites/policies. Generativní odpovědi shrnují tento obsah do zacílené odpovědi.

Pokud chcete přidat web SharePoint jako zdroj znalostí, proveďte následující kroky:

1. Otevřete softwarového agenta.

2. Vyberte Přidat znalosti ze stránek Přehled nebo Znalosti, nebo Vlastnostiuzlu generativních odpovědí.

3. V části Doporučené vyberte SharePoint.

   

4. Zadejte adresu URL SharePoint. Více adres URL oddělte ručním zalomením řádků (použijte klávesu Shift + Enter). Pokud chcete místo statické adresy URL použít proměnnou, vyberte ikonu pro výběr proměnné vedle pole URL a zvolte proměnnou vlastní, systém nebo prostředí.

5. Přidejte název a popis. Popis by měl být co nejpodrobnější, zejména pokud je povolena generativní AI, protože popis napomáhá generativní orchestraci.

6. Výběrem Přidat do agenta dokončete přidání zdroje znalostí.

Přidání SharePoint seznamů jako zdroje znalostí

Sharepointové seznamy představují oblíbený způsob, jak ukládat tabulková data a poskytovat rychlý a snadný přístup k informacím. Váš agent může tyto seznamy použít jako zdroj znalostí. Přidáním SharePoint seznamu jako zdroje znalostí vytvoříte připojení ke zdroji v reálném čase, takže nejaktuálnější data se používají pro dotazy a důvody. Uživatelé se ověřují pomocí svých přihlašovacích údajů SharePointu, což zajišťuje, že mají oprávnění k přístupu k datům, než váš agent poskytne odpověď.

1. Otevřete softwarového agenta.

2. Vyberte Přidat znalosti ze stránek Přehled nebo Znalosti, nebo Vlastnostiuzlu generativních odpovědí.

3. V části Nahrát soubor vyberte SharePoint.

   

4. Vyberte Procházet položky a najděte svůj požadovaný seznam, nebo zadejte adresu URL konkrétního seznamu SharePoint.

   

5. Když vyberete Procházet položky, dialogové okno se automaticky vyplní seznamem Moje seznamy a Poslední seznamy. My Lists zobrazí jenom seznamy vytvořené v aplikaci SharePoint Lists. Všechny ostatní seznamy se zobrazí v posledních seznamech. Pokud seznam, který potřebujete, nevidíte, otevřete SharePoint a přejděte k němu a seznam se zobrazí v posledních seznamech.

   

   Můžete vybrat až 15 seznamů najednou. Každý seznam se přidá do zdrojů znalostí agenta jako jednotlivé položky. Pokud chcete do agenta přidat další seznamy, použijte tyto kroky znovu a vyberte další seznamy.

   Note

   Pokud chcete použít seznam SharePoint se sdíleným přístupem, ale nezobrazuje se v seznamu Recent Lists, vložte adresu URL seznamu do výběru adresy URL.

6. Po výběru požadovaných seznamů vyberte Potvrdit výběr.

7. Přidejte název a popis. Popis by měl být co nejpodrobnější, zejména pokud je povolena generativní AI, protože popis napomáhá generativní orchestraci.

8. Výběrem Přidat do agenta dokončete přidání zdroje znalostí.

Pokročilé scénáře ověřování

Ve výchozím nastavení Copilot Studio předkonfiguruje agenty pro ověřování uživatelů pomocí ověřování Microsoftu pro přístup ke zdrojům SharePoint při připojování k agentovi prostřednictvím Microsoft Teams, Power Apps nebo Microsoft 365 Copilot. Pokud ale potřebujete ručně nakonfigurovat ověřování, pro generování odpovědí s SharePoint zdroji dat jsou potřeba následující kroky.

Important

Pokud je >Výsměrné SharePoint hledání povolené, je použití SharePoint blokováno.

• Generativní odpovědi ze zdrojů SharePoint nejsou dostupné guest uživatelům v aplikacích s podporou jednotného přihlašování.

• Chcete-li ověřit agenta, viz Ověření.

• Pokyny k vytvoření potřebné registrace Microsoft Entra ID aplikace najdete v tématu Konfigurování ověřování uživatelů pomocí Microsoft Entra ID. Při vytváření této registrace musíte vy nebo váš správce v registraci aplikace Microsoft Entra ID zadat rozsahy Sites.Read.All a Files.Read.All.

• Výběrem možnosti No authentication určuje, že váš agent nenačítá informace z SharePoint.

• Když konfigurujete ověřování, rozsahy řídí přístup uživatelů. Zadejte Sites.Read.All a Files.Read.All v poli oborů poblíž existujících hodnot profile a openid v Copilot Studiu. Tyto obory neudělují uživatelům zvýšená oprávnění při používání agenta, ale umožňují jejich povolený obsah z webu SharePoint nakonfigurovaný pro generování odpovědí.

• SharePoint podporuje nastavení Authenticate ručně s následujícími poskytovateli ověřovacích služeb:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 s federovanými přihlašovacími údaji
  • Microsoft Entra ID V2 s certifikátymi
  • Microsoft Entra ID V2 s tajnými klíči klienta

• SharePoint nepodporuje ruční ověřování pomocí obecného OAuth.

• Tato konfigurace ovlivní pouze generativní odpovědi a neovlivní konektory Power Platform.

Filtrování zdroje SharePoint

Tvůrci můžou zlepšit výkon zdroje znalostí SharePointu jejich agenta zadáním parametrů dotazu pro vyhledávání. Tyto parametry dotazu definují, co se v rámci zdroje znalostí hledá. Například můžete upřesnit, že chcete vyhledávání pouze pro položky, které byly upraveny za posledních šest měsíců. Tento typ filtru by byl vytvořen takto:

Attribute	Operator	Hodnota
Modified on	on or after	X date

Vytvoření podmínek filtru

Po přidání SharePoint zdroje znalostí můžete nastavit podmínky hledání.

1. Na stránce Znalostní báze vyberte zdroj SharePointu.

2. Vyberte tři tečky (... ) pro zdroj SharePoint a vyberte Edit.

3. Vyberte Rozšířená nastavení.

4. Sestavte filtry tak, aby zahrnovaly nebo vyloučily informace z vašeho SharePoint zdroje znalostí. Filtr můžete založit na jednom z následujících výběrů:

   • Nadpis
   • Author
   • Změnil/a
   • Datum úpravy

5. Hodnotu podmínky můžete nastavit na jednu z následujících hodnot:

   • Statická hodnota
   • Vstup proměnné, který uživatel poskytuje během konverzace s agentem, který se pak uloží jako vlastní globální proměnná
   • Systémová proměnná

6. Po dokončení konfigurace filtrů vyberte Uložit .

Další nastavení pro vylepšení hledání

Pokud chcete filtrovat zdroj SharePointu, měli byste vypnout následující nastavení:

• Vyhledávání na webu
• Na úrovni agenta použijte obecné nastavení znalostí v nastavení generující umělé inteligence agenta.
• Na úrovni tématu nastavení Umožnit umělé inteligenci používat vlastní obecné znalosti (Preview) v uzlu generativních odpovědí

Vypnutím těchto nastavení zajistíte, že agent odpoví bez odpovědi, pokud nemůže najít výsledek ve filtrovaném zdroji znalostí SharePointu.

Použití proměnných jako adres URL

Pomocí proměnných na veřejném webu nebo SharePoint adres URL zdrojů znalostí můžete dynamicky řídit rozsah obsahu, který váš agent používá.

Místo vytváření více zdrojů znalostí pro různé scénáře definujte jeden zdroj znalostí a vložte proměnnou do adresy URL. Při spuštění Copilot Studio přeloží proměnnou a použije výslednou adresu URL pro ukotvení.

Podpora proměnných

Když přidáte nebo upravíte veřejný web nebo SharePoint adresu URL zdroje znalostí, můžete do pole ADRESY URL vložit proměnnou.

Použijte proměnnou k:

• Připojte cestu k základní adrese URL

  https://www.contoso.com/{variable}

• Nahrazení celé adresy URL

  {variable}

Za běhu se proměnná přeloží na řetězcovou hodnotu. Zdroj znalostí je vymezen na rozřešenou adresu URL.

Note

Pomocí proměnné se změní adresa URL, která se používá k uzemnění. Nemění požadavky na strukturu adres URL ani omezení hloubky pro veřejné weby.

Vytvoření a nastavení proměnné

Jak použít proměnnou na veřejném webu nebo ve zdroji znalostí SharePointu:

1. Vytvořte řetězcovou proměnnou s globálním oborem.

2. Nastavte hodnotu proměnné pomocí jedné z následujících možností:

   • Vstupy témat
   • Vlastnosti profilu uživatele, například jazyk
   • Proměnné prostředí
   • Toky agentů nebo konektory

3. Vložte proměnnou do pole adresy URL tak, že vyberete {x} (vložit proměnnou).

4. Otestujte agenta, abyste ověřili, že proměnná odpovídá očekávané adrese URL.

Příklad: Rozsah podle produktu

Znalosti můžete vymezit na různé oblasti produktů na základě dotazu uživatele.

1. Použijte vstup tématu k zachycení názvu produktu jako proměnné s názvem Product.

2. Přidejte uzel Nastavit hodnotu proměnné za uzel Aktivační událost a vytvořte novou proměnnou s názvem ProductTable.

3. Pomocí vzorce Power Fx můžete definovat a mapovat názvy produktů na cesty URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Přidejte další uzel Nastavit hodnotu proměnné a použijte ho k vytvoření nové globální proměnné typu řetězec s názvem GlobalProductURL.

5. V nastavení hodnoty To vyberte Vzorec a pomocí funkce Power Fx proveďte vyhledávání v tabulce na základě hodnoty Product vstupní proměnné, Topic.Productnásledujícím způsobem:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Použijte proměnnou v adrese URL zdroje znalostí:

   https://www.microsoft.com/en-us/{GlobalProductURL}

Agent se dotazuje pouze na vymezenou část webu při běhu programu.

Obvyklé scénáře

Použití proměnných ve zdrojích znalostí veřejného webu pro:

• Směrování založené na produktech: Rozsah dotazů na konkrétní dokumentaci k produktu

• Filtrování oblastí nebo jazyků: Mapování User.Language na lokalizované adresy URL (například en-us, it-it).

• Adresy URL specifické pro prostředí: Přepínání mezi vývojovými, testovacími a produkčními weby

Considerations

• Zdroje znalostí veřejného webu používají vyhledávání Bingu a spoléhají na indexovaný obsah.
• Omezení hloubky adresy URL se stále použijí při použití proměnných.
• Proměnné mění pouze cílovou adresu URL. Neovlivňují, jak se obsah indexuje nebo načítá.

Important

Proměnná se musí přeložit na platnou veřejnou adresu URL, která splňuje požadavky pro zdroje znalostí veřejného webu. Neplatné nebo nepodporované adresy URL nemusí vracet výsledky.