Een openbare website toevoegen als kennisbron

Wanneer u openbare websites toevoegt als kennisbronnen op agentniveau, gebruikt u openbaar beschikbare informatie om het bereik van uw agent te verbeteren.

Een openbare website toevoegen

Voer de volgende stappen uit om een openbare website toe te voegen als kennisbron:

1. Open de software-agent.

2. Selecteer Kennis toevoegen op de pagina Overzicht of Kennis of de eigenschappen van een generatief antwoordknooppunt.

3. Selecteer Openbare websites.

4. Voer de URL naar de openbare website in. Als u een variabele wilt gebruiken in plaats van een statische URL, selecteert u het pictogram voor de variabelekiezer naast het URL-veld en kiest u een aangepaste, systeem- of omgevingsvariabele .

5. Voeg een naam toe (standaard wordt de URL van de website gebruikt).

6. Voeg een beschrijving toe. Geef een gedetailleerde beschrijving op, met name als generatieve AI is ingeschakeld, omdat de beschrijving de generatieve orkestratie ondersteunt.

7. Selecteer Toevoegen aan agent om het toevoegen van de kennisbron te voltooien.

8. Test uw agent om te zien hoe goed deze reageert op vragen die betrekking hebben op de inhoud van uw website. Misschien wilt u randcasevragen testen om te beslissen of u een lagere moderatie nodig hebt om inclusiever te zijn.

URL-overwegingen

De URL die u in uw agent gebruikt, vertegenwoordigt het inhoudsbereik voor het genereren van antwoorden. Sommige URL's hebben vereisten en beperkingen.

Type en structuur van URL

• De URL kan maximaal twee diepteniveaus hebben, met subpaden die worden aangegeven door een schuine streep /. Een afsluitende forward slash is echter toegestaan.

  Geldig	Ongeldig
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Als de URL omleidt naar een andere site op het hoogste niveau, wordt de inhoud niet opgenomen in resultaten:

  Als www.fabrikam.com bijvoorbeeld doorverwijst naar www.contoso.fabrikam.com, genereert uw agent geen reacties op inhoud op een van deze URL's.

• URL's die verwijzen naar een website waarvoor verificatie is vereist of url's die niet door Bing worden geïndexeerd, worden niet ondersteund.

  Wiki's en SharePoint sites vereisen bijvoorbeeld verificatie, zodat u ze niet kunt gebruiken:

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

URL-domeinstructuur

Uw agent maakt gebruik van inhoud die openbaar kan worden weergegeven in de URL die u opgeeft, inclusief subdomeinen onder een domein op het hoogste niveau, om inhoud te genereren.

Voorbeelden:

• Als u www.fabrikam.com/engines/rotary gebruikt, gebruikt de agent ook de inhoud van www.fabrikam.com/engines/rotary/dual-shaft om antwoorden te genereren.

  De agent gebruikt geen inhoud op www.fabrikam.com/tools, aangezien tools geen subdomein van rotary is.

• Als u www.fabrikam.com(de www bestaat), gebruikt de agent geen inhoud op news.fabrikam.com (www bestaat niet), omdat news. een subdomein is onder het topleveldomein fabrikam.com.

• Als u fabrikam.com gebruikt, gebruikt de agent inhoud op www.fabrikam.com en news.fabrikam.com, omdat deze zich onder het domein op het hoogste niveau bevinden fabrikam.com.

URL's van sociale netwerken en forums

Als u een forum of een sociale netwerksite als URL gebruikt, kan het zijn dat uw agent onzinnige, irrelevante of ongepaste antwoorden geeft. Daarom vergroot community-inhoud op sociale netwerken vaak het risico dat meer antwoorden worden afgewezen.

Zie de Veelgestelde vragen over generatieve antwoorden voor meer informatie. AI wordt getraind om het genereren van kwaadaardige en aanstootgevende responsen te voorkomen.

Zoekmachine-URL's

Neem geen URL's van zoekmachines op, zoals bing.com, omdat deze geen bruikbare responsen opleveren.

Variabelen gebruiken als URL's

Gebruik variabelen in openbare website of SharePoint URL's van kennisbronnen om dynamisch het bereik van inhoud te bepalen die uw agent gebruikt.

In plaats van meerdere kennisbronnen te maken voor verschillende scenario's, definieert u één kennisbron en voegt u een variabele in de URL in. Tijdens uitvoeringstijd lost Copilot Studio de variabele op en gebruikt de resulterende URL voor verwerking.

Ondersteuning voor variabelen

Wanneer u een openbare website of SharePoint kennisbron-URL toevoegt of bewerkt, kunt u een variabele invoegen in het URL-veld.

Gebruik een variabele om:

• Een pad toevoegen aan een basis-URL

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

• De volledige URL vervangen

  {variable}

Tijdens runtime wordt de variabele omgezet in een tekenreekswaarde. De kennisbron is beperkt tot de opgeloste URL.

Een variabele maken en instellen

Een variabele gebruiken in een openbare website of SharePoint kennisbron:

1. Maak een tekenreeksvariabele met globaal bereik.

2. Stel de variabelewaarde in met een van de volgende opties:

   • Onderwerpinvoer
   • Eigenschappen van gebruikersprofielen, zoals taal
   • Omgevingsvariabelen
   • Agentstromen of connectors

3. Voeg de variabele in het URL-veld in door {x} (variabele invoegen) te selecteren.

4. Test de agent om te bevestigen dat de variabele leidt naar de verwachte URL.

Voorbeeld: Bereik per product

U kunt kennis op verschillende productgebieden toepassen op basis van de query van de gebruiker.

1. Gebruik een onderwerpinvoer om de productnaam vast te leggen als een variabele met de naam Product.

2. Voeg een waardeknooppunt voor variabelen instellen toe na het knooppunt Trigger en maak een nieuwe variabele met de naam ProductTable.

3. Gebruik een Power Fx-formule om de productnamen te definiëren en toe te wijzen aan URL-paden.

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

4. Voeg nog een waardeknooppunt voor variabelen instellen toe en gebruik dit om een nieuwe globale variabele van het tekenreekstype met de naam GlobalProductURLte maken.

5. Selecteer in de instelling Naar-waardede optie Formule en gebruik een Power Fx-functie om een zoekopdracht uit te voeren in de tabel op basis van de waarde van Product de invoervariabele, Topic.Productals volgt:

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

6. Gebruik de variabele in de URL van de kennisbron:

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

De agent voert tijdens de uitvoertijd alleen query's uit op het specifieke gedeelte van de website.

Algemene scenario's

Variabelen gebruiken in kennisbronnen van openbare websites voor:

• Routering op basis van product: Query's beperken tot specifieke documentatie van producten.

• Regio- of taalfilters: toewijzen User.Language aan gelokaliseerde URL's (bijvoorbeeld en-us, it-it).

• Omgevingsspecifieke URL's: Schakelen tussen ontwikkel-, test- en productiesites.

Overwegingen

• Kennisbronnen van openbare websites maken gebruik van Bing Zoeken en zijn afhankelijk van geïndexeerde inhoud.
• Url-dieptelimieten zijn nog steeds van toepassing wanneer u variabelen gebruikt.
• Variabelen wijzigen alleen de doel-URL. Ze hebben geen invloed op de wijze waarop inhoud wordt geïndexeerd of opgehaald.