Objectifs

A la fin du tutoriel, vous saurez comment effectuer les opérations suivantes :

• Créez un projet d'extraction de document dans Discovery.
• Téléchargez des documents PDF dans votre projet et appliquez un modèle Smart Document Understanding entraîné par l'utilisateur à vos PDF.
• Connectez votre projet Discovery à une instance de service NeuralSeek. NeuralSeek est un moteur de génération de réponses basé sur l'intelligence artificielle.
• Créez un assistant dans watsonx Assistant et appliquez-lui une intégration NeuralSeek.
• Ajoutez une action à votre watsonx Assistant qui se connecte à NeuralSeek pour obtenir des réponses.
• Utilisez votre assistant pour répondre aux questions relatives à Discovery.

NeuralSeek est un produit tiers fourni par un fournisseur extérieur à IBM et fait l'objet d'un accord distinct entre vous et ce tiers, si vous en acceptez les conditions. IBM n'est pas responsable du produit et décline toute responsabilité en matière de confidentialité, de sécurité, de performance, de support ou d'autres engagements concernant le produit.

Obtenir la documentation du produit

Pour utiliser la documentation du produit Discovery comme base de connaissances, nous téléchargerons la documentation du produit sous forme de fichier PDF.

1. A partir d'un navigateur Web, accédez au site de la documentation du produit.

   https://cloud.ibm.com/docs/discovery-data
   

2. Dans le panneau de la table des matières, cliquez sur l'icône de menu déroulant dynamique dans la section Product guide, puis choisissez View as PDF.

3. Sauvegardez le fichier PDF sur votre système en cliquant sur l'icône Sauvegarder dans l'en-tête de page.

4. Utilisez un éditeur de fichier PDF pour fractionner le document PDF en deux fichiers PDF distincts de taille similaire.

   Le fractionnement du PDF crée deux fichiers plus petits qui peuvent être enrichis plus rapidement dans Discovery.

Créer un projet d'extraction de document

Maintenant que vous disposez de la dernière copie de la documentation du produit, ajoutez-la à un projet Discovery en tant que source de données.

Dans Discovery, vous allez créer un type de projet Document Retrieval. Les documents que vous ajoutez à un projet de ce type sont automatiquement enrichis de la manière suivante:

• Les entités, telles que les noms propres, sont identifiées et étiquetées.
• Les parties du discours sont identifiées et étiquetées.

Ces informations étiquetées sont utilisées ultérieurement lorsqu'une phrase en langage naturel est soumise en tant que requête de recherche pour renvoyer une réponse précise.

1. Ouvrez une nouvelle page de navigateur Web.

2. Sur la page du service de plan Discovery Plus dans IBM Cloud, cliquez sur Lancez Discovery.

3. Dans la page Mes projets, cliquez sur Nouveau projet.

4. Nommez votre projet Discovery documentation, puis cliquez sur la vignette Document Retrieval.

   

   du type de projet*

5. Cliquez sur Suivant.

Vous allez configurer la source de données pour le projet à l'étape suivante.

Télécharger des données dans le projet

Ajoutez les fichiers PDF de la documentation à votre projet Discovery.

1. Dans la page Sélectionner une source de données, cliquez sur la vignette Télécharger des données, puis sur Suivant.

   

2. Nommez la collection Discovery docs part 1, puis cliquez sur Next.

3. Cliquez sur Faire glisser et déposer des fichiers ici ou télécharger, puis accédez au premier fichier PDF que vous avez créé précédemment.

4. Cliquez sur Terminer.

Votre fichier est traité lorsqu'il est ajouté à la collection.

1. Dans le panneau de navigation, cliquez sur Manage collections, puis sur New collection.

   

2. Répétez les étapes précédentes pour ajouter le deuxième fichier PDF en tant que collection nommée Discovery docs part 2.

Une fois les données téléchargées, elles sont traitées et indexées par Discovery. Pendant le traitement des données, créons notre assistant virtuel.

Création d'un assistant

Pour ce tutoriel, vous allez créer un assistant avec une seule action. Vous devez d'abord créer une instance de service watsonx Assistant.

Les instances de service watsonx Assistant du plan Lite et du plan d'essai sont disponibles gratuitement. Vous allez créer un plan d'essai.

