Paramètres de l'agent

Cette page décrit les différents paramètres que vous pouvez appliquer à un agent. Pour accéder à ces paramètres, procédez comme suit :

1. Accédez à la console Dialogflow ES.
2. Sélectionnez votre agent dans la partie supérieure du menu de la barre latérale gauche.
3. Cliquez sur le bouton des paramètres à côté du nom de l'agent.

Remarque : Si vous travaillez sur un petit écran et que le menu de la barre latérale est masqué, cliquez sur le bouton du menu dans le coin supérieur gauche.

Édition de l'agent

Les agents utilisent par défaut Dialogflow Trial Edition (version d'essai). Pour modifier l'édition d'un agent, procédez comme suit :

Console

Remarque : Seuls les propriétaires de projet peuvent modifier l'édition d'un agent dans la console Dialogflow.

1. Faites défiler jusqu'en bas du menu de la barre latérale gauche, où se trouve l'édition de l'agent.
2. Cliquez sur le lien Edit (Modifier) ou Passer à une édition supérieure.
3. Sélectionnez un forfait

API

Appelez la méthode setAgent pour la ressource "Projects". Fournissez l'argument "TIER_ENTERPRISE" au champ tier pour passer à l'édition Dialogflow Essentials ou "TIER_STANDARD" pour revenir à la version d'essai Dialogflow.

Remarque : L'autorisation minimale requise pour utiliser cette méthode est dialogflow.agents.create.

Si vous utilisez plusieurs projets, le projet client est utilisé pour déterminer l'édition, et donc les quotas et frais applicables.

Général

Pour accéder aux paramètres généraux, cliquez sur l'onglet Général.

Voici les paramètres disponibles :

• Description : description de l'agent.
• Fuseau horaire par défaut : fuseau horaire par défaut de l'agent. Les requêtes de date et d'heure sont résolues à l'aide de ce fuseau horaire si aucun fuseau horaire n'est fourni dans les requêtes API.
• URI d'avatar d'agent : URI de l'avatar d'agent utilisé par certaines intégrations.
• Projet Google : projet GCP associé à l'agent.
• Version du protocole Webhook de l'agent : visible uniquement dans les agents de l'ancienne API V1. Vous permet de passer au format webhook de l'API V2.
• Fonctionnalités bêta : cliquez sur le bouton afin d'activer les fonctionnalités bêta pour l'agent.

• Log Settings (Paramètres des journaux) :

  • Consigner les interactions dans Dialogflow:

    Remarque : Pour afficher ou modifier ce paramètre avec la console, vous devez disposer du rôle IAM Project Owner (Propriétaire de projet IAM). Pour lire ou modifier ce paramètre avec l'API, vous devez disposer de l'un des rôles suivants : Administrateur de l'API Dialogflow IAM, Éditeur IAM ou Propriétaire IAM, ou d'un rôle personnalisé contenant l'autorisation dialogflow.agents.create.

    Indique si la journalisation des interactions est activée pour l'agent.

  • Journaliser les interactions avec Google Cloud :

    Remarque : Pour afficher ou modifier ce paramètre dans la console, procédez comme suit : vous devez disposer Rôle de propriétaire de projet IAM Ce paramètre n'est pas disponible dans l'API.

    Indique si Cloud Logging est activé pour l'agent. Cette option n'est disponible que si le paramètre Journaliser les interactions avec Dialogflow est activé. Si vous désactivez la journalisation de Dialogflow, ce paramètre l'est également. Vous pouvez également cliquer sur le lien Ouvrir les journaux. pour ouvrir les journaux de votre agent dans Cloud Logging.

• Supprimer un agent : cette option supprime complètement l'agent, et elle ne peut pas être annulée. Si l'agent est partagé avec d'autres utilisateurs, ils doivent être éliminés de l'agent pour pouvoir le supprimer. Consultez la section Gestion des agents.

Langues

Pour accéder aux paramètres linguistiques, cliquez sur l'onglet Langue.

Vous pouvez définir la langue par défaut et plusieurs autres langues. Pour certaines langues racine, vous pouvez également ajouter un ou plusieurs paramètres régionaux. Pour plus d'informations, consultez Agents multilingues.

Paramètres de ML (machine learning)

Pour accéder aux paramètres de machine learning, cliquez sur l'onglet Paramètres ML.

Les agents Dialogflow utilisent des algorithmes de machine learning pour comprendre les expressions de l'utilisateur final, les mettre en correspondance avec des intents et extraire des données structurées. Un agent apprend à partir des expressions d'entraînement que vous fournissez et des modèles de langage intégrés dans Dialogflow. Sur la base de ces données, il crée un modèle permettant de décider quel intent doit être mis en correspondance avec l'expression de l'utilisateur final. Ce modèle est propre à l'agent.

Par défaut, Dialogflow met à jour le modèle de machine learning de l'agent chaque fois que vous modifiez les intents et les entités, que vous importez ou restaurez un agent, ou que vous entraînez l'agent.

Voici les paramètres disponibles :

• Seuil de classification du ML : vous pouvez ajuster le seuil de classification du machine learning pour filtrer les faux positifs tout en conservant une variété d'entrées en langage naturel correspondantes pour l'agent. Ce paramètre détermine le niveau minimal de fiabilité de détection d'intents requis pour une correspondance d'intent.

  Remarque : Avant d'ajuster cette valeur, vous devriez essayer d'ajouter des exemples négatifs.

• Correction orthographique automatique :

  Si ce paramètre est activé et que l'entrée utilisateur 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 utilisateur corrigée. Par exemple, si un utilisateur saisit "Je veux une pome", cette entrée est 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.

  Remarque : Si les entrées utilisateur d'origine et corrigées correspondent à des intents différents, l'intent correspondant à l'entrée utilisateur d'origine est sélectionné.

  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.
  • La correction orthographique ne doit pas être utilisée avec Actions on Google.
  • La correction orthographique est entraînée à l'aide des requêtes générales des utilisateurs. Si un agent est défini à l'aide d'un jargon propre à un domaine, des corrections indésirables peuvent être effectuées.

• Entraînement automatique : activez ou désactivez l'entraînement automatique de l'agent chaque fois qu'il est modifié.

  Remarque : Après la restauration ou l'importation, l'agent est réentraîné, même si l'entraînement automatique est désactivé.

• Validation de l'agent : consultez le guide de validation des agents.

Exporter et importer

Remarque : Les types d'agents Dialogflow ES et Dialogflow CX sont incompatibles. Vous ne pouvez pas importer un agent incompatible.

Pour accéder aux paramètres d'exportation et d'importation, cliquez sur l'onglet Exporter et importer.

Cette fonctionnalité vous permet d'exporter ou d'importer un agent depuis ou vers un fichier zip pour sauvegarder des agents ou les transférer d'un compte à un autre. Bien que vous puissiez modifier directement les fichiers JSON et les réimporter, les modifications doivent être effectuées à l'aide de l'API ou de la console Dialogflow. Cela garantit que les modifications sont validées par le système, et minimise le besoin de dépannage.

Les options suivantes sont disponibles :

• Exporter en tant que fichier ZIP : exporte l'agent en tant que fichier zip.
• Restaurer depuis un fichier ZIP : écrase l'agent actuel avec le fichier zip fourni.
• Importer depuis un fichier ZIP : ajoute des intents et des entités à l'agent actuel à partir du fichier zip fourni. Si des intents ou entités existants portent le même nom que ceux du fichier zip, ils seront remplacés.

Ces options sont appliquées au brouillon d'agent. Pour exporter une version de l'agent, chargez-la d'abord en brouillon.

Les éléments suivants sont inclus dans l'exportation d'un agent:

• Intents
• Entités
• La plupart des paramètres de l'agent (voir la liste ci-dessous pour les paramètres exclus)

Les éléments suivants ne sont pas inclus dans l'exportation d'un agent et ne sont pas écrasés lors de l'importation ou de la restauration :

• Nom de l'agent
• Fichiers de modification directe : package.json et index.json
• Paramètres d'intégration
• Édition
• Bases de connaissances et documents de base de connaissances
• Paramètres vocaux
• Journaux d'interaction

La taille maximale de l'agent (contenu non compressé) pour l'importation/la restauration de l'agent ne doit pas dépasser 50 Mo.

Environnements

Pour accéder aux paramètres des environnements, cliquez sur l'onglet Environnements.

Les versions et les environnements vous permettent de déployer plusieurs versions de votre agent dans des environnements distincts et personnalisables. Pour plus d'informations, consultez la section Versions et environnements.

Voix

Pour accéder aux paramètres vocaux, cliquez sur l'onglet Voix.

Il s'agit des paramètres de reconnaissance et de synthèse vocales. Voici les paramètres disponibles :

• Améliorer la qualité de la reconnaissance vocale
  • Activer les modèles vocaux avancés et l'enregistrement de données : consultez la section Journalisation des données et modèles vocaux optimisés.
  • Activer l'adaptation vocale automatique : consultez la section Adaptation vocale automatique.
• Synthèse vocale
  • Activer la synthèse vocale automatique : convertit automatiquement les réponses textuelles par défaut en paroles (contenu audio) dans toutes les conversations. Reportez-vous à la section Détecter les intents avec sortie audio.
  • Configuration vocale :
    • Langue de l'agent : choisissez la langue par défaut pour la synthèse vocale.
    • Voix : sélectionnez un modèle pour la synthèse vocale.
    • Débit vocal : règle le débit vocal.
    • Pitch (Hauteur) : règle la hauteur (note) de la voix.
    • Volume Gain (Volume) : ajuste le volume audio.
    • Audio Effects Profile (Profil d'effets audio) : sélectionnez les profils d'effets audio que vous souhaitez appliquer à la voix synthétisée. Le signal audio vocal est optimisé pour les périphériques associés aux profils sélectionnés (par exemple, casque, haut-parleur de grande taille, appel téléphonique). Pour obtenir la liste des profils disponibles, consultez la section Utiliser des profils d'appareil pour les contenus audio générés de la documentation sur la synthèse vocale.

Partager

Pour accéder aux paramètres de partage, cliquez sur l'onglet Partager.

Ces paramètres permettent de partager l'accès à l'agent avec d'autres développeurs. Pour en savoir plus, consultez la page Contrôle des accès.

Paramètres avancés

Pour accéder aux paramètres avancés, cliquez sur l'onglet Paramètres avancés.

Actuellement, une seule fonctionnalité est contrôlée à partir de ces paramètres. Pour en savoir plus, consultez la page Analyse des sentiments.