API Cloud Natural Language : Qwik Start

40 minutes 1 crédit

GSP097

Google Cloud – Ateliers adaptés au rythme de chacun

Présentation

L'API Cloud Natural Language vous permet d'extraire des informations sur des personnes, des lieux, des événements et bien d'autres éléments mentionnés dans des documents texte, articles de presse ou articles de blog. Avec cette API, vous pouvez apprécier le sentiment général qui se dégage sur les réseaux sociaux à propos de vos produits, ou analyser les intentions exprimées dans des conversations avec les clients, qu'elles se tiennent dans un centre d'appels ou dans une application de messagerie. Vous pouvez même importer des documents texte à analyser.

Fonctionnalités de l'API Cloud Natural Language

Analyse de syntaxe : extrayez des marqueurs et des phrases, identifiez des éléments de discours, et créez des arborescences d'analyse de dépendances pour chaque phrase.

Reconnaissance d'entités : identifiez des entités et créez des libellés par type, comme des personnes, des organisations, des lieux, des événements, des produits ou des médias.

Analyse des sentiments : interprétez le sentiment global exprimé dans un bloc de texte.

Classification de contenu : classez des documents dans plus de 700 catégories prédéfinies.

Analyse multilingue : analysez facilement des textes dans plusieurs langues telles que l'allemand, l'anglais, le chinois (simplifié et traditionnel), le coréen, l'espagnol, le français, l'italien, le japonais et le portugais.

API REST intégrée : accédez à cette solution via l'API REST. Importez le texte dans la requête, ou intégrez-le dans Cloud Storage.

Dans cet atelier, vous allez utiliser la méthode analyze-entities pour demander à l'API Cloud Natural Language d'extraire des "entités" (comme des personnes, des lieux et des événements) d'un extrait de texte.

Avant de commencer l'atelier

