Cartographie d’URL

La fonction de mappage d'URL dans le widget de la base de connaissances vous permet d'adapter l'affichage d'articles et de catégories spécifiques en fonction des pages visitées par vos utilisateurs finaux. Cette fonctionnalité améliore non seulement l'expérience utilisateur en les dirigeant vers du contenu pertinent, mais vous permet aussi de masquer le widget de la base de connaissances sur certaines URL ou de fournir une barre de recherche avec des espaces réservés personnalisés, orientant les utilisateurs sur ce qu'ils doivent rechercher.

Utilisation de la correspondance d'URL

Pour configurer la cartographie des URL, vous effectuez des actions spécifiques dans le widget de la base de connaissances pour des URL désignées.

Actions

Il y a quatre actions que vous pouvez exécuter avec le mappage d'URL :

Article de l'émission : Affiche un seul article sur l'URL spécifiée.
Afficher la liste des articles : Liste les articles sélectionnés sous la section Recommandés dans le widget de la Base de connaissances sur l'URL spécifiée.
Afficher les résultats de recherche : Cela vous permet de définir un terme de recherche spécifique pour interroger votre base de connaissances, en renvoyant les résultats de recherche pertinents sur l'URL spécifiée.
Masquer le widget : Empêche l'icône du widget de la Base de Connaissances d'apparaître sur l'URL spécifiée.

Vous pouvez trouver ces actions dans l'onglet Mappage d'URL ou lors de la modification d'une correspondance existante.

NOTE
Pour que la correspondance d'URL fonctionne, le widget de la base de connaissances doit être installé sur votre site ou application. Pour plus d'informations, lisez l'article sur l'installation du widget de la base de connaissances.

Paramètres URL

Lors de la configuration de l'URL du widget de la Base de connaissances, vous pouvez inclure trois types de paramètres :

Inclure le chemin : /thisis/a/path
Inclure la requête : ?animal=bear
Inclure le hachage : #inbox

Vous pouvez aussi activer le bouton Is Regex pour intégrer des expressions régulières dans vos configurations d'URL.

Ajout de la correspondance d'URL à votre widget

Pour intégrer le widget souhaité dans votre site de base de connaissances, suivez ces étapes :

Naviguez dans Connections () > widget de la base de connaissances dans la barre de navigation de gauche de votre Knowledge base portal.
Allez dans le widget souhaité et cliquez sur l'onglet Mappage d'URL .
Vous pouvez choisir Ask Eddy AI pour poser des questions, rechercher un article ou choisir Nouvelle URL mapping.
Cliquez sur nouvelle correspondance d'URL et spécifiez ce qui suit :
- Nom - Le nom de la correspondance URL ne sera affiché que sur l'enregistrement de mappage URL dans Document360
- Structure URL - Sélectionnez le type de paramètre URL souhaité (Inclure chemin/Inclure requête/Inclure le hachage). Vous devez activer au moins un paramètre d'URL
- Tapez l'URL sur laquelle vous souhaitez que l'article/la catégorie soit affichée ou que l'action ait lieu.
  NOTE
  Votre nom de domaine n'est pas inclus dans le chemin de l'URL. Par exemple, https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/, votre chemin d'URL serait /ebook/rapid-guide-to-launch-your-knowledge-base/
- Action - Sélectionnez l'action souhaitée.
- Sélectionnez l'espace de travail - Sélectionnez la version souhaitée (si vous en avez plusieurs).
- Langue à - Sélectionnez la langue souhaitée (si vous en avez plusieurs).
- Article à afficher - Dans la barre de recherche, sélectionnez les articles/catégories que vous souhaitez afficher dans la documentation de votre base de connaissances.
NOTE
Les catégories de dossiers ne sont pas disponibles pour la sélection. Seuls les types de pages et de catégories d'index sont disponibles pour la sélection.
Cliquez sur Créer.

Une fois qu'un utilisateur final accède au chemin de l'URL spécifié et ouvre le widget de la Base de connaissances, il verra l'article/la catégorie mappée. Ces informations restent cohérentes lorsqu'ils naviguent entre les onglets widget de la Base de connaissances au sein de la même version et langue.

Configuration de l'assistance de l'IA contextuelle

L'option d'assistance à l'IA contextuelle vous permet d'afficher des invites alimentées par l'IA dans le widget de la base de connaissances. Selon votre configuration, ces invites peuvent apparaître soit lorsque les utilisateurs cliquent sur un bouton, soit automatiquement lorsqu'ils ouvrent une page spécifique avec la réponse aux questions.

