Versions et environnements

Vous pouvez créer plusieurs versions de vos flux d'agents et de vos playbooks (également appelés agents Vertex AI). et les déployer dans des environnements de diffusion distincts.

Lorsque vous modifiez un flux ou un playbook, vous modifiez le brouillon. Vous pouvez à tout moment enregistrer le brouillon en tant que version. Une version est un instantané immuable de vos données de flux ou de playbook, ainsi que des données de l'agent associées. Pour les flux, cela inclut les intents, les entités, les webhooks, les pages et les groupes de routes. Pour les playbooks, cela n'inclut que des exemples.

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

  • test
  • développement
  • production

De plus, vous pouvez créer webhooks spécifiques à l'environnement, afin d'isoler votre environnement de production des environnements de développement et de test.

Bonnes pratiques concernant le trafic de production

Toujours utiliser des versions pour le trafic de production

Un brouillon est mis à jour chaque fois qu'un développeur de votre équipe effectue des modifications. Il est possible de casser un brouillon involontairement, en particulier si plusieurs personnes disposent d'un accès en écriture à l'agent. De plus, un brouillon récemment modifié peuvent ne pas être cohérentes avec le modèle entraîné, car l'entraînement peut être retardé ou nécessiter une exécution manuelle.

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

Toujours utiliser des webhooks spécifiques à l'environnement

Lorsque vous modifiez votre agent, vous devez souvent modifier de manière interdépendante le code de votre webhook. Pendant le développement et le test de ces modifications, vous souhaitez obtenir ce qui suit:

  • Tester les mises à jour de l'agent par rapport aux mises à jour du code du webhook.
  • Pour éviter de déployer votre code de webhook en production avant d'avoir terminé les tests.

En utilisant webhooks spécifiques à l'environnement permet d'atteindre ces deux objectifs.

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

Si vous modifiez une version 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.

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. Cette fonctionnalité n'est pas encore disponible pour les playbooks.

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

Pour gérer vos versions:

Console

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

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Cliquez sur l'onglet Ressources partagées.
  5. Cliquez sur Versions.
  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é.

Pour répertorier les versions actuelles d'un playbook :

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionner le playbook
  5. Cliquez sur Historique des versions.
  6. Cliquez sur Afficher l'historique des versions.
  7. Les versions sont listées pour le playbook sélectionné.

Les informations suivantes s'affichent pour chaque ressource :

  • Nom à afficher : nom à afficher pour la version.
  • ID de version : ID de la version.
  • Type NLU : type NLU pour la version de flux.
  • Horodatage de création : 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, cliquez sur le bouton Créer et indiquez le nom à afficher et la description de la version.

Pour charger une version de flux spécifique en tant que brouillon de flux, procédez comme suit :

  1. Pointez sur une ligne de version.
  2. Cliquez sur le bouton d'option .
  3. Cliquez sur l'option Charger dans le brouillon.
  4. Une option permet d'écraser les données au niveau de l'agent lors du chargement.

Pour supprimer une version de flux spécifique, procédez comme suit :

  1. Maintenez le pointeur sur la ligne d'une version.
  2. Cliquez sur le bouton d'option .
  3. Cliquez sur l'option Supprimer la version.

API

Consultez les méthodes pour le type Version.

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

Protocole V3 V3beta1
REST Ressource de version Ressource de version
RPC Interface de version Interface de version
C++ VersionsClient Non disponible
C# VersionsClient Non disponible
Go VersionsClient Non disponible
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Non disponible Non disponible
Python VersionsClient VersionsClient
Ruby Non disponible Non disponible

Comparer les versions de flux

Une fois que vous avez créé des versions de flux, vous pouvez utiliser l'outil de comparaison des versions pour comparer les versions de flux ou la version de brouillon. Cette fonctionnalité n'est pas disponible pour les playbooks. Pour comparer les versions, procédez comme suit :

Console

  1. Maintenez le pointeur sur la ligne d'une version.
  2. Cliquez sur le bouton d'option .
  3. Cliquez sur l'option Comparer les versions.
  4. Sélectionnez une autre version de flux ou un autre flux à utiliser pour la comparaison.
  5. Un comparatif est affiché.

API

Consultez la méthode compareVersions pour le type Version.

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

Protocole V3 V3beta1
REST Ressource de version Ressource de version
RPC Interface de version Interface de version
C++ VersionsClient Non disponible
C# VersionsClient Non disponible
Go VersionsClient Non disponible
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Non disponible Non disponible
Python VersionsClient VersionsClient
Ruby Non disponible Non disponible

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 Google Cloud.
  3. Sélectionnez votre agent.
  4. Cliquez sur l'onglet Ressources partagées.
  5. Cliquez sur Environnements.
  6. Les environnements d'agent sont répertoriés.

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

Pour sélectionner des versions de flux et de playbook, 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 le type Environment.

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

Protocole V3 V3beta1
REST Ressource d'environnement Ressource de l'environnement
RPC Interface de l'environnement Interface de l'environnement
C++ EnvironmentsClient Non disponible
C# EnvironmentsClient Non disponible
Go EnvironmentsClient Non disponible
Java EnvironmentsClient EnvironmentsClient
Node.js EnvironmentsClient EnvironmentsClient
PHP Non disponible Non disponible
Python EnvironmentsClient EnvironmentsClient
Ruby Non disponible Non disponible

Spécifier l'environnement pour les appels de session

En utilisant simulateur de console ou l'API, vous pouvez spécifier un environnement lorsque vous effectuez des appels de session d'exécution. Si aucun environnement n'est spécifié, l'environnement par défaut est utilisé.

Console

Lorsque vous utilisez le simulateur de console, sélectionnez l'option Tester l'agent dans l'environnement, puis sélectionnez un environnement.

API

Pour spécifier un environnement pour detectIntent, streamingDetectIntent, matchIntent et les appels REST d'entité de session modifiez l'URL en insérant environments/environment-id entre les paramètres de chemin agent et sessions.

Par exemple, l'URL suivante utilise 6db409d7-57ac-41d7-83bd-89b8768e2745 ID d'environnement:

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

Spécifier des versions de flux pour les appels de session

À l'aide du simulateur de console ou de l'API, vous pouvez spécifier un ensemble de versions de flux lorsque vous effectuez des appels de session d'exécution. Les versions de flux sélectionnées ne doivent pas nécessairement être référencées dans n'importe quel environnement.

Console

Lorsque vous utilisez le simulateur de console, sélectionnez l'option Tester l'agent avec des versions de flux spécifiques, puis sélectionnez les versions du flux.

API

Pour spécifier les versions de flux pour detectIntent, streamingDetectIntent, matchIntent et les appels REST d'entité de session fournissent les versions de flux choisies dans query_parameters.flow_versions de la requête.