Avant de cliquer sur le bouton Start Lab (Démarrer l'atelier)

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Start Lab (Démarrer l'atelier), indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique Qwiklabs vous permet de suivre vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Conditions requises

Pour réaliser cet atelier, vous devez :

avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;
disposer de suffisamment de temps pour réaliser l'atelier en une fois.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier.

Remarque : Si vous utilisez un appareil Chrome OS, exécutez cet atelier dans une fenêtre de navigation privée.

Démarrer l'atelier et se connecter à la console Google Cloud

Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau Détails concernant l'atelier, qui contient les éléments suivants :
- Le bouton Ouvrir la console Google
- Le temps restant
- Les identifiants temporaires que vous devez utiliser pour cet atelier
- Des informations complémentaires vous permettant d'effectuer l'atelier
Cliquez sur Ouvrir la console Google. L'atelier lance les ressources, puis ouvre la page Se connecter dans un nouvel onglet.

Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.
Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.
Si nécessaire, copiez le nom d'utilisateur inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue Se connecter. Cliquez sur Suivant.
Copiez le mot de passe inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue de bienvenue. Cliquez sur Suivant.
Important : Vous devez utiliser les identifiants fournis dans le panneau de gauche. Ne saisissez pas vos identifiants Google Cloud Skills Boost. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.
Accédez aux pages suivantes :
- Acceptez les conditions d'utilisation.
- N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
- Ne vous inscrivez pas aux essais offerts.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Vous pouvez afficher le menu qui contient la liste des produits et services Google Cloud en cliquant sur le menu de navigation en haut à gauche. Icône du menu de navigation

Activer Google Cloud Shell

Google Cloud Shell est une machine virtuelle qui contient des outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Google Cloud Shell offre un accès en ligne de commande à vos ressources GCP.

Dans la console GCP, dans la barre d'outils située en haut à droite, cliquez sur le bouton Ouvrir Cloud Shell.
Cliquez sur Continue (Continuez):

Il faut quelques instants pour mettre en service et se connecter à l'environnement. Lorsque vous êtes connecté, vous êtes déjà authentifié et le projet est défini sur votre PROJECT_ID. Par exemple:

Terminal Cloud Shell

gcloud est l'outil de ligne de commande associé à Google Cloud Platform. Pré-installé sur Cloud Shell, il est également compatible avec la saisie semi-automatique via la touche de tabulation.

Vous pouvez répertorier les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

Résultat :

ACTIVE: *
ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net
To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Pour répertorier les ID de projet, exécutez la commande suivante :

gcloud config list project

Résultat :

[core]
project = <ID_Projet>

Exemple de résultat :

[core]
project = qwiklabs-gcp-44776a13dea667a6

Créer une clé API

Vous allez commencer par configurer une variable d'environnement avec votre ID_PROJET que vous utiliserez tout au long de cet atelier de programmation :

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value core/project)

Ensuite, créez un compte de service pour accéder à l'API Natural Language :

gcloud iam service-accounts create my-natlang-sa \ --display-name "my natural language service account"

Puis, créez des identifiants pour vous connecter avec ce nouveau compte de service, et enregistrez-les dans un fichier JSON "~/key.json" à l'aide de la commande suivante :

gcloud iam service-accounts keys create ~/key.json \ --iam-account my-natlang-sa@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com

Pour finir, définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS sur le chemin d'accès complet du fichier JSON des identifiants que vous avez créé, disponible dans le résultat de la commande précédente :

export GOOGLE_APPLICATION_CREDENTIALS="/home/USER/key.json"

Créer une clé API

Envoyer une requête d'analyse d'entité

Pour poursuivre, connectez-vous à l'instance configurée pour vous via SSH. Ouvrez le menu de navigation, puis sélectionnez Compute Engine. L'instance linux provisionnée suivante doit s'afficher :

Cliquez sur le bouton SSH. Vous êtes redirigé vers une interface système interactive. Restez dans cette session SSH jusqu'à la fin de l'atelier.

Essayez l'analyse d'entité de l'API Natural Language avec la phrase suivante :

Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'

Exécutez la commande gcloud suivante :

gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'." > result.json

Envoyer une requête d'analyse d'entité

Exécutez la commande suivante pour prévisualiser le résultat du fichier result.json.

cat result.json

Une réponse semblable à ce qui suit doit s'afficher dans le fichier result.json :

{ "entities": [ { "name": "Michelangelo Caravaggio", "type": "PERSON", "metadata": { "wikipedia_url": "http://en.wikipedia.org/wiki/Caravaggio", "mid": "/m/020bg" }, "salience": 0.83047235, "mentions": [ { "text": { "content": "Michelangelo Caravaggio", "beginOffset": 0 }, "type": "PROPER" }, { "text": { "content": "painter", "beginOffset": 33 }, "type": "COMMON" } ] }, { "name": "Italian", "type": "LOCATION", "metadata": { "mid": "/m/03rjj", "wikipedia_url": "http://en.wikipedia.org/wiki/Italy" }, "salience": 0.13870546, "mentions": [ { "text": { "content": "Italian", "beginOffset": 25 }, "type": "PROPER" } ] }, { "name": "The Calling of Saint Matthew", "type": "EVENT", "metadata": { "mid": "/m/085_p7", "wikipedia_url": "http://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)" }, "salience": 0.030822212, "mentions": [ { "text": { "content": "The Calling of Saint Matthew", "beginOffset": 69 }, "type": "PROPER" } ] } ], "language": "en" }

Examinez les résultats. Chaque "entité" de la réponse est associée aux informations suivantes :

name et type : une personne, un lieu, un événement, etc. ;
metadata : une URL Wikipédia associée (s'il en existe une) ;
salience : la saillance et les index des endroits où cette entité apparaît dans le texte (la saillance est un chiffre compris dans la plage [0,1] et se rapportant à la centralité de l'entité par rapport au texte dans son ensemble) ;
mentions : il s'agit de la même entité mentionnée différemment.

Vous avez envoyé votre première requête à l'API Cloud Natural Language.

Félicitations !

Terminer votre quête

Continuez sur votre lancée avec les quêtes Qwiklabs Baseline: Data, ML, AI ou Intro to ML: Language Processing. Une quête est une série d'ateliers associés qui constituent une formation. Si vous terminez cette quête, vous obtiendrez le badge ci-dessus attestant de votre réussite. Vous pouvez rendre publics les badges que vous recevez et ajouter leur lien dans votre CV en ligne ou sur vos comptes de réseaux sociaux. Inscrivez-vous à l'une des quêtes ci-dessus pour obtenir immédiatement les crédits associés à cet atelier si vous l'avez suivi. Découvrez les autres quêtes Qwiklabs disponibles.

Étapes suivantes et informations supplémentaires

Cet atelier fait partie d'une série appelée "Qwik Starts". Les ateliers de cette série sont conçus pour vous donner un aperçu des nombreuses fonctionnalités proposées par Google Cloud. Pour suivre un autre atelier, recherchez "Qwik Starts" dans le catalogue.

Google Cloud Training & Certification

...helps you make the most of Google Cloud technologies. Our classes include technical skills and best practices to help you get up to speed quickly and continue your learning journey. We offer fundamental to advanced level training, with on-demand, live, and virtual options to suit your busy schedule. Certifications help you validate and prove your skill and expertise in Google Cloud technologies.

Dernière mise à jour du manuel : 2 juin 2021

Dernier test de l'atelier : 2 juin 2021

Copyright 2020 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.