Widget configuration interface showing URL mapping and contextual AI assistance options.

NOTE
Pour configurer l'assistance par IA contextuelle, assurez-vous que la recherche assistée par IA est activée pour le widget.

Comprendre les types d'incitations

Vous pouvez configurer l'assistance de l'IA contextuelle de deux façons.

Invite basée sur des boutons
Invite au niveau de la page

Invite basée sur des boutons

Utilisez cette option pour afficher une aide contextuelle lorsque les lecteurs cliquent sur des boutons spécifiques de votre site web ou application.

Chaque invite que vous ajoutez génère une clé de déclenchement unique.
L'invite est automatiquement validée en appuyant sur Entrée pour confirmer si une réponse est trouvée dans vos sources connectées.
Vous pouvez soit mettre à jour un bouton existant en ajoutant l'attribut d360AIHelp personnalisé avec la clé Trigger comme valeur, soit créer un nouveau bouton en copiant le code d'installation et en le collant dans votre HTML.
Lorsque le bouton est cliqué, le widget s'ouvre automatiquement et affiche l'invite IA configurée avec sa réponse correspondante.
Vous pouvez configurer jusqu'à 5 correspondances bouton-invite par URL.
Si plusieurs boutons sont configurés sur la même page :
- L'invite pour le bouton cliqué s'affiche en premier.
- Les invites provenant d'autres boutons apparaissent dans le widget sous forme de requêtes liées ou suggérées.

Invite au niveau de la page

Utilisez cette option pour fournir automatiquement une aide pilotée par l'IA lorsque les utilisateurs ouvrent une page spécifique, sans nécessiter d'interaction avec un bouton.

Pour choisir cette option, sélectionnez Activer l'invite au niveau de la page lors de la configuration d'assistance de l'IA contextuelle.
Ajoutez une ou plusieurs invites qui se déclencheront lorsque les utilisateurs accèdent à l'URL configurée. L'invite est automatiquement validée en appuyant sur Entrée pour confirmer si une réponse est trouvée dans vos sources connectées.
Vous pouvez ajouter jusqu'à 5 prompts par page.
- La première question est présentée comme la question principale.
- Les autres requêtes apparaissent sous forme de requêtes suggérées.

Ajouter, valider et supprimer des invites

Pour les indications basées sur des boutons

Dans la section Configurer l'aide à l'IA contextuelle , laissez l' invite Activer au niveau de la page non cochée.

Configuration options for a contextual AI assistance widget with various actions listed.

Ensuite, entrez votre invite de recherche.
Appuyez sur Entrée pour valider la demande.
- Si le système trouve une réponse, il affiche la réponse trouvée à côté de l'invite sous forme d'une étiquette verte.
- Si aucun résultat correspondant n'est trouvé, le système affiche Réponse non trouvée sous forme d'étiquette rouge.
Si vous mettez à jour un bouton existant, copiez la clé Trigger et ajoutez-la au code du bouton existant en utilisant l' d360AIHelp attribut.
Par exemple,
```
<button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>
```

Instructions for adding URL mapping and contextual AI assistance in a widget interface.

Si vous créez un nouveau bouton, cliquez sur Copier le code à côté de Code d'installation pour créer le nouveau bouton, puis collez l'extrait dans le HTML de votre page.

Instructions for configuring contextual AI assistance with a widget installation code.

Pour ajouter une autre invite à bouton, cliquez sur Ajouter plus et répétez le processus.
Pour supprimer une invite, cliquez sur Supprimer à côté de l'entrée correspondante.

Pour l'invite au niveau de la page

Configuration options for a widget including URL mapping and contextual AI assistance settings.

Sélectionnez la case à cocher pour l'invite au niveau de la page .
Dans le champ de recherche, saisissez votre requête.
Appuyez sur Entrée pour valider la demande.
- Si le système trouve une réponse, il affiche la réponse trouvée à côté de l'invite sous forme d'une étiquette verte.
- Si aucun résultat correspondant n'est trouvé, le système affiche Réponse non trouvée sous forme d'étiquette rouge.
Pour ajouter une autre invite, cliquez sur Ajouter plus et saisissez une nouvelle requête. Répétez jusqu'à ce que vous ayez ajouté jusqu'à quatre invites pour cette URL.
Pour supprimer une invite, cliquez sur Supprimer à côté du champ de la demande.

