Configuration et nettoyage de Dialogflow ES

Ce guide décrit toutes les étapes de configuration nécessaires pour commencer à utiliser Dialogflow. Il fournit également des conseils pour les étapes de nettoyage possibles après avoir testé Dialogflow.

Avant de commencer

Avant de lire ce guide, procédez comme suit :

1. Consultez les principes de base de Dialogflow ES.
2. Consultez la page Éditions.

À propos de la console Google Cloud

La console Google Cloud (accéder à la documentation, ouvrir la console) est une interface utilisateur Web permettant de provisionner, configurer, gérer et surveiller les systèmes qui utilisent des produits Google Cloud . La console Google Cloud permet de configurer et de gérer les ressources Dialogflow.

Créer un projet

Pour utiliser les services fournis par Google Cloud, vous devez créer un projet. Un projet permet d'organiser toutes vos ressources Google Cloud . Il se compose d'un ensemble de collaborateurs, d'API activées (et d'autres ressources), d'outils de surveillance, d'informations de facturation, et de contrôles d'authentification et d'accès. Vous pouvez créer un projet, ou en créer plusieurs et les utiliser pour organiser vos ressources Google Cloud dans une hiérarchie des ressources. Lorsque vous créez un projet, notez l'ID du projet. Vous en aurez besoin pour effectuer des appels d'API. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.

Si vous le souhaitez, la console Dialogflow ES (consulter la documentation, ouvrir la console) vous permet de créer un projet de base lorsque vous créez un agent. Si vous prévoyez d'utiliser votre projet pour des opérations autres qu'un simple accès de base à une édition sans frais ou si vous envisagez d'utiliser l'API, vous devez créer un projet avec la console Google Cloud comme décrit ci-dessous.

Nous vous recommandons de créer des projets distincts pour les essais, les tests et la production. Chaque projet ne peut créer qu'un seul agent Dialogflow. Si vous avez besoin de plusieurs agents, vous devrez créer plusieurs projets.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Avertissement : Si un projet est supprimé, les agents associés au projet ne peuvent pas être récupérés.

Activer la facturation

Remarque : Vous pouvez ignorer cette étape si vous utilisez une édition Dialogflow disponible sans frais.

Un compte de facturation sert à déterminer qui assume les frais pour un ensemble de ressources donné. Il peut être associé à un ou plusieurs projets. Les frais d'utilisation du projet sont imputés au compte de facturation associé. Dans la plupart des cas, vous configurez la facturation lorsque vous créez un projet. Pour en savoir plus, consultez la documentation concernant la facturation.

Verify that billing is enabled for your Google Cloud project.

Activer l'API

Remarque : Vous pouvez ignorer cette étape si vous utilisez la console Dialogflow pour créer votre projet.

Vous devez activer l'API Dialogflow pour votre projet. Pour en savoir plus sur l'activation des API, consultez la documentation concernant Service Usage.

Enable the Dialogflow API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Activer les journaux d'audit

Remarque : Vous pouvez ignorer cette étape pour les agents hors production.

Activez les journaux d'audit pour l'accès aux données dans l'API Dialogflow dans votre projet. Cela peut vous aider à suivre les modifications apportées lors de la conception aux agents Dialogflow associés à ce projet.

Installer et initialiser la Google Cloud CLI

Remarque : Vous pouvez ignorer cette étape si vous ne comptez pas utiliser l'API.

Si vous prévoyez d'utiliser l'API Dialogflow, vous devez installer et initialiser Google Cloud CLI. La gcloud CLI est un ensemble d'outils qui vous permet de gérer les ressources et les applications hébergées sur Google Cloud.

Le lien suivant fournit les instructions correspondantes :

Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

gcloud init

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Configurer l'authentification et le contrôle des accès

Remarque : Vous pouvez ignorer cette étape si vous ne comptez pas utiliser l'API.

Si vous comptez utiliser l'API Dialogflow, vous devez configurer l'authentification. Toute application cliente qui utilise l'API doit être authentifiée et se voir accorder l'accès aux ressources demandées. Cette section décrit des concepts importants concernant l'authentification et vous indique la procédure à suivre pour la configurer. Pour en savoir plus, consultez la Présentation de l'authentificationGoogle Cloud .

