URL-mapping

De URL Mapping-functie binnen de kennisbankwidget stelt je in staat de weergave van specifieke artikelen en categorieën aan te passen op basis van de pagina's die je eindgebruikers bezoeken. Deze functionaliteit verbetert niet alleen de gebruikerservaring door gebruikers naar relevante content te leiden, maar stelt je ook in staat om de knowledge base-widget op bepaalde URL's te verbergen of een zoekbalk met aangepaste placeholders te bieden, zodat gebruikers kunnen zien waar ze op moeten zoeken.

Gebruik van URL-mapping

Om URL-mapping te configureren, voer je specifieke acties uit binnen de knowledge base-widget voor aangewezen URL's.

Acties

Er zijn vier acties die je kunt uitvoeren met URL-mapping:

1. Toon artikel: Toont één artikel op de opgegeven URL.

2. Toon lijst van artikelen: Lijst geselecteerde artikelen onder de Aanbevolen sectie binnen de Knowledge Base-widget op de opgegeven URL.

3. Toon zoekresultaten: Hiermee kunt u een specifieke zoekterm instellen om uw kennisbank te doorzoeken, waarbij relevante zoekresultaten op de opgegeven URL worden teruggegeven.

4. Widget verbergen: Voorkomt dat het Knowledge Base-widget-icoon verschijnt op de opgegeven URL.

Je kunt deze acties vinden onder het tabblad URL Mapping of bij het bewerken van een bestaande mapping.

OPMERKING

Om URL-mapping te laten werken, moet de Knowledge Base-widget binnen je site of app zijn geïnstalleerd. Voor meer informatie, lees het artikel over het installeren van de kennisbank-widget.

URL-parameters

Bij het configureren van de Knowledge Base-widget-URL kun je drie soorten parameters toevoegen:

1. Neem het pad op:/thisis/a/path

2. Vraag toevoegen: ?animal=bear

3. Hash opnemen: #inbox

Je kunt ook de schakelaar Is Regex inschakelen om reguliere expressies in je URL-configuraties te integreren.

URL-mapping toevoegen aan je widget

Om de gewenste widget te integreren in je kennisbanksite, volg je deze stappen:

1. Navigeer naar Connections () > Knowledge base-widget in de linker navigatiebalk van je Knowledge base portal.

2. Ga naar de gewenste widget en klik op het tabblad URL Mapping .

3. Je kunt kiezen voor Ask Eddy AI om vragen te stellen, een artikel te doorzoeken, of kiezen voor Nieuwe URL-mapping.

4. Klik op Nieuwe URL mapping en specificeer het volgende:

   • Naam - De naam van de URL-mapping wordt alleen weergegeven in het URL-mappingrecord binnen Document360

   • URL-structuur  - Selecteer het gewenste URL-parametertype (Pad insluit/Query insluiten/Hash insluiten). Je moet ten minste één URL-parameter inschakelen

   • Typ de URL in waarop je wilt dat het artikel/de categorie wordt weergegeven of waar de actie plaatsvindt.

     OPMERKING

     Je domeinnaam is niet opgenomen in het URL-pad. Bijvoorbeeld, https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/, je URL-pad zou zijn /ebook/rapid-guide-to-launch-your-knowledge-base/

   • Actie - Selecteer de gewenste actie.

   • Selecteer werkruimte - Selecteer de gewenste versie (als je meerdere versies hebt).

   • Taal naar - Selecteer de gewenste taal (als je meerdere talen hebt).

   • Artikel om te tonen - Selecteer in de zoekbalk de artikelen/categorieën die je wilt tonen uit je kennisbankdocumentatie.

   OPMERKING

   Mappencategorieën zijn niet beschikbaar om te selecteren. Alleen pagina- en indexcategorieën zijn beschikbaar om te selecteren.

5. Klik op Aanmaken.

Zodra een eindgebruiker het opgegeven URL-pad opent en de Knowledge Base-widget opent, ziet hij het toegewezen artikel/categorie. Deze informatie blijft consistent terwijl ze navigeren tussen de Knowledge Base-widgettabbladen binnen dezelfde versie en taal.

Contextuele AI-ondersteuning configureren

De optie Contextuele AI-ondersteuning laat je AI-gestuurde prompts weergeven in de Knowledge Base-widget. Afhankelijk van je configuratie kunnen deze prompts verschijnen wanneer gebruikers op een knop klikken of automatisch wanneer ze een specifieke pagina openen, samen met het antwoord op de prompts.

