Versions et environnements

Vous pouvez créer plusieurs versions de votre agent et les publier dans des environnements distincts.

Lorsque vous modifiez un agent, vous modifiez le brouillon d'agent. À tout moment, vous pouvez enregistrer le brouillon d'agent en tant que version de l'agent, qui est un instantané immuable de votre agent.

Lorsque vous enregistrez le brouillon d'agent, il est publié dans l'environnement par défaut. Lorsque vous créez des versions de l'agent, vous pouvez les publier dans des environnements personnalisés. Vous pouvez créer différents environnements personnalisés aux fins suivantes :

  • test
  • développement
  • production
  • etc.

Trafic de production

Toujours utiliser les versions de l'agent pour le trafic de production

Un brouillon d'agent est mis à jour chaque fois qu'un développeur de votre équipe effectue des modifications. Un brouillon d'agent peut facilement être mis hors service involontairement, en particulier si plusieurs personnes disposent d'un accès en écriture à l'agent. En outre, un brouillon d'agent récemment modifié peut être incohérent avec le modèle entraîné, car l'entraînement peut avoir du retard ou nécessiter une exécution manuelle.

Vous devez toujours utiliser des versions d'agent pour votre trafic de production. Les brouillons d'agents doivent être testés avant d'être promus et passés en production. Vous pouvez effectuer un rollback vers une version précédente si des problèmes sont détectés.

Examiner les erreurs possibles de l'agent lors du changement de version

Si vous modifiez une version d'agent dans votre environnement de production lorsque les sessions sont actives, cela peut entraîner des erreurs d'agent pour certaines sessions actives. Ces erreurs peuvent se produire si les versions précédente et nouvelle ne sont pas cohérents les uns avec les autres ; d'une manière qui perturbe l'état de session. C'est pourquoi vous devez prévoir de changer de version pendant les heures d'arrêt ou creuses.

Publier une version dans un nouvel environnement

Pour publier un brouillon d'agent dans une version et créer un environnement personnalisé, procédez comme suit :

Console

  1. Accédez à la console Dialogflow ES.
  2. Sélectionnez votre agent dans la partie supérieure du menu de la barre latérale gauche.
  3. Cliquez sur le bouton des paramètres à côté du nom de l'agent.
  4. Cliquez sur l'onglet Environnements.
  5. Cliquez sur Publier une version.
  6. Ajoutez une description facultative et cliquez sur Suivant.
  7. Sélectionnez + Nouvel environnement.

  8. Saisissez un nom d'environnement.

  9. Choisissez la méthode de fulfillment pour l'environnement.

  10. Sélectionnez les paramètres de synthèse vocale pour l'environnement.

  11. Cliquez sur Publier.

  12. Les informations sur l'environnement sont désormais répertoriées dans la section Environnements personnalisés.

API

  1. Appelez la méthode create du type de version pour créer une nouvelle version de l'agent.
  2. Appelez la méthode create du type d'environnement pour créer un environnement. Indiquez la version de l'agent que vous venez de créer dans le champ agentVersion.

Rétablir la version précédente d'un environnement

Vous pouvez rétablir la version d'agent précédente d'un environnement en procédant comme suit :

Console

  1. Cliquez sur un environnement dans la section Environnements personnalisés.
  2. La boîte de dialogue des paramètres de l'environnement s'ouvre.
  3. Cliquez sur le bouton d'option d'une version publiée précédemment dans la section Historique de publication.
  4. Cliquez sur Rétablir cette version.
  5. L'historique de publication sera mis à jour.

API

Appelez la méthode patch/update du type d'environnement pour mettre à jour un environnement. Indiquez la version de l'agent précédemment créée dans le champ agentVersion.

Charger une version précédente dans un brouillon

Le chargement d'une version précédente du brouillon remplace le brouillon d'agent dans l'environnement par défaut par la version d'agent sélectionnée.

Pour charger une version précédente du brouillon, procédez comme suit :

Console

  1. Accédez à la console Dialogflow ES.
  2. Sélectionnez votre agent dans la partie supérieure du menu de la barre latérale gauche.
  3. Cliquez sur le bouton des paramètres à côté du nom de l'agent.
  4. Cliquez sur l'onglet Environnements.
  5. Cliquez sur Afficher toutes les versions dans la section Brouillon.
  6. Cliquez sur le bouton d'option de la version que vous souhaitez charger dans un brouillon.
  7. Cliquez sur Charger dans le brouillon.
  8. Cliquez sur Oui, je suis sûr.
  9. Actualisez tous les onglets du navigateur de la console pour afficher les dernières données de l'agent.

API

Appelez la méthode patch/update pour le type d'environnement avec les entrées suivantes :

  • Utilisez - comme ID d'environnement pour spécifier l'environnement par défaut.
  • Définissez allowLoadToDraftAndDiscardChanges sur "true".
  • Pour le champ agentVersion, indiquez la version de l'agent qui écrasera le brouillon d'agent.

Exporter une version

Pour exporter une version, vous devez d'abord la charger dans un brouillon, puis l'exporter.

Tester l'agent dans un environnement

Vous pouvez utiliser l'API pour tester votre agent dans n'importe lequel de vos environnements personnalisés. Appelez la méthode de détection d'intent, mais modifiez l'URL du point de terminaison en insérant environments/environment-name/users/-/ entre agent et sessions.

Par exemple, le point de terminaison suivant utilise l'environnement de "développement" avec un utilisateur non spécifié :

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

Paramètres spécifiques à l'environnement

Le fulfillment et la synthèse vocale sont configurés par l'environnement. L'agent utilise donc les paramètres de l'environnement pour ces fonctionnalités.

Pour en savoir plus sur l'application des données à différents niveaux, consultez niveaux d'application de l'agent.

Assistant Google

Si vous utilisez les environnements de version Actions on Google, consultez les limites de gestion des versions pour la bibliothèque de fulfillment Dialogflow.

Méga-agent

Découvrez le fonctionnement des versions et des environnements dans les méga-agents.

Limites

Les limites suivantes s'appliquent :

  • Nombre maximal d'environnements par agent : 10
  • Nombre maximal de versions par agent : 1000