Authentification avec des comptes utilisateur

Les comptes utilisateur sont la meilleure option d'authentification pour découvrir l'API Dialogflow et pour le développement local. Vous pouvez utiliser votre compte utilisateur afin de vous authentifier pour les exécutions de ligne de commande REST ou les appels de bibliothèque cliente.

Authentification de compte utilisateur pour la ligne de commande REST

Remarque : Si vous utilisez Cloud Shell, vous êtes automatiquement connecté à gcloud et n'avez pas besoin d'exécuter la commande gcloud auth login.

Pour vous authentifier pour les appels de ligne de commande REST, vous utilisez la gcloud CLI. La commande gcloud auth login vous connecte à gcloud avec votre compte utilisateur. Vous devez effectuer cette opération avant d'appeler l'API. La commande gcloud auth print-access-token est utilisée dans tous les exemples de ligne de commande REST de cette documentation pour authentifier les appels REST.

Pour créer des identifiants utilisateur pour votre environnement local :

gcloud auth login

Authentification de compte utilisateur pour une bibliothèque cliente

Pour vous authentifier pour les appels de bibliothèque cliente, vous utilisez la gcloud CLI. La commande gcloud auth application-default login vous connecte à gcloud pour les identifiants par défaut de l'application avec votre compte utilisateur. Vous devez effectuer cette opération avant d'appeler l'API. La commande gcloud auth application-default set-quota-project doit être utilisée pour définir votre projet pour la facturation et les quotas liés aux appels d'API. En principe, il s'agit du projet utilisé par l'agent, et vous fournissez l'ID du projet que vous avez créé lors des étapes précédentes.

La variable d'environnement GOOGLE_APPLICATION_CREDENTIALS ne doit pas être définie, afin que les identifiants par défaut de votre application soient utilisés par les bibliothèques clientes.

Pour créer des identifiants par défaut pour l'application pour votre environnement local :

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Authentication avec des comptes de service

Les comptes de service fournissent des identifiants pour les applications, et non pour les utilisateurs finaux. Les comptes de service appartiennent à des projets. Vous pouvez créer plusieurs comptes de service par projet. Pour en savoir plus, consultez ces pages :

• Présentation des comptes de service
• Bonnes pratiques relatives aux comptes de service
• Créer et gérer des comptes de service

Contrôle des accès avec des rôles

Lorsqu'un compte principal (compte utilisateur, compte de service, etc.) appelle une API, Google Cloud exige que celui-ci dispose des autorisations appropriées. Vous pouvez accorder des autorisations en attribuant des rôles à un compte principal. Pour en savoir plus, consultez la présentation des rôles.

Si vous avez créé votre projet avec votre compte utilisateur, ce dernier dispose du rôle de base Propriétaire pour le projet. Ce rôle permet d'appeler n'importe quelle API pour le projet. En revanche, si c'est un autre compte qui a créé le projet, il sera peut-être nécessaire que des rôles soient attribués à votre compte utilisateur pour que vous puissiez appeler l'API. Pour obtenir des instructions, consultez le guide du contrôle des accès Dialogflow.

Installer la bibliothèque cliente Dialogflow

Remarque : Vous pouvez ignorer cette étape si vous ne comptez pas utiliser l'API.

Vous disposez des trois options suivantes pour appeler l'API : les bibliothèques clientes compatibles avec Google, REST et gRPC.

Les bibliothèques clientes sont disponibles dans plusieurs langages courants. Pour obtenir des instructions d'installation, consultez la page Bibliothèques clientes pour le langage de votre choix.

Nettoyage

Après avoir configuré et testé ou testé Dialogflow, vous pouvez supprimer les ressources que vous avez créées :

• Il est conseillé de supprimer votre agent.
• Vous pouvez arrêter votre projet.
• Si vous avez appelé gcloud auth login, les identifiants sont stockés dans le répertoire utilisateur de votre ordinateur. Vous pouvez supprimer ces identifiants en appelant la commande suivante :

  gcloud auth revoke

• Si vous avez appelé gcloud auth application-default login, les identifiants sont stockés dans le répertoire utilisateur de votre ordinateur. Vous pouvez supprimer ces identifiants en appelant la commande suivante :

  gcloud auth application-default revoke