OPMERKING

Om contextuele AI-ondersteuning te configureren, zorg ervoor dat AI-ondersteunend zoeken voor de widget is ingeschakeld.

Inzicht in promptingtypes

Je kunt contextuele AI-ondersteuning op twee manieren configureren.

1. Knopgebaseerde prompting

2. Pagina-niveau prompting

Knopgebaseerde prompting

Gebruik deze optie om contextbewuste hulp te tonen wanneer lezers op specifieke knoppen op je website of app klikken.

• Elke prompt die je toevoegt genereert een unieke Trigger-toets.

• De prompt wordt automatisch gevalideerd door Enter te drukken om te bevestigen of er een antwoord is gevonden in de gekoppelde bronnen.

• Je kunt ofwel een bestaande knop bijwerken door het aangepaste attribuut d360AIHelp met de Trigger-toets als waarde toe te voegen, of een nieuwe knop maken door het installatiecodefragment te kopiëren en in je HTML te plakken.

• Wanneer op de knop wordt geklikt, opent de widget automatisch en toont de geconfigureerde AI-prompt met het bijbehorende antwoord.

• Je kunt tot 5 button–prompt-mappings per URL configureren.

• Als meerdere knoppen op dezelfde pagina zijn geconfigureerd:

  • De prompt voor de aangeklikte knop wordt als eerste weergegeven.

  • Prompts van andere knoppen verschijnen in de widget als gerelateerde of voorgestelde queries.

Pagina-niveau prompting

Gebruik deze optie om automatisch AI-gestuurde hulp te bieden wanneer gebruikers een specifieke pagina openen, zonder dat er een knopinteractie nodig is.

• Om deze optie te kiezen, kies je pagina-niveau prompting inschakelen tijdens de configuratie van Contextuele AI-ondersteuning.

• Voeg één of meer prompts toe die geactiveerd worden wanneer gebruikers de geconfigureerde URL openen. De prompt wordt automatisch gevalideerd door Enter te drukken om te bevestigen of er een antwoord is gevonden in de gekoppelde bronnen.

• Je kunt tot 5 prompts per pagina toevoegen.

  • De eerste prompt wordt weergegeven als de hoofdvraag.

  • Overige prompts verschijnen als voorgestelde zoekopdrachten.

Prompts toevoegen, valideren en verwijderen

Voor knopgebaseerde prompting

1. In de sectie 'Contextuele AI-ondersteuning configureren ' laat je de prompt 'paginaniveau inschakelen ' niet aangevinkt.

2. Voer vervolgens je zoekopdracht in.

3. Druk Enter om de prompt te valideren.

   • Als het systeem een antwoord vindt, toont het Antwoord naast de prompt als een groen label.

   • Als er geen overeenkomend resultaat wordt gevonden, toont het systeem Antwoord niet gevonden als een rood label.

4. Als je een bestaande knop bijwerkt, kopieer dan de Trigger-toets en voeg deze toe aan de code van de bestaande knop met behulp van het d360AIHelp attribuut.

   Bijvoorbeeld,

   <button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>

5. Als je een nieuwe knop aanmaakt, klik dan op Code kopiëren naast Installatiecode om de nieuwe knop te maken, en plak het fragment vervolgens in de HTML van je pagina.

6. Om een extra knopgebaseerde prompt toe te voegen, klik je op Meer toevoegen en herhaal je het proces.

7. Om een prompt te verwijderen, klik je op Verwijderen naast de betreffende invoer.

Voor page-level prompting

1. Selecteer het vakje 'Pagina-niveau prompt' inschakelen .

2. Voer je in het zoekpromptveld je zoekopdracht in.

3. Druk Enter om de prompt te valideren.

   • Als het systeem een antwoord vindt, toont het Antwoord naast de prompt als een groen label.

   • Als er geen overeenkomend resultaat wordt gevonden, toont het systeem Antwoord niet gevonden als een rood label.

4. Om een andere prompt toe te voegen, klik je op Meer toevoegen en voer je een nieuwe query in. Herhaal dit totdat je tot vier prompts voor die URL hebt toegevoegd.

5. Om een prompt te verwijderen, klik je naast het promptveld op Verwijderen .

Zodra je button-based of page-level prompts hebt geconfigureerd, klik je op Aanmaken.

Je kunt standaard URL-mappingacties (zoals artikel tonen) combineren met contextuele AI-ondersteuning over verschillende URL's om een op maat gemaakte, intelligente gebruikerservaring te bieden.

