Les agents conversationnels (Dialogflow CX) s'intègrent à GitHub. Cette intégration facilite exporter votre agent au format JSON. pour un transfert vers GitHub, et extraire des données depuis GitHub la restauration de l'agent. Le format JSON exporté vers GitHub correspond au contenu du fichier ZIP développé de l'agent exporté.
Cette fonctionnalité vous permet de bénéficier Les fonctionnalités de contrôle du code source de GitHub, telles que:
- Les examens des changements d'agent à l'aide de outils de revue de code
- Examiner les différences entre les agents à l'aide d'outils de comparaison
- Fusions
- Et ainsi de suite.
Limites
Les limites suivantes s'appliquent :
- GitHub dispose d'un limite de débit pour le nombre de requêtes par heure (5 000 pour les comptes non professionnels, 15 000 pour les comptes d'entreprise). Si votre push d'agent dépasse cette limite, la console Dialogflow CX signale l'erreur de limite de débit. Vous pouvez relancer le transfert au bout d'une heure.
- Les API GitHub limitent le nombre de fichiers pouvant être mis à jour dans un seul commit. Si le nombre de fichiers dépasse 500, vous ne pourrez peut-être pas transférer vers GitHub depuis des agents conversationnels (Dialogflow CX). Dans ce cas, vous pouvez exporter
l'agent en tant que fichier ZIP et utiliser la CLI Git sur votre machine pour transférer les fichiers de l'agent vers GitHub. Cette limitation sera levée dans une prochaine version des agents conversationnels (Dialogflow CX). - Accès privé auto-hébergé ne sont pas pris en charge, car les agents conversationnels (Dialogflow CX) ne peuvent pas accéder à ces dépôts.
- Le dépôt GitHub ne peut contenir que les fichiers d'agent exportés par l'exportation d'agent. Tous les autres fichiers du dépôt seront supprimés à chaque transfert.
Configuration
Pour configurer cette intégration :
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Cliquez sur l'onglet Gestion.
- Cliquez sur Git dans la section Testing & Déploiement.
- Cliquez sur Ajouter une intégration Git. Une boîte de dialogue de configuration s'ouvre.
- Saisissez les informations suivantes:
<ph type="x-smartling-placeholder">
- </ph>
- Nom à afficher pour la connexion GitHub.
- URL du dépôt GitHub (par exemple:
https://api.github.com/repos/<repository_owner>/<repository_name>). - Ajoutez les branches GitHub avec lesquelles votre agent interagira. Vous pouvez désigner une branche comme branche par défaut en cliquant sur l'icône en forme d'étoile à côté d'elle.
- Le jeton d'accès personnel GitHub ne peut pas être consulté une fois défini. Seules les mises à jour sont prises en charge.
Si vous utilisez un jeton d'accès personnel précis,
vous avez besoin des éléments suivants
autorisations
accès:
- Autorisations du dépôt > Sommaire: Lecture et écriture
- Autorisations du dépôt > Métadonnées: en lecture seule (elles doivent être sélectionnées automatiquement) après avoir sélectionné l'autorisation Contenu)
- Cliquez sur Se connecter.
Cette configuration peut être modifiée à tout moment en cliquant sur l'icône de modification.
Transférer et restaurer
Une fois configuré, vous pouvez pousser/extraire votre agent vers/depuis GitHub.
Le bouton Push est utilisé pour exporter l'agent. et effectuez un commit sur la branche GitHub sélectionnée dans la liste déroulante des branches Git. Ce commit comprendra l'intégralité de l'agent et non des modifications spécifiques. et supprimera tous les fichiers existants dans le dépôt.
Pour les nouveaux dépôts, assurez-vous qu'il existe au moins un commit GitHub avant d'utiliser l'option de transfert dans la console Dialogflow CX.
Les utilisateurs disposant des rôles Lecteur Dialogflow peuvent effectuer des transferts vers des dépôts GitHub. Pour éviter les transferts indésirables, configurez ces agents en lecture seule des jetons d'accès personnels.
Le bouton Restore (Restaurer) permet d'extraire les données de votre agent à partir de la branche GitHub sélectionnée dans le menu déroulant de la branche Git, puis de restaurer votre agent Conversational Agents (Dialogflow CX) à partir de ces données. Cette opération écrasera votre agent de la même manière que toute restauration d'agent. se comporte.
Exemple d'utilisation
L'exemple suivant montre comment plusieurs personnes peuvent utiliser cette fonctionnalité pour proposer différentes modifications d'agent à un agent de production.
Supposons que votre agent utilise les branches GitHub suivantes :
- Prod: branche de l'agent de production
- Dev1 : branche de développement de l'agent
- Dev2 : autre branche pour le développement d'agents
L'utilisateur 1 souhaite proposer des modifications d'agents et procède comme suit :
- Exportez l'agent de production vers un nouvel agent.
- Apportez les modifications souhaitées à ce texte d'agent.
- Testez les modifications.
- Transférez l'agent modifié dans la branche Dev1.
- Créez une demande de fusion pour la branche Prod.
L'utilisateur 2 souhaite proposer des modifications d'agents et procède comme suit :
- Exportez l'agent de production vers un nouvel agent.
- Apportez les modifications souhaitées à ce texte d'agent.
- Testez les modifications.
- Transférez l'agent modifié vers la branche Dev2.
- Créez une demande de fusion pour la branche Prod.
L'utilisateur 3 examine les demandes de fusion des deux utilisateurs et procède comme suit:
- Résolvez les conflits.
- Committe les modifications approuvées.
- Restaure la branche GitHub de production sur l'agent Conversational Agents (Dialogflow CX) de production.