Un agent Dialogflow CX est un agent virtuel qui gère les conversations simultanées avec vos utilisateurs finaux. Il s'agit d'un module de compréhension du langage naturel qui saisit les nuances du langage humain. Dialogflow traduit les contenus texte ou audio produits par l'utilisateur final au cours d'une conversation en données structurées assimilables par vos applications et vos services. Vous pouvez créer un agent Dialogflow conçu pour gérer les types de conversations requis pour votre système.
Un agent Dialogflow est comparable à un agent humain de centre d'appels. L'un comme l'autre doivent apprendre à gérer les scénarios de conversation attendus, sans qu'il soit nécessaire de leur dispenser un entraînement/une formation trop explicite.
Créer un agent
Pour créer un agent, procédez comme suit :
Console
- Ouvrez la console Dialogflow CX.
- Créez ou sélectionnez un projet Google Cloud.
- Cliquez sur Create Agent (Créer un agent).
- Sélectionnez Générer automatiquement pour créer un agent de data store ou sélectionnez Créer le vôtre pour créer d'autres types d'agents.
- Remplissez le formulaire pour les paramètres de base de l'agent :
- Vous pouvez choisir n'importe quel nom à afficher.
- Sélectionnez votre lieu préféré. Cliquez sur le bouton Modifier si vous souhaitez modifier les paramètres de localisation avancés.
- Sélectionnez le fuseau horaire de votre choix.
- Sélectionnez la langue par défaut de votre agent. Une fois l'agent créé, vous ne pouvez plus modifier la langue par défaut.
- Cliquez sur Enregistrer.
API
Si vous n'avez pas encore configuré de paramètres d'emplacement pour votre projet, vous devez les configurer avec la console avant de créer des agents avec l'API. Actuellement, vous ne pouvez pas configurer les paramètres de localisation à l'aide de l'API.
Pour créer un agent, consultez la méthode create
pour le type Agent
.
Sélectionnez un protocole et une version pour la référence de l'agent :
Protocole | V3 | V3beta1 |
---|---|---|
REST | Ressource de l'agent | Ressource de l'agent |
RPC | Interface de l'agent | Interface de l'agent |
C++ | AgentsClient | Non disponible |
C# | AgentsClient | Non disponible |
Go | AgentsClient | Non disponible |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponible | Non disponible |
Python | AgentsClient | AgentsClient |
Ruby | Non disponible | Non disponible |
Données de l'agent
Les agents Dialogflow servent de conteneurs de niveau supérieur pour les paramètres et les données des agents virtuels.
Pour accéder aux données d'un agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Recherchez l'agent dans la liste.
- Cliquez sur le nom à afficher de l'agent.
- Mettez à jour les flux, les pages, et plus, comme décrit dans d'autres guides.
API
Consultez les guides relatifs aux données que vous souhaitez mettre à jour.
Les données suivantes sont associées aux agents :
Pour en savoir plus sur la manière dont les données sont appliquées à différents niveaux, consultez la section Niveaux d'application des données.
Paramètres de l'agent
Pour accéder aux paramètres de l'agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Cliquez sur Agent Settings (Paramètres de l'agent).
- Mettez à jour les paramètres comme vous le souhaitez.
- Cliquez sur Enregistrer.
API
Consultez les méthodes get
et patch/update
pour le type Agent
.
Sélectionnez un protocole et une version pour la référence de l'agent :
Protocole | V3 | V3beta1 |
---|---|---|
REST | Ressource de l'agent | Ressource de l'agent |
RPC | Interface de l'agent | Interface de l'agent |
C++ | AgentsClient | Non disponible |
C# | AgentsClient | Non disponible |
Go | AgentsClient | Non disponible |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponible | Non disponible |
Python | AgentsClient | AgentsClient |
Ruby | Non disponible | Non disponible |
Les sous-sections suivantes décrivent les différentes catégories de paramètres d'agent.
Paramètres généraux
Les paramètres généraux suivants sont disponibles pour les agents :
-
Nom lisible de votre agent.
-
Le fuseau horaire par défaut de votre agent.
-
La langue utilisée par défaut par votre agent. Une fois l'agent créé, la langue par défaut ne peut plus être modifiée. Vous pouvez toutefois effectuer les opérations suivantes:
- Exportez votre agent au format JSON.
- Décompressez le fichier téléchargé.
- Recherchez le fichier
agent.json
. - Mettez à jour les champs
defaultLanguageCode
etsupportedLanguageCodes
avec les valeurs souhaitées. - Restaurez l'agent sur le même agent ou sur un autre agent qu'à l'étape 1.
- Mettez à jour les phrases d'entraînement et les valeurs d'entité spécifiques à la langue si nécessaire.
-
Verrouiller l'agent
Indique si l'agent est verrouillé. Impossible de modifier un agent verrouillé.
-
Activer Cloud Logging
Indique si Cloud Logging est activé pour l'agent.
Activer la journalisation des interactions
Indique si vous souhaitez que Google collecte et stocke les requêtes des utilisateurs finaux masquées afin d'améliorer la qualité.
-
Activer BigQuery Export
Indique si l'exportation BigQuery est activée.
Ensemble de données BigQuery
Nom de l'ensemble de données BigQuery.
Table BigQuery
Le nom de la table BigQuery
-
Vous pouvez activer les suggestions d'intents.
Modèle de charge utile personnalisé
Dans cette section, vous pouvez créer des descriptions et des charges utiles pour les modèles de charge utile personnalisés.
Paramètres de ML
Dialogflow utilise des algorithmes de machine learning (ML) pour comprendre les entrées de l'utilisateur final, les mettre en correspondance avec des intents et extraire des données structurées. Dialogflow apprend à partir des expressions d'entraînement que vous fournissez et des modèles de langue intégrés à Dialogflow. Sur la base de ces données, il crée un modèle pour décider quel intent doit correspondre à l'entrée de l'utilisateur final. Vous pouvez appliquer des paramètres de ML uniques à chaque flux d'un agent. Le modèle créé par Dialogflow est unique pour chaque flux.
Les paramètres de ML suivants à l'échelle de l'agent sont disponibles :
Autoriser le ML à corriger l'orthographe
Si ce paramètre est activé et que l'entrée de l'utilisateur final comporte une faute d'orthographe ou de grammaire, un intent est mis en correspondance comme si elle avait été écrite correctement. La réponse de détection d'intent contient l'entrée corrigée de l'utilisateur final. Par exemple, si un utilisateur final saisit "Je veux une pommme", elle sera traitée comme s'il avait saisi "Je veux une pomme". Cela s'applique également aux correspondances impliquant des entités système et personnalisées.
La correction orthographique est disponible en allemand, anglais, espagnol, français et italien. Il est disponible dans toutes les régions Dialogflow CX.
Avertissements et bonnes pratiques :
- La correction orthographique ne permet pas de corriger les erreurs de reconnaissance vocale automatique. Nous vous déconseillons donc de l'activer pour les agents utilisant ce type d'entrées.
- Il est possible que l'entrée corrigée corresponde au mauvais intent. Pour résoudre ce problème, ajoutez des expressions fréquemment non concordantes aux exemples négatifs.
- La correction orthographique augmente légèrement le temps de réponse de l'agent.
- Si un agent est défini à l'aide d'un jargon propre à un domaine, des corrections indésirables peuvent être effectuées.
Les paramètres de ML suivants spécifiques au flux sont disponibles :
-
Il peut s'agir d'un des éléments suivants :
- Advanced NLU (NLU avancé) (par défaut): technologie NLU avancée. Ce type de NLU fonctionne mieux que le standard, en particulier pour les agents et les flux volumineux.
- NLU standard: technologie NLU standard. ne bénéficieront plus d'améliorations de la qualité ni de nouvelles fonctionnalités.
-
Si cette option est activée, le flux est entraîné à chaque mise à jour avec la console. Pour les flux volumineux, cela peut entraîner des retards dans l'interface utilisateur de la console. Vous devez donc désactiver ce paramètre et réaliser un entraînement manuel si nécessaire pour les flux volumineux.
-
Pour filtrer les résultats faux positifs tout en conservant la variété des entrées en langage naturel correspondantes pour votre agent, vous pouvez ajuster le seuil de classification du machine learning. Ce paramètre détermine le niveau minimal de fiabilité de détection d'intents requis pour une correspondance d'intent.
Si le score de confiance d'une correspondance d'intent est inférieur à la valeur du seuil, un événement de non-correspondance est invoqué.
-
Indique si le flux a été entraîné depuis la dernière mise à jour des données de flux.
-
Utilisez ce bouton pour entraîner manuellement le flux.
Paramètres d'IA générative
Les paramètres d'IA générative suivants sont disponibles:
Général
Agent génératif
Sélection d'un modèle génératif
Sélectionnez le modèle utilisé par les caractéristiques génératives. Pour en savoir plus, consultez la section Versions de modèle.
Génération de remplacement
Configuration des requêtes textuelles
Consultez Remplacement génératif: définir votre propre requête.
Datastore
Consultez la section Paramètres de l'agent de data store.
Paramètres vocaux et de réponse vocale interactive
Les paramètres vocaux et de réponse vocale interactive suivants sont disponibles:
-
-
Vous pouvez sélectionner la langue et la voix utilisées pour la synthèse vocale.
Vous pouvez activer l'option Voix personnalisée pour votre agent en sélectionnant l'option de voix personnalisée dans le compte "Envoi sécurisé" de sélection de voix et en spécifiant le nom de la voix personnalisée dans le champ correspondant. Le nom de la voix personnalisée doit respecter le format suivant :
projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME
.- Si vous utilisez une passerelle de téléphonie, assurez-vous que le compte de service Agent de service Dialogflow
service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com
est associé à "AutoML Predictor" dans votre projet vocal personnalisé. - Pour les appels d'API standards, assurez-vous que le compte de service utilisé pour appeler Dialogflow dispose du rôle "Prédicteur AutoML" dans votre projet vocal personnalisé.
- Si vous utilisez une passerelle de téléphonie, assurez-vous que le compte de service Agent de service Dialogflow
-
-
Activer l'adaptation vocale automatique
Consultez l'adaptation vocale automatique.
-
Cette section fournit des paramètres avancés supplémentaires pour les fonctionnalités de reconnaissance vocale. Vous pouvez activer ou désactiver ces paramètres avancés.
Ces paramètres sont disponibles dans les paramètres de l'agent (s'applique à l'ensemble de l'agent), les paramètres de flux (s'applique à l'ensemble du flux et remplace les paramètres de l'agent), les paramètres de page (s'applique à la page et remplace les paramètres de flux et d'agent) et les paramètres de traitement (s'applique aux paramètres de fulfillment et de remplacement de page, de flux et d'agent). Un sous-ensemble de ces paramètres est disponible à chaque niveau, en fonction de la pertinence du paramètre pour le niveau.
Les paramètres mis à jour au niveau de l'agent ne se propagent pas au niveau du flux, de la page et du traitement lorsque l'option Customize (Personnaliser) est sélectionnée à ces niveaux inférieurs. Si l'option Customize (Personnaliser) englobe plusieurs paramètres et que vous ne souhaitez mettre à jour que certains d'entre eux, vous devrez peut-être également mettre à jour d'autres paramètres si vous souhaitez qu'ils soient identiques à ceux au niveau de l'agent.
Sélection du modèle (Speech-to-Text)
Définit le modèle de reconnaissance vocale utilisé pour la reconnaissance vocale. Ce paramètre est propre à la langue. Vous pouvez donc sélectionner différents modèles pour différentes langues. Vous pouvez également cocher la case Remplacer le modèle de reconnaissance vocale au niveau de la requête pour que le modèle sélectionné soit utilisé même si un appel d'API lors de l'exécution spécifie un autre modèle.
Pour la passerelle de téléphonie Dialogflow CX, consultez la section Limites.
Pour en savoir plus, consultez la page Modèles vocaux.
Sensibilité à la fin de la parole
Contrôle la sensibilité de la reconnaissance de fin de voix dans les entrées audio de l'utilisateur final. La valeur est comprise entre 0 (sensibilité faible, risque de mettre fin à la parole) à 100 (sensibilité élevée, risque de mettre fin à la parole).
Activer la fin de la sensibilité vocale avancée basée sur un délai avant expiration
Si ce paramètre est activé, la valeur du paramètre Fin de la sensibilité vocale est utilisée comme indicateur pour établir un délai avant expiration du silence audio relatif afin de déterminer la fin de la parole.
Si ce paramètre est désactivé (valeur par défaut), la valeur du paramètre Fin de la sensibilité vocale est utilisée pour déterminer la fin de la voix par le modèle de ML fourni par Google Cloud Speech-To-Text.
Bien que le paramètre Fin de la sensibilité de la parole n'accepte que la balise langue
en-US
par défaut, le paramètre Activer la fin de la sensibilité vocale basée sur un délai avancé permet de configurer la sensibilité de fin de la parole pour toutes les langues et tous les modèles vocaux compatibles avec Dialogflow.Activer les points de terminaison intelligents
Si ce paramètre est activé, Dialogflow analyse l'entrée utilisateur partielle pour déterminer la fin de la parole. Par exemple, si l'utilisateur dit "Je voudrais" et s'interrompt, Dialogflow attend que l'utilisateur continue la phrase.
Cela est particulièrement utile pour la collecte de paramètres numériques, où l'utilisateur peut dire "1234" et faire une pause avant de dire "5678". Pour appliquer ce paramètre à un paramètre spécifique, vous devez configurer un point de terminaison intelligent dans le formulaire du paramètre.
Cette option n'est disponible que pour la balise de langue
en-US
.Ce paramètre est désactivé par défaut.
Aucun délai d'inactivité de la voix
Durée en secondes pendant laquelle Dialogflow arrête d'attendre l'entrée audio de l'utilisateur final. La valeur par défaut est de 5 secondes, et la valeur maximale est de 60 secondes. Pour ce délai, Dialogflow appelle un événement sans entrée.
-
Lorsque ce paramètre est activé, un utilisateur final peut interrompre le contenu audio de la réponse Dialogflow. Lorsqu'il est interrompu, Dialogflow arrête l'envoi du contenu audio et traite la prochaine entrée de l'utilisateur final.
si la file d'attente de messages comporte plusieurs messages, et qu'un message a été mis en file d'attente par un fulfillment associé à une page, à un flux ou à un agent sur lequel la désynchronisation (barge-in) est activée, alors tous les messages suivants de la file d'attente auront également la désynchronisation activée. Dans ce cas, l'intégration cessera de lire le contenu audio de tous les messages en file d'attente avec la fonctionnalité de barge-in activée.
Autoriser l'annulation de la lecture des réponses partielles
Lorsque la réponse partielle est activée, ce paramètre permet d'annuler la lecture d'une réponse partielle. Si un message de la file d'attente de messages est créé par un fulfillment autorisant l'annulation, la lecture du message est annulée si un autre message est ajouté à la file d'attente. Cela est utile lorsque vous souhaitez qu'un message initial démarre la lecture, mais pour que cette lecture soit annulée si un webhook fonctionnel génère un autre message avant la fin de la lecture du message initial.
-
Si elles sont fournies, toutes les données audio associées à une requête sont enregistrées dans le bucket Cloud Storage:
Audio enregistré Requêtes applicables Entrée audio de l'utilisateur final DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent Audio de synthèse vocale (TTS) synthétisé pour une réponse AnalyzeContent, StreamingAnalyzeContent Attribuez le rôle Créateur des objets de l'espace de stockage aux comptes de service suivants dans votre projet :
Au compte de service au format
one-click@df-cx-ALPHANUMERIC_VALUE-ALPHANUMERIC_VALUE.iam.gserviceaccount.com
si vous utilisez une intégration téléphonique intégrée de partenaires.Au compte de service au format
service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com
si vous utilisez l'intégration de passerelle de téléphonie Dialogflow CX. Pour trouver ce compte de service dans IAM, cochez l'option Inclure les attributions de rôles fournies par Google.
DTMF: voir DTMF pour les intégrations de téléphonie.
Multimodal
Consultez la section Appeler le compagnon.
Paramètres de partage
Consultez la page Contrôle des accès.
Paramètres linguistiques
Ajoutez des langues supplémentaires à votre agent. Pour obtenir la liste complète des langues, consultez la documentation de référence sur les langages.
Détection automatique de la langue
Lorsque vous configurez la détection automatique de la langue, votre agent de chat détecte automatiquement la langue de l'utilisateur final et passe à cette langue. Pour en savoir plus, consultez la documentation sur la détection automatique de la langue.
Paramètres de sécurité
Consultez la section Paramètres de sécurité.
Paramètres avancés
Actuellement, le seul paramètre avancé est l'analyse des sentiments.
Exporter et restaurer un agent
Vous pouvez exporter un agent vers un fichier et restaurer un agent à l'aide de ce fichier.
Une exportation d'agent inclut toutes les données d'agent, à l'exception des suivantes:
- Versions de flux : seuls les brouillons de flux sont exportés dans un fichier.
- Environnements : les environnements personnalisés ne sont pas exportés vers un fichier.
Une restauration d'agent écrase toutes les données de l'agent cible (y compris toutes les versions de flux), à l'exception des éléments suivants:
- Environnements : tous les environnements personnalisés restent inchangés dans l'agent cible. Les versions de flux référencées par des environnements personnalisés dans l'agent cible continueront d'exister tant que les environnements associés existent. Toutefois, ces versions de flux obsolètes ne sont pas répertoriées ni les versions de flux sélectionnables pour l'agent.
- Applications d'agents Vertex AI : l'association à une application d'agents Vertex AI reste inchangée dans l'agent cible. (En d'autres termes, la valeur de
engine
dans GenAppBuilderSettings) Cela signifie que les agents de data store ne peuvent être restaurés que dans d'autres agents de data store existants, car l'agent obtenu doit également être associé à une application d'agents Vertex AI. Magasin de données pour les agents Vertex AI : toutes les références aux datastores seront écrasées dans l'agent cible selon les règles suivantes:
- Si l'agent cible n'est associé à aucune application, il n'est pas possible de restaurer un agent contenant des références de data store. Si vous essayez de le faire, un message d'erreur s'affiche. Pour résoudre ce problème, vous pouvez créer un agent de data store à partir de zéro. Vous pouvez également transformer votre agent existant en agent de data store en lui ajoutant un gestionnaire d'état du data store. Dans ce cas, des instructions vous aideront à ajouter une application associée à votre agent.)
- Si l'agent cible est associé à une application, toutes les références du data store seront mises à jour lors de la restauration. L'ID et l'emplacement de leur projet Google Cloud seront mis à jour pour correspondre à l'application de l'agent cible. L'ID de collection et l'ID du data store resteront inchangés. Cela signifie que vous devez ajouter des datastores pour tous les ID ayant des types correspondants dans l'application de l'agent cible avant l'opération de restauration.
Exemple: Si l'agent source fait référence à un data store nommé
projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1
et que l'application de l'agent cible est nomméeprojects/321/locations/us-east1/collections/default_collections/engines/app123
, la référence du data store obtenue dans l'agent cible devient :projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Lors de l'exportation, vous pouvez sélectionner le format de fichier d'exportation. Si vous utilisez la gestion des versions avec contrôle du code source pour vos données d'agent, vous devez les exporter au format JSON. Lorsque vous restaurez un agent, Dialogflow détermine automatiquement le format de fichier.
Pour exporter ou restaurer un agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Cliquez sur le menu Option more_vert d'un agent dans la liste.
- Cliquez sur le bouton Exporter ou Restaurer.
- Suivez les instructions pour terminer.
API
Consultez les méthodes export
et restore
pour le type Agent
.
Sélectionnez un protocole et une version pour la référence de l'agent :
Protocole | V3 | V3beta1 |
---|---|---|
REST | Ressource de l'agent | Ressource de l'agent |
RPC | Interface de l'agent | Interface de l'agent |
C++ | AgentsClient | Non disponible |
C# | AgentsClient | Non disponible |
Go | AgentsClient | Non disponible |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponible | Non disponible |
Python | AgentsClient | AgentsClient |
Ruby | Non disponible | Non disponible |
Si la taille de l'agent dépasse la limite maximale, utilisez l'option Cloud Storage pour l'exportation et la restauration de l'agent.
Si vous utilisez GitHub, consultez également le guide d'exportation/restauration GitHub.
Supprimer un agent
Pour supprimer un agent, vous devez disposer d'un rôle doté d'un accès complet ou d'un accès en modification. Pour en savoir plus, consultez le guide du contrôle des accès.
Pour supprimer un agent, procédez comme suit :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Cliquez sur le menu Option more_vert d'un agent dans la liste.
- Cliquez sur le bouton Supprimer delete.
- Confirmez la suppression dans la boîte de dialogue.
API
Consultez la méthode delete
pour le type Agent
.
Sélectionnez un protocole et une version pour la référence de l'agent :
Protocole | V3 | V3beta1 |
---|---|---|
REST | Ressource de l'agent | Ressource de l'agent |
RPC | Interface de l'agent | Interface de l'agent |
C++ | AgentsClient | Non disponible |
C# | AgentsClient | Non disponible |
Go | AgentsClient | Non disponible |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponible | Non disponible |
Python | AgentsClient | AgentsClient |
Ruby | Non disponible | Non disponible |
Si vous supprimez votre projet, tous les agents Dialogflow CX et les données qui lui sont associées sont immédiatement supprimés.