URL-mapping bewerken

Om een bestaande URL-mapping aan te passen:

1. Beweeg je muis over de gewenste kennisbasis-widget en klik op het pictogram Bewerken () ().

   In het tabblad URL-mapping vind je de lijst met beschikbare URL-mapping.

2. Beweeg je muis over de gewenste URL-mapping en klik op het pictogram Bewerken ().

   Het panel 'URL bijwerken ' verschijnt.

3. Werk de gewenste informatie bij en klik op Updaten.

URL-mapping verwijderen

Je kunt een set URL-mapping verwijderen.

1. Beweeg je muis over de gewenste kennisbasis-widget en klik op het pictogram Bewerken () ().

2. In het tabblad URL-mapping vind je de lijst met beschikbare URL-mapping.

3. Beweeg je muis over de gewenste URL-mapping en klik op het Verwijderen ()-icoon.

4. Klik op Ja in de bevestigingsprompt Verwijderen .

URL-mappinginstellingen

Je kunt het Knowledge Base-widgetgedrag definiëren voor URL's die geen geconfigureerde mapping hebben. Het definiëren van dit gedrag kan de gebruikerservaring en de toegankelijkheid van de documentatie verbeteren.

1. Ga naar de gewenste widget en klik op Bewerken.

2. Klik op het tabblad Configureren & verbinden .

3. Onder de sectie Set controls verbreed je de sectie voor URL-mappinginstellingen .

4. Selecteer de gewenste optie:

   • Navigeer naar de help/kennisbank van de pagina: Selecteer deze optie om het artikel/de categorie weer te geven in het tabblad Paginahulp of Kennisbank in de Widget.

   • Breng geen wijzigingen aan aan de bestaande setup: Selecteer deze optie om het laatst geopende artikel/categorie in de Widget te tonen.

5. Klik op Opslaan.

Basis URL-matching

Inzicht in URL-matching is cruciaal voor effectieve URL-mapping. Een algemeen regex voor het matchen van typische URL's ziet er als volgt uit:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Uitleg van de componenten

• ^https?://?: Komt overeen met het protocol (bijv. http:// of https://). Dat ? maakt het protocol optioneel.

  OPMERKING

  Zorg ervoor dat je een achterwaartse slash (\) toevoegt voor elke voorwaartse slash (/) terwijl je je URL op https://regex101.com test.

• [a-zA-Z0-9.-]+: Komt overeen met de domeinnaam, inclusief letters, cijfers, stippen (.), en koppeltekens (-).

• /[a-zA-Z0-9/._-]*?: Komt overeen met het pad na het domein, waardoor slashes, alfanumerieke tekens, stippen, onderstreepjes en koppeltekens mogelijk zijn.

• ?[a-zA-Z0-9=&._-]*?: Komt overeen met optionele queryparameters (bijv. ?key=value), waardoor dit onderdeel optioneel is.

• #[a-zA-Z0-9_-]*?: Komt overeen met het fragment (bijv. #section), wat ook optioneel is.

Voorbeelden van URL-mapping met Regex

Specifieke URL-structuren in kaart brengen

De volgende tabel toont hoe URL-mappings voor bepaalde URL-patronen kunnen worden geconfigureerd. Deze configuraties helpen om nauwkeurige matching te garanderen op basis van het URL-pad of de querystructuur.

Om een URL-patroon zoals /users/{id}te mappen, gebruik :

^/users/[0-9]+$

Dit vangt een gebruikers-ID dynamisch vast.

URL's toewijzen met queryparameters

Voor URL's zoals /search?q={query}, zou de regex zijn:

^/search?q=[a-zA-Z0-9]+$

URL's toewijzen met optionele parameters

Voor een URL-patroon zoals /products/{category}/{id}, waarbij categorie optioneel is:

^/products/[a-zA-Z]+?/[0-9]+$

URL's toewijzen met een joker of meerdere paden

Voor /blog/*:

^/blog/.*?$

URL's koppelen met subdomeinen
Voor subdomein-URL's:

^https?://?[a-zA-Z0-9-]+.example.com$

Meerdere componenten combineren

Om complexere URL-mappings te verwerken, kun je de verschillende componenten naar behoefte combineren. De uitgebreide regex die een URL matcht met een optioneel protocol, domein, pad, queryparameters en fragment ziet er als volgt uit:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$