1. A partir d'un nouvel onglet de navigateur Web, revenez au catalogue IBM Cloud.

   Gardez la page Discovery ouverte dans un onglet distinct, afin de pouvoir basculer entre les deux applications.

2. A partir de la page de ressources watsonx Assistant du catalogue IBM Cloud, créez une instance de service de plan d'essai watsonx Assistant à l'emplacement de Dallas.

3. Depuis la page de service de plan watsonx Assistant dans IBM Cloud, cliquez sur Lancer watsonx Assistant.

   L'interface utilisateur du produit watsonx Assistant s'affiche pour vous permettre de créer votre premier assistant.

4. Ajoutez Discovery expert comme nom d'assistant, puis cliquez sur Suivant.

5. Si vous êtes invité à partager des informations sur vous et votre assistant, renseignez les zones requises, puis cliquez sur Suivant.

   Lorsque vous créez un assistant, une application de discussion Web est créée automatiquement pour vous.

6. Cliquez sur Créer pour créer l'assistant et l'application de discussion Web correspondante.

Après un message de félicitations, la page d'accueil de votre nouvel assistant s'affiche.

Avant d'ajouter quoi que ce soit à notre nouvel assistant, vérifions l'état de nos données.

Préparez vos données pour l'extraction

Pour améliorer l'extrabilité des informations de vos fichiers PDF, vous fractionnez les fichiers PDF en plusieurs documents plus petits. Pour ce faire, vous allez d'abord enseigner à Discovery la structure de vos fichiers PDF afin qu'il comprenne comment les sous-sections sont formatées et qu'il puisse fractionner le document par sous-section.

1. Revenez à l'onglet du navigateur Web dans lequel votre projet Discovery est affiché.

   La page Improve and customize du dernier fichier PDF que vous avez téléchargé s'affiche.

2. Dans le panneau Outils d'amélioration, développez Définir la structure, puis cliquez sur Nouveaux champs.

   

3. Choisissez la collection Discovery docs part 1.

   L'onglet Identifier les champs s'affiche, dans lequel vous pouvez choisir le type de modèle Smart Document Understanding que vous souhaitez utiliser.

4. Cliquez sur Modèles entraînés par l'utilisateur, puis sur Soumettre.

   

5. Cliquez sur Apply changes and reprocess.

   Après un certain traitement, une représentation du document s'affiche dans l'outil Smart Document Understanding. L'outil affiche une vue du document d'origine ainsi qu'une représentation du document, où le texte est remplacé par des blocs. Les blocs représentent les types de zone.

   Initialement, les blocs sont libellés en tant que text car tout le contenu du document est considéré comme du texte standard par défaut et est indexé dans la zone text.

   Nous voulons étiqueter tous les en-têtes de premier et de deuxième niveau en tant que sous-titres au lieu de texte.

6. Dans la vue des miniatures, cliquez sur la miniature de la première page en texte intégral du document pour ouvrir la première page avec du contenu réel.

   

   Smart Document Understanding*

7. Pour annoter le document, cliquez sur le libellé subtitle dans la liste Etiquettes de champ. Cliquez ensuite sur chaque bloc dans la représentation de la page PDF qui représente un en-tête pour modifier son libellé de text en subtitle.

   

   sous-titre*

8. Une fois que chaque sous-titre de la page en cours est libellé, cliquez sur Soumettre la page.

   La page suivante du fichier PDF s'affiche.

   

9. Répétez ce processus jusqu'à ce que l'outil puisse correctement étiqueter les en-têtes pour vous de manière cohérente lorsque de nouvelles pages sont chargées dans l'outil. A ce stade, cliquez sur Appliquer les modifications et retraiter.

   Félicitations ! Vous avez entraîné avec succès un modèle SDU (Smart Document Understanding) qui peut reconnaître des sous-titres dans vos documents. Appliquons le même modèle à l'autre fichier PDF que vous avez ajouté au projet.

10. Dans la barre d'outils de l'éditeur SDU, cliquez sur l'icône du menu déroulant dynamique dans l'en-tête de page, puis sélectionnez Exporter le modèle.

11. Sauvegardez le fichier .sdumodel sur votre système dans un emplacement où vous pourrez y accéder à nouveau rapidement.