Une fois que vous avez configuré les invites basées sur des boutons ou au niveau de la page, cliquez sur Créer.

Vous pouvez combiner des actions standard de mappage d'URL (comme Afficher un article) avec une assistance d'IA contextuelle sur différentes URL afin d'offrir une expérience utilisateur personnalisée et intelligente.

Modification de la correspondance d'URL

Pour modifier un mappage d'URL existant :

Passez la souris sur le widget de la base de connaissances souhaité et cliquez sur l' icône Modifier ().
Dans l'onglet de mappage d'URL , vous pouvez trouver la liste des mappages d'URL disponibles.
Survolez la correspondance d'URL souhaitée et cliquez sur l' icône Modifier ().
Le panneau de mappage Mettre à jour l'URL apparaîtra.
Mettez à jour les informations souhaitées et cliquez sur Mettre à jour.

Suppression du mappage d'URL

Vous pouvez supprimer un mappage d'URL défini.

Passez la souris sur le widget de la base de connaissances souhaité et cliquez sur l' icône Modifier ().
Dans l'onglet de mappage d'URL , vous pouvez trouver la liste des mappages d'URL disponibles.
Survolez la correspondance d'URL souhaitée et cliquez sur l' icône Supprimer ().
Cliquez sur Oui dans l'invite de confirmation Supprimer .

Paramètres de mappage d'URL

Vous pouvez définir le comportement des widgets de la base de connaissances pour les URL qui n'ont pas de mappage configuré. Définir ce comportement peut améliorer l'expérience utilisateur et l'accessibilité à la documentation.

Settings for configuring a knowledge base widget, highlighting URL mapping options.

Allez dans le widget souhaité et cliquez sur Modifier.
Cliquez sur l'onglet Configurer & connecter .
Dans la section Définir les contrôles , développez la section paramètres de mappage d'URL .
Sélectionnez l'option souhaitée :
- Naviguez vers la page aide/base de connaissances : Sélectionnez cette option pour afficher l'article/la catégorie dans l'onglet Aide de la page ou la Base de connaissances du Widget.
- N'apportez aucun changement à la configuration existante : Sélectionnez cette option pour afficher le dernier article/catégorie ouvert dans le Widget.
Cliquez sur Enregistrer.

Correspondance d'URL de base

Comprendre la correspondance d'URL est crucial pour un mappage efficace des URL. Un régex généraliste pour correspondre des URL typiques ressemble à ceci :

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

Explication des composantes

^https?://?: Correspond au protocole (par exemple, http:// ou https://). Cela ? rend le protocole optionnel.
NOTE
Assurez-vous d'ajouter une barre oblique vers l'envers (\) avant chaque barre oblique avant (/) lors du test de votre URL sur https://regex101.com.
[a-zA-Z0-9.-]+: Correspond au nom de domaine, incluant lettres, chiffres, points (.), et traits d'union (-).
/[a-zA-Z0-9/._-]*?: Correspond au chemin après le domaine, permettant les barres obliques, les caractères alphanumériques, les points, les soulignements et les traits d'union.
?[a-zA-Z0-9=&._-]*?: Correspond aux paramètres de requête optionnels (par exemple, ?key=value), rendant cette partie optionnelle.
#[a-zA-Z0-9_-]*?: Correspond au fragment (par exemple, #section), ce qui est également optionnel.

Exemples de mappage d'URL utilisant Regex

Cartographie de structures URL spécifiques

Le tableau suivant montre comment configurer les correspondances d'URL pour certains schémas d'URL. Ces configurations permettent d'assurer une correspondance précise basée sur le chemin de l'URL ou la structure de requête.

