Versions et environnements

Vous pouvez créer plusieurs versions de vos flux d'agent 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 des webhooks spécifiques à un 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. Un brouillon peut être mis hors service involontairement, en particulier si plusieurs personnes disposent d'un accès en écriture à l'agent. En outre, un brouillon 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 pour votre trafic de production. Les brouillons de ressources 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.

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. Lors du développement et du test de ces modifications, vous devez:

• Pour 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.

L'utilisation de webhooks spécifiques à l'environnement permet d'atteindre ces deux objectifs.

Tenir compte des erreurs d'agent possibles lors du changement de version

Si vous modifiez une version dans votre environnement de production alors que des 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édentes et nouvelles sont incohérentes entre elles d'une manière qui perturbe l'état de la session. Par conséquent, planifiez de changer de version pendant les temps d'arrêt ou les heures creuses.

Charger une version 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.

De même, la restauration d'une version de playbook en brouillon écrase le playbook existant en brouillon et ses exemples.

Gérer les versions

Pour gérer vos versions:

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 :

Gérer les environnements

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

Spécifier un environnement pour les appels de session

À l'aide du simulateur de console ou de 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é.

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 un environnement.