Versions et environnements

Vous pouvez créer plusieurs versions de vos flux d'agent et les déployer dans des environnements de diffusion distincts.

Lorsque vous modifiez un flux, vous modifiez un flux brouillon. Vous pouvez à tout moment enregistrer un flux brouillon en tant que version de flux. Une version de flux est un instantané immuable de vos données de flux et des données de l'agent associées telles que des intents, des entités, des webhooks, des pages, des groupes de routes, etc.

Lorsque vous enregistrez un flux brouillon, il est déployé dans l'environnement par défaut. Lorsque vous créez des versions de flux spécifiques, vous pouvez les déployer dans des environnements personnalisés. Vous pouvez créer différents environnements personnalisés aux fins suivantes :

  • test
  • développement
  • production
  • etc.

Charger une version de flux dans un brouillon

Vous pouvez à tout moment charger une version de flux dans un brouillon, de sorte qu'elle soit modifiable et utilisée par l'environnement par défaut.

Le chargement d'une version de flux dans un brouillon peut mettre à jour plusieurs ressources dans un agent, y compris les ressources au niveau de l'agent, telles que les intents et les entités. Lorsque vous chargez une version dans un brouillon avec la console ou l'API, vous pouvez choisir d'écraser ou non les ressources au niveau de l'agent.

Gérer les versions de flux

Pour gérer vos versions de flux, procédez comme suit :

Console

Pour répertorier les versions actuelles d'un flux, procédez comme suit :

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet GCP.
  3. Sélectionnez votre agent.
  4. Cliquez sur Agent Settings (Paramètres de l'agent).
  5. Cliquez sur l'onglet Version.
  6. Les flux d'agent sont répertoriés. Sélectionnez-en un.
  7. Les versions sont répertoriées pour le flux sélectionné.

Les informations suivantes s'affichent pour chaque flux :

  • Version : nom de la version.
  • Type NLU : type NLU pour la version de flux.
  • Version créée : date et heure de création de la version.
  • État : état de l'entraînement. Une version de flux n'est pas prête à être utilisée tant que l'état n'est pas marqué comme Prêt.

Pour créer une version de flux, cliquez sur le bouton Ajouter une version et fournissez les informations.

Pour charger une version de flux spécifique en tant que flux brouillon, cliquez sur le bouton de chargement situé à droite d'une version dans la liste. Une option permet d'écraser les données au niveau de l'agent lors du chargement.

Pour supprimer une version de flux spécifique, cliquez sur le bouton de suppression situé à droite d'une version dans la liste.

API

Consultez les méthodes pour la .

Sélectionnez un protocole et une version pour la référence de version :

Protocole V3beta1
REST Ressource de version
RPC Interface de version

Gérer les environnements

Pour gérer vos environnements d'agent, procédez comme suit :

Console

Pour répertorier les environnements actuels pour un agent, procédez comme suit :

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet GCP.
  3. Sélectionnez votre agent.
  4. Cliquez sur Agent Settings (Paramètres de l'agent).
  5. Cliquez sur l'onglet Environnement.
  6. Les environnements d'agent sont répertoriés.

Pour créer un nouvel environnement, cliquez sur le bouton Ajouter un environnement et fournissez les informations.

Pour sélectionner des versions de flux et configurer un environnement, cliquez sur un environnement et fournissez les informations.

Pour afficher l'historique des modifications d'un environnement, cliquez sur le bouton d'historique situé à droite d'un environnement dans la liste.

Pour copier un nom de ressource d'environnement incluant l'ID d'environnement, cliquez sur le bouton de copie situé à droite d'un environnement dans la liste.

Pour supprimer un environnement, cliquez sur le bouton de suppression situé à droite d'un environnement dans la liste.

API

Consultez les méthodes pour la .

Sélectionnez un protocole et une version pour la référence de l'environnement :

Protocole V3beta1
REST Ressource de l'environnement
RPC Interface de l'environnement

Spécifier un environnement pour les appels de session d'exécution

Vous pouvez spécifier un environnement pour les appels de session d'exécution, tels que detectIntent, streamingDetectIntent, matchIntent, et les appels d'entités de session. Pour spécifier un environnement, modifiez l'URL du point de terminaison en insérant environments/environment-id entre les paramètres de chemin d'accès agent et sessions.

Par exemple, le point de terminaison suivant utilise l'ID d'environnement 6db409d7-57ac-41d7-83bd-89b8768e2745 :

https://dialogflow.googleapis.com/v3beta1/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

Si aucun environnement n'est spécifié, l'environnement par défaut est utilisé.