Un agent Dialogflow CX est un agent virtuel qui gère les conversations 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 choisissez un projet GCP.
- Cliquez sur Create Agent (Créer un agent).
- 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 l'agent.
- Activez éventuellement Stackdriver Logging.
- Cliquez sur Enregistrer.
API
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# | Non disponible | Non disponible |
| Go | Non disponible | 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 GCP 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 :
Paramètres de l'agent
Pour accéder aux paramètres de l'agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet GCP.
- 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# | Non disponible | Non disponible |
| Go | Non disponible | 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 à afficher
Nom lisible pour votre agent.
Fuseau horaire
Le fuseau horaire par défaut de votre agent.
Langue par défaut
La langue utilisée par défaut par votre agent.
Activer Stackdriver Logging
Indique si Cloud Logging est activé pour l'agent.
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 :
Laisser 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 pour toutes les langues compatibles avec Dialogflow.
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 :
Type de NLU
Il peut s'agir d'un des éléments suivants :
- Standard : technologie NLU standard.
- Avancé : technologie NLU avancée. Ce type de NLU est plus performant que la version standard, en particulier pour les agents et flux volumineux. Comme l'entraînement du modèle prend plus de temps, l'entraînement automatique est désactivé. Vous devez entraîner les flux manuellement ou via l'API.
Entraînement automatique
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 effectuer manuellement un entraînement pour les flux volumineux. Ce paramètre ne peut pas être activé pour le type de compréhension avancée avancée.
Seuil de classification
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é.
État de l'entraînement
Indique si le flux a été entraîné depuis la dernière mise à jour des données de flux.
Entraînement de NLU
Utilisez ce bouton pour entraîner manuellement le flux.
Paramètres vocaux et de réponse vocale interactive
Les paramètres vocaux suivants sont disponibles :
Activer l'adaptation vocale
Consultez l'adaptation vocale automatique.
Paramètres vocaux avancés
Cette section propose des paramètres avancés supplémentaires pour les fonctionnalités vocales. Ces paramètres ne s'appliquent qu'aux intégrations de téléphonie et aux intégrations de partenaires spécialisés. Ces paramètres sont disponibles dans les paramètres de l'agent (s'appliquent à l'ensemble de l'agent), aux paramètres de flux (s'appliquent à l'ensemble du flux et remplacent les paramètres de l'agent) et à paramètres de page (s'applique à la page et remplace les paramètres de flux et d'agent). Vous pouvez activer et désactiver ces paramètres avancés.
Sensibilité de la reconnaissance vocale
Permet de contrôler la sensibilité pour la reconnaissance vocale dans les entrées audio de l'utilisateur final. La valeur est comprise entre 0 (faible sensibilité, moins probable pour la synthèse vocale) à 100 (probabilité élevée, probabilité plus élevée de fin)
Pas de délai avant la parole
Durée en secondes pendant laquelle Dialogflow cesse d'attendre l'entrée audio de l'utilisateur final. La valeur par défaut est de 5 secondes. Pour ce délai, Dialogflow appelle un événement sans entrée.
Aboie
Lorsque cette option est activée, un utilisateur final peut interrompre le flux audio de réponse Dialogflow. En cas d'interruption, Dialogflow arrête d'envoyer des données audio et traite la prochaine entrée utilisateur.
URI Google Cloud Storage
Si vous fournissez cette information, le contenu audio de réponse Dialogflow sera enregistré dans le bucket Cloud Storage.
Paramètres de partage
Consultez la page Contrôle des accès.
Paramètres de version
Consultez la page Versions et environnements.
Paramètres de l'environnement
Consultez la page Versions et environnements.
Paramètres linguistiques
Ajoutez une assistance linguistique supplémentaire à votre agent. Pour obtenir la liste complète des langues, consultez la documentation de référence sur les langages.
Paramètres avancés
Actuellement, le seul paramètre avancé est celui de l'analyse des sentiments.
Paramètres de sécurité
Vous pouvez appliquer des paramètres de sécurité spécifiques aux agents pour contrôler le masquage et la conservation des données. Pour définir les paramètres de sécurité, procédez comme suit:
Console
API
Consultez le champ security_settings pour le type de 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# | Non disponible | Non disponible |
| Go | Non disponible | Non disponible |
| Java | AgentsClient | AgentsClient |
| Node.js | AgentsClient | AgentsClient |
| PHP | Non disponible | Non disponible |
| Python | AgentsClient | AgentsClient |
| Ruby | Non disponible | Non disponible |
Exporter et restaurer un agent
Pour exporter ou restaurer un agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet GCP pour l'agent.
- Cliquez sur le menu d'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# | Non disponible | Non disponible |
| Go | Non disponible | Non disponible |
| Java | AgentsClient | AgentsClient |
| Node.js | AgentsClient | AgentsClient |
| PHP | Non disponible | Non disponible |
| Python | AgentsClient | AgentsClient |
| Ruby | Non disponible | Non disponible |
Supprimer un agent
Pour supprimer un agent, vous devez disposer d'un rôle de propriétaire de projet IAM, d'éditeur de projet IAM ou d'administrateur de l'agent Dialogflow disposant d'un "accès complet". Consultez le guide du contrôle des accès pour plus d'informations.
Pour supprimer un agent, procédez comme suit :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet GCP pour l'agent.
- Cliquez sur le menu d'option more_vert d'un agent dans la liste.
- Cliquez sur le bouton de suppression 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# | Non disponible | Non disponible |
| Go | Non disponible | Non disponible |
| Java | AgentsClient | AgentsClient |
| Node.js | AgentsClient | AgentsClient |
| PHP | Non disponible | Non disponible |
| Python | AgentsClient | AgentsClient |
| Ruby | Non disponible | Non disponible |