12. Dans le panneau de navigation, cliquez sur Manage collections, puis ouvrez la collection Discovery docs part 2.

13. Ouvrez l'onglet Identifier les champs.

14. Cliquez sur Modèles entraînés par l'utilisateur, puis sur Soumettre.

15. Cliquez sur Apply changes and reprocess.

16. Dans la barre d'outils de l'éditeur SDU, cliquez sur l'icône de menu déroulant dynamique , puis choisissez Importer le modèle, puis cliquez sur Sélectionner le modèle.

17. Recherchez le fichier .sdumodel que vous avez téléchargé précédemment, puis cliquez sur Ouvrir.

18. Cliquez sur Appliquer les modifications et retraiter pour appliquer le même modèle SDU à la première collection.

Discovery retraite les données dans son index pour identifier les sous-titres dans les documents. Pendant que les données sont en cours de retraitement, créons notre générateur de réponses.

Créer une instance de service NeuralSeek

Vous pouvez utiliser une extension de recherche dans watsonx Assistant pour connecter votre assistant directement à Discovery et renvoyer des passages directement à partir de la source de données. Toutefois, nous allons ajouter le service NeuralSeek entre watsonx Assistant et Discovery dans ce tutoriel. NeuralSeek extrait les passages de Discovery, puis les convertit en réponses qui semblent plus conversationnelles.

1. A partir d'un nouvel onglet de navigateur Web, revenez au catalogue IBM Cloud.

   Conservez les pages des autres services ouvertes dans des onglets distincts afin de pouvoir basculer entre les différentes instances de service.

2. Dans la page de ressources NeuralSeek du catalogue IBM Cloud, créez une instance de service de plan Lite.

3. Sur la page Configurer, ajoutez des détails sur votre instance de service Discovery et personnalisez la connexion.

   • Vous pouvez obtenir l' URL service et la clé API à partir de la page de détails de l'instance de service Discovery dans IBM Cloud
   • L'ID de projet est disponible à partir de l'interface utilisateur IBM Cloud. Pour l'obtenir, cliquez sur Intégrer et déployer dans le panneau de navigation. Ouvrez la page Informations sur l'API, puis copiez l'ID de projet.
   • Définissez la plage de scores du document à 50%.
   • Remplacez la taille du caractère de fragment par 400.
   • Indiquez votre société comme nom d'affichage de la société.
   • Remplacez le pourcentage de confiance minimum par 50.

   Cliquez sur Sauvegarder.

Fractionner vos documents PDF

Maintenant que les sous-titres sont correctement indexés dans Discovery, utilisez-les comme base pour fractionner les fichiers PDF en plusieurs documents plus petits.

1. Revenez à l'onglet du navigateur Web dans lequel votre projet Discovery est affiché.

2. Ouvrez l'onglet Manage fields pour la collection en cours.

3. Dans Fractionner le document sur chaque occurrence de la zone, choisissez sous-titre, puis cliquez sur Appliquer les modifications et retraiter.

   

4. Dans le panneau de navigation, cliquez sur Manage collections, puis ouvrez l'autre collection.

5. Accédez à la page Gérer les champs, puis sélectionnez sous-titre dans le champ Fractionner le document sur chaque occurrence du champ.

6. Cliquez sur Apply changes and reprocess.

Les collections commencent à être traitées à nouveau. Une fois la réindexation terminée, au lieu de contenir un document chacun, les collections contiennent plusieurs centaines de documents chacun.

Pendant que l'index est en cours de reconstruction, préparons notre assistant.

Ajouter une extension à votre assistant

Connectez votre assistant à votre instance de service NeuralSeek.

1. Rouvrez le service NeuralSeek à partir de IBM Cloud. L'instance se trouve dans la section AI and Machine Learning de votre liste de ressources.

2. Cliquez sur l'onglet Intégrer et suivez les instructions pour configurer l'extension personnalisée NeuralSeek pour votre assistant. Revenez à cette procédure lorsque vous êtes prêt à créer l'action.

   

   l'instance NeuralSeek

3. Dans le panneau de navigation watsonx Assistant, cliquez sur Actions, puis sur Nouvelle action.

4. Choisissez Démarrage rapide à partir de modèles, puis faites défiler la page pour rechercher et cliquer sur le kit de démarrageNeuralSeek.

   