Structure de l'URL	Configuration de la correspondance d'URL
`/buckets`	`/buckets$` (Configurer si l'URL se termine par `buckets`)
`/buckets?isCreatingBucket`	`/buckets\?[a-z]*` (Configurer si l'URL contient des textes aléatoires après le paramètre de requête)

Exemples de matchs

/buckets
/buckets?isCreatingBucket
/buckets?isCreatingBucket=true

Pour mapper un motif URL comme /users/{id}, utilisez :

^/users/[0-9]+$

Cela capture dynamiquement un identifiant utilisateur.

Exemples de matchs

/users/123
/users/456

Mappage des URL avec paramètres de requête

Pour des URL comme /search?q={query}, le régex serait :

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

Exemples de matchs

/search?q=apple
/search?q=123abc

Mappage des URL avec des paramètres optionnels

Pour un modèle URL comme /products/{category}/{id}, où la catégorie est optionnelle :

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

Exemples de matchs

/products/123
/products/electronics/123

Mappage d'URL avec un joker ou plusieurs chemins

Pour /blog/*:

^/blog/.*?$

Exemples de matchs

/blog
/blog/how-to-code
/blog/2021/10

Mappage d'URL avec sous-domaines
Pour les URL de sous-domaines :

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

Exemples de matchs

http://blog.example.com
https://shop.example.com

Combinaison de plusieurs composants

Pour gérer des mappages d'URL plus complexes, vous pouvez combiner les différents composants selon les besoins. Le régex complet qui correspond à une URL avec un protocole, un domaine, un chemin, des paramètres de requête et un fragment optionnels ressemble à ceci :

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

FAQ

Comment puis-je supprimer la barre d'aide de page et de recherche du widget lorsque le mappage d'URL pour un seul article est configuré ?

Pour supprimer la barre d'aide de page et de recherche du widget lorsque le mappage d'URL pour un seul article est configuré :

Naviguez jusqu' à Widget () dans le portail de la base de connaissances.
Surcassez le widget souhaité et cliquez sur l' icône Modifier ().

Collez le code fourni dans l'onglet CSS personnalisé :

li#page-help-tab {
    display: none;
}

.article-header .article-back-icon {
    display: none;
}

.search-container {
    display: none !Important;
}

Collez le code fourni dans l'onglet JavaScript personnalisé :

setTimeout(function() { $('.search-container').hide();}, 2000);
setTimeout(function() { $("#knowledge-base-tab").click();}, 2000);

Cliquez sur Enregistrer.

Cela masquera l'onglet d'aide de la page et la barre de recherche dans le widget du site de la base de connaissances lorsque le mappage d'URL pour un seul article est configuré.

Comment puis-je voir les mises à jour immédiatement dans le widget de la base de données après avoir ajouté ou mis à jour une carte URL ?

Les mises à jour sont mises en cache sur le serveur pour des raisons de performance et se rafraîchissent automatiquement toutes les 15 minutes. Cependant, si vous devez voir les changements immédiatement, vous pouvez vider le cache de l'application.

Pourquoi un mappage d'URL configuré semble-t-il défectueux ?

Le mappage des URL serait défaillant en raison de toute modification de la configuration « Filtrer le contenu du widget » dans l'onglet « Installation & configuration ». Vérifiez la correspondance des URL et mettez à jour la configuration.

Qu'est-ce que le mappage d'URL ?

Avec le mappage d'URL, vous pouvez faire apparaître des articles et des catégories spécifiques dans le widget de la base de connaissances, selon la page sur laquelle se trouve l'utilisateur final. Vous pouvez également utiliser la correspondance d'URL pour masquer le widget de la base de connaissances sur une URL spécifique ou fournir une barre de recherche avec un espace réservé personnalisé pour orienter les utilisateurs finaux sur la bonne direction à rechercher.

Puis-je ajouter des expressions régulières (regex) dans le mappage d'URL ?

Vous pouvez inclure des expressions régulières dans votre URL en activant le bouton Is Regex.

Qu'est-ce que le regex ?

Regex, abréviation de « expression régulière », est une séquence de caractères qui définit un motif de recherche utilisé pour faire correspondre et manipuler des chaînes de texte.

Par exemple, vous pouvez utiliser regex pour configurer un seul mappage d'URL pour plusieurs articles avec des URL similaires. Considérons un scénario où vous souhaitez configurer le mappage d'URL pour les articles suivants avec l'URL de base 'https://example.com/docs/drive':

https://example.com/drive-General
https://example.com/drive-settings
https://example.com/drive-functionA
https://example.com/drive-functionB
https://example.com/drive-functionC
https://example.com/drive-functionD
https://example.com/drive-functionE

Sans regex, il faudrait ajouter des correspondances d'URL individuelles pour chaque URL. Cependant, en activant la règle régulière, vous pouvez ajouter avec une seule URL une correspondance : sélectionnez l'option « Inclure le chemin » et ajoutez docs/drive le champ URL. Vous pouvez utiliser le régex pour obtenir un processus de cartographie plus efficace et simplifié.

Puis-je ajouter un mappage d'URL pour les catégories ?

Oui, vous pouvez ajouter un mappage d'URL pour les catégories. Cela ne s'applique qu'aux catégories de pages et d'index.