Přidat SharePoint jako zdroj znalostí

SharePoint můžete využít jako zdroj znalostí tak, že svému agentovi přiřadíte URL adresu SharePointu nebo seznamy SharePointu. Tento článek popisuje všechny funkce integrace se SharePointem, které jsou k dispozici po výběru možnosti SharePoint v dialogovém okně Přidat znalost.

Poznámka:

• V dialogovém okně Přidat znalosti se objeví dvě možnosti SharePoint. Možnost SharePoint v oddílu pro nahrání souboru slouží k nahrání jednotlivých souborů nebo složek SharePoint a umožňuje synchronizaci souborů. Tento článek popisuje možnost SharePoint, která poskytuje plnou podporu SharePoint v nástroji Copilot Studio.

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

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

Při použití SharePointu jako zdroje vědomostí přepisy konverzací neobsahují obsah zdrojových dokumentů použitých k generování odpovědi (pole search_results). Otázky a odpovědi jsou stále zahrnuty.

• Pro agenty podložené zdroji znalostí SharePoint nabízí možnost Zapnout Work IQ lepší vyhledávání znalostí a vyšší kvalitu odpovědí. Tato funkce používá nejmodernější interní nástroje pro načítání, které agentům umožňují získat větší objem kontextu s větší přesností. Kvůli zvýšené složitosti systému ale mohou někteří uživatelé a dotazy zaznamenat malý nárůst latence.

Když publikujete svého agenta, požadavky využívající generativní odpovědi jsou prováděny jménem uživatele, který s agentem komunikuje. Agent používá nastavení ověřování, která nakonfigurujete. Ve výchozím nastavení jsou agenti vytvoření v Copilot Studio a v Microsoft Teams nakonfigurováni s volbou ověřování Ověřit pomocí Microsoftu. Tato možnost funguje v prostředích jako Microsoft Teams, Power Apps a Microsoft 365 Copilot.

Poznámka:

Je možné používat generativní odpovědi s daty SharePoint v chatech Microsoft Teams a nepotřebovat ruční ověřování. Pokud chcete tuto metodu použít pro dříve publikovaného agenta, překonfigurujte agenta tak, aby používal Ověřování pomocí Microsoft, a pak ho znovu publikujte do 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í webů SharePoint 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.

Chcete-li přidat web SharePoint jako zdroj znalostí, dokončete následující kroky:

1. Otevřete agenta.

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

3. V části Vybrané 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). Chcete-li použít proměnnou místo statické URL, klikněte na ikonu výběru proměnné vedle pole URL a vyberte vlastní, systémovou proměnnou nebo proměnnou prostředí.

5. Přidejte jméno a popis. Zadejte podrobný popis, zejména pokud je povolena generativní AI, protože popis napomáhá generativní orchestraci.

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

Aktualizujte zdrojový odkaz, pokud je stránka nebo složka SharePointu přejmenována.

Pokud přejmenujete stránku SharePointu nebo složku, kterou používá zdroj vědomostí, původní odkaz na zdroj může přestat fungovat a způsobit problém s oprávněními. Když k tomu dojde, agent může selhat v přístupu ke znalostní bázi.

Pro obnovení přístupu:

1. Požádejte svého správce SharePointu, aby přiřadil potřebná oprávnění pro přejmenovanou lokalitu a vygeneroval nový zdrojový odkaz.

2. Otevřete agenta a aktualizujte zdroj vědomostí SharePoint pomocí nově vytvořeného odkazu.

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

Seznamy SharePoint 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 seznamu SharePoint 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ů SharePoint, což zajišťuje, že mají oprávnění k přístupu k datům, než váš agent poskytne odpověď.

1. Otevřete agenta.

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

3. V sekci Doporučené nebo v sekci Nahrát soubor vyberte SharePoint.

   

4. Vyberte Procházet položky a vyhledejte 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. Možnost Moje seznamy zobrazuje jenom seznamy vytvořené v seznamech SharePoint. 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ž 10 seznamů najednou. Pro nejlepší výsledky používejte nejvýše 10 seznamů u jednoho agenta. Seznamy obsahující více než 35 000 řádků mohou negativně ovlivnit kvalitu a latenci.

   Každý seznam se přidá do zdrojů znalostí agenta jako jednotlivé položky. Pokud chcete do agenta přidat další seznamy, použijte tento postup znovu a vyberte další seznamy.

   Poznámka:

   Pokud chcete použít seznam SharePoint, ke kterému máte sdílený přístup, ale nezobrazuje se v posledních seznamech, 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 jméno a popis. Zadejte podrobný popis, zejména pokud je povolena generativní AI, protože popis napomáhá generativní orchestraci.

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

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

Ve výchozím nastavení Copilot Studio předkonfiguruje agenty na ověřování uživatelů pomocí ověřování Microsoft při přístupu ke zdrojům SharePoint, když se připojují ke agentovi přes Microsoft Teams, Power Apps nebo Microsoft 365 Copilot. Pokud však potřebujete konfigurovat ověřování ručně, je nutné provést následující kroky, aby generativní odpovědi fungovaly se zdroji dat SharePoint.

Důležité

Pokud je povoleno Omezené vyhledávání SharePoint, použití SharePoint je zablokováno.