5. Cliquez sur Sélectionner ce kit de démarrage, puis sur Ajouter des modèles.

6. Cliquez pour ouvrir l'action NeuralSeek search que vous venez d'ajouter à l'assistant.

7. Ajoutez les exemples de requête utilisateur suivants à la première étape de l'action:

   What Watson Discovery project types are available and what do they do?
   

   What external data sources are supported by Watson Discovery?
   

   Can I add a custom dictionary to Watson Discovery?
   

   How do I use the Content Mining application?
   

   When should I add query expansions to my project?
   

   Which file types support Smart Document Understanding models?
   

   Can I enable optical character recognition for all file types?
   

   Does my data have to be written in English?
   

   watsonx Assistant utilise les exemples de questions pour reconnaître les types de questions utilisateur qu'il doit acheminer vers cette action.

8. Cliquez pour ouvrir l'étape 3 pour l'éditer.

   Dans la section Et puis, cliquez sur Editer l'extension.

   Choisissez NeuralSeek, puis cliquez sur Appliquer.

   

9. Cliquez pour ouvrir l'étape 6 pour l'éditer.

   Cette étape affiche un lien sur lequel les utilisateurs peuvent cliquer pour obtenir plus d'informations. Nous voulons que ce lien soit directement accessible à la documentation du produit sur le site IBM Cloud Docs.

   Modifiez la référence hypertexte dans l'élément HTML anchor pour qu'elle contienne l' URL suivante :

   <a href="https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-about" target="_blank">
   

   : caption="Change the URL for the More information link" caption-side="bottom"}

10. Sauvegardez vos modifications, puis cliquez sur le X pour fermer l'étape.

Félicitations ! Vous avez créé une action qui reconnaît les questions relatives à Discoveryet obtient ses réponses de l'extension NeuralSeek connectée.

Configurez la discussion Web pour votre assistant

Pour prévisualiser votre assistant, vous utiliserez la discussion Web intégrée comme interface utilisateur de discussion pour interagir avec l'assistant.

1. Dans le panneau de navigation de watsonx Assistant, cliquez sur Environnements.

   L'environnement brouillon s'affiche. Il indique qu'une discussion Web est connectée à votre assistant. Vous pouvez également voir que la discussion Web est connectée à l'extension NeuralSeek.

   

2. Cliquez sur la vignette Discussion Web pour éditer la discussion Web.

   Nous ne voulons pas ajouter plusieurs questions de démarrage, nous allons donc désactiver l'écran d'accueil pour la discussion Web. Cliquez sur l'onglet Écran d'accueil. Définissez le commutateur sur Off, puis cliquez sur Save and exit.

   

Vous êtes prêt à prévisualiser votre assistant !

Aperçu de l'assistant

Pour prévisualiser un assistant qui se connecte aux données stockées dans Discovery, vous devez prévisualiser l'assistant à partir de la page Environnements. Lorsque vous prévisualisez la discussion Web indépendamment, l'assistant ne peut pas extraire les données de Discovery; il a besoin des ressources d'environnement pour pouvoir se connecter à Discovery.

1. Dans la page Environnements, cliquez sur Aperçu de cet environnement.

   Un exemple de page Web s'affiche avec une icône de discussion .

2. Cliquez sur l'icône de chat pour ouvrir la fenêtre de chat en ligne.

   

3. Entrez la question texte suivante:

   What project types are available?
   

   La réponse correcte est renvoyée et inclut un lien vers la documentation du produit.

   {: caption="la question du testLe chat en ligne renvoie la " caption-side="bottom"} de la recherche

4. Soumettez une question qui n'a pas été utilisée comme exemple de requête lorsque vous avez créé l'action.

   How do you define synonyms in Watson Discovery?
   

   Une réponse détaillée est renvoyée.

   

5. Posez éventuellement d'autres questions à l'assistant.

   Si l'assistant ne connaît pas la réponse, redéfinissez la question pour inclure " dans Watson Discoveryafin de préciser que vous demandez comment quelque chose fonctionne dans Discovery spécifiquement.

Félicitations ! Vous avez créé un assistant qui peut répondre aux questions sur Discovery en extrayant des informations de la documentation du produit via le service NeuralSeek.