Přidat veřejný web jako zdroj znalostí

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů využívajících standardní harness.

Když přidáte veřejné weby jako zdroje znalostí na úrovni agenta, použijete veřejně dostupné informace ke zlepšení dosahu vašeho agenta.

Přidání veřejného webu

Pokud chcete přidat veřejný web jako zdroj znalostí, proveďte 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. Vyberte Veřejné weby.

   

4. Zadejte URL veřejné webové stránky do pole odkazu na veřejné webové stránky . Pro použití proměnné místo statické URL vyberte ikonu výběru proměnné (x) vedle pole URL a vyberte proměnnou Custom, System nebo Environment . Vyber Přidat pro přidání odkazu do seznamu.

5. Volitelně upravte pole Název (URL webu se používá ve výchozím nastavení).

6. Volitelně upravit pole Popis . Popis je ve výchozím nastavení vyplněn automaticky. Podrobný popis je obzvlášť užitečný, pokud je generativní AI aktivována, protože popis pomáhá generativní orchestraci.

   

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

   

8. Otestujte svého agenta, abyste zjistili, jak dobře odpovídá na otázky týkající se obsahu vašeho webu. Možná budete chtít otestovat otázky týkající se okrajových případů, abyste se rozhodli, zda potřebujete nižší úroveň moderování a byli inkluzivnější.

Co je třeba zvážit pro URL

Adresa URL, kterou používáte ve svém agentu, představuje rozsah obsahu pro generování odpovědí. Některé adresy URL mají požadavky a omezení.

Note

• Když zadáte adresu URL, zdroj znalostí použije základy vyhledávání Bingu k vrácení informací z webu.
• Klasické možnosti dat ve vlastnostech uzlu generující odpovědi umožňují zadat dynamicky vytvořené adresy URL pomocí vzorce Power Fx. Další informace najdete v článku Použití vlastního zdroje dat pro uzly generující odpovědi.
• Můžete také specifikovat Vlastní vyhledávání Bingu v možnostech Klasická data vlastností uzlu generativních odpovědí. Přečtěte si další informace o veřejných datech vyhledávání nebo použijte vlastní vyhledávání Bingu pro generování odpovědí.

Délka vyhledávacího dotazu

Když agent odpoví z veřejné webové stránky, použije Grounding s Bing Search a odešle vyhledávací dotaz do Bingu jako webový požadavek. Celková délka tohoto požadavku včetně vyhledávacího dotazu nesmí přesáhnout 2 048 znaků. Pokud je dotaz dostatečně dlouhý na to, aby požadavek překročil tento limit, agent vyhledávání přeskočí a z webu nevrátí žádné výsledky.

U veřejných webových stránek je vyhledávací dotaz založen na celé uživatelově otázce, přeformulované tak, aby zahrnoval relevantní kontext z konverzace. Několik faktorů může tento dotaz prodloužit natolik, aby dosáhl limitu:

• Dlouhé uživatelské dotazy.
• Dlouhé nebo složité rozhovory, protože dotaz obsahuje relevantní kontext z předchozích tahů.
• Jazyky používající vícebajtové znaky, jako je japonština, čínština a korejština, protože každý znak se při zakódování v požadavku rozšíří na několik znaků.

Tip

Aby se snížila šance na dosažení tohoto limitu, udržujte otázky stručné a konverzace zaměřené.

Typ a struktura adresy URL

• Adresa URL může mít až dvě úrovně hloubky s dílčími cestami označenými lomítkem /. Je však povoleno i lomítko na konci.

  Platný	Neplatný
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Pokud adresa URL přesměrovává na jiný web nejvyšší úrovně, obsah není do výsledků zahrnut:

  Pokud se např. www.fabrikam.com přesměrovává na www.contoso.fabrikam.com, váš agent negeneruje odpovědi z obsahu na žádné z těchto adres URL.

• Adresy URL, které odkazují na web vyžadující ověřování nebo neindexované bingem, se nepodporují.

  Například wikiweby a SharePoint weby vyžadují ověření, takže je nemůžete použít:

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

Struktura domény URL

Váš agent používá k vygenerování obsahu jakýkoli veřejně zobrazitelný obsah v zadané adrese URL, včetně subdomén v doméně nejvyšší úrovně.

Příklady:

• Pokud použijete www.fabrikam.com/engines/rotary, agent také použije obsah na www.fabrikam.com/engines/rotary/dual-shaft k vygenerování odpovědí.

  Agent nepoužívá obsah na www.fabrikam.com/tools, protože nástroje nejsou subdoménou rotary.

• Pokud používáte www.fabrikam.com ( www existuje), agent nepoužívá obsah na news.fabrikam.com ( www neexistuje), protože zprávy. je subdoména pod doménou nejvyšší úrovně fabrikam.com.

• Pokud používáte fabrikam.com, agent využívá obsah na www.fabrikam.comnews.fabrikam.com, protože tyto stránky spadají pod doménu nejvyšší úrovně fabrikam.com.

Adresy URL sociálních sítí a fór

Váš agent může generovat nesmyslné, irelevantní nebo nevhodné odpovědi, pokud jako adresu URL použijete fórum nebo web sociální sítě. Komunitní obsah na sociálních sítích proto často zvyšuje riziko odmítnutí většího počtu odpovědí.

Další informace najdete v části Nejčastější dotazy ke generativním odpovědím. Umělá inteligence je vycvičena, aby se vyhnula generování škodlivých a útočných reakcí.

Adresy URL vyhledávacích webů

Nepoužívejte adresy URL vyhledávacích webů jako bing.com, protože neposkytují užitečné odpovědi.

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