• Generování odpovědí ze zdrojů SharePoint není dostupné uživatelům typu host 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 aplikace Microsoft Entra ID naleznete v části Konfigurace ověřování uživatele pomocí Microsoft Entra ID. Při vytváření této registrace musíte vy nebo správce zadat rozsahy Sites.Read.All a Files.Read.All v registraci aplikace Microsoft Entra ID.

• Výběr možnosti Bez ověřování určuje, že váš agent nenačítá informace z SharePoint.

• Když konfigurujete ověřování, obory řídí přístup uživatelů. Zadejte Sites.Read.All a Files.Read.All do pole rozsahů poblíž existujících hodnot profile a openid v aplikaci Copilot Studio. Tyto rozsahy nezvyšují oprávnění uživatelů při používání agenta, ale umožňují přístup k povolenému obsahu z webu SharePoint, jak je nastaveno pro generativní odpovědi.

• SharePoint podporuje nastavení Ručně ověřit s následujícími poskytovateli služeb ověřování:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 s federovanými přihlašovacími údaji
  • Microsoft Entra ID V2 s certifikáty
  • 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

Chcete-li zlepšit výkon zdroje znalostí SharePoint vašeho agenta, zadejte parametry vyhledávacího dotazu. Tyto parametry dotazu definují, co je prohledáno ve zdroji znalostí. Můžete například zadat, že chcete hledat jenom položky, které byly změněny za posledních 6 měsíců. Tento typ filtru sestavte následujícím způsobem:

Atribut	Operátor	Value
Modified on	on or after	X date

Vytvoření podmínek filtru

Po přidání zdroje znalostí SharePoint nastavte podmínky hledání.

1. Na stránce Znalost vyberte zdroj SharePoint.

2. Klikněte na tři tečky (…) u zdroje SharePoint a vyberte Upravit.

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

4. Vytvořte filtry pro zahrnutí nebo vyloučení informací ze zdroje znalostí SharePoint. Filtr založte na jednom z následujících výběrů:

   • Název
   • Autor
   • Změnil(a)
   • Datum úpravy

5. Hodnotu podmínky nastavte 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 SharePoint, vypněte následující nastavení:

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

Když tato nastavení vypnete, agent odpoví „žádná odpověď“, pokud nemůže najít výsledek ve filtrovaném zdroji znalostí SharePoint.

Použití proměnných jako URL

Používejte proměnné v URL veřejného webu nebo zdroje znalostí SharePoint k dynamickému řízení rozsahu obsahu, který váš agent používá.

Místo vytváření více zdrojů vědomostí pro různé scénáře definujte jeden zdroj vědomostí a vložte proměnnou do URL. Za běhu Copilot Studio proměnnou vyhodnotí a použije výslednou URL pro získání podkladů.

Podpora proměnných

Při přidání nebo úpravě URL veřejného webu nebo zdroje vědomostí SharePoint můžete do pole pro URL vložit proměnnou.

Použijte proměnnou k následujícímu:

• Připojení cesty k základní adrese URL

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

• Nahrazení celé adresy URL

  {variable}

Za běhu se proměnná převede na řetězcovou hodnotu. Zdroj vědomostí je vázán na vyřešenou URL.

Poznámka:

Pomocí proměnné se změní adresa URL, která se používá k uzemnění. Nemění požadavky na strukturu URL ani omezení úrovně veřejných webů.

Vytvořte a nastavte proměnnou

Pro použití proměnné na veřejném webu nebo ve zdroji znalostí SharePoint:

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

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

   • Vstupy tématu
   • Vlastnosti uživatelského profilu, například jazyk
   • Proměnné prostředí
   • Toky agenta nebo konektory

3. Vložte proměnnou do pole URL výběrem {x} (Vložit proměnnou).

4. Otestujte agenta a ověřte, že proměnná vede k očekávané URL.

Příklad: Rozsah podle produktu

Rozsah znalostí můžete omezit na různé produktové oblasti podle uživatelského dotazu.

1. Použijte vstup pro téma k zachycení názvu produktu jako proměnné pojmenované Product.

2. Přidejte uzel Nastavit hodnotu proměnné za uzlem Trigger a vytvořte novou proměnnou pojmenovanou ProductTable.

3. Použijte vzorec Power Fx k definování a přiřazení názvů produktů k cestám adresy 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 pojmenované GlobalProductURL.

5. V nastavení Na hodnotu vyberte Vzorec a použijte funkci Power Fx k vyhledání v tabulce podle hodnoty vstupní proměnné Product, Topic.Product, následovně:

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

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

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

Agent při běhu dotazuje pouze vymezenou sekci webu.

Obvyklé scénáře

Použijte proměnné ve veřejných webových zdrojích vědomostí pro:

• Směrování založené na produktu: Dotazy na konkrétní produktovou dokumentaci.

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

• URL specifické pro prostředí: Lze přepínat mezi vývojovými, testovacími a produkčními weby.

Důležité informace

• Veřejné webové zdroje vědomostí používají vyhledávání Bing a spoléhají na indexovaný obsah.
• Omezení hloubky URL zůstávají v platnosti při použití proměnných.
• Proměnné mění pouze cílovou URL. Neovlivňují způsob, jakým je obsah indexován nebo získáván.

Důležité

Proměnná musí být vyhodnocena jako platná veřejná webová adresa, která splňuje požadavky pro zdroje vědomostí z veřejných webů. Neplatné nebo nepodporované URL nemusí vrátit výsledky.