Agents

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

  1. Ouvrez la console Dialogflow CX.
  2. Créez ou choisissez un projet Google Cloud.
  3. Cliquez sur Create Agent (Créer un agent).
  4. Remplissez le formulaire pour les paramètres de base de l'agent :
    1. Vous pouvez choisir n'importe quel nom à afficher.
    2. Sélectionnez votre lieu préféré. Cliquez sur le bouton Modifier si vous souhaitez modifier les paramètres de localisation avancés.
    3. Sélectionnez le fuseau horaire de votre choix.
    4. 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.
  5. Cliquez sur Enregistrer.

API

Si vous n'avez pas encore configuré les paramètres de localisation pour votre projet, vous devez les configurer dans la console avant de créer des agents à l'aide de l'API. Actuellement, vous ne pouvez pas configurer les paramètres de localisation avec l'API.

Pour créer un agent, consultez la méthode create du type Agent.

Sélectionnez un protocole et une version pour la référence de l'agent :

Protocole V3 V3beta1
REST Ressource d'agent Ressource d'agent
RPC Interface de l'agent Interface de l'agent
C++ Agent Agent Non disponible
C# Agent Agent Non disponible
Go Agent Agent Non disponible
Java Agent Agent Agent Agent
Node.js Agent Agent Agent Agent
PHP Non disponible Non disponible
Python Agent Agent Agent Agent
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

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez le projet Google Cloud pour l'agent.
  3. Recherchez l'agent dans la liste.
  4. Cliquez sur le nom à afficher de l'agent.
  5. 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 l'application des données à différents niveaux, consultez les niveaux de l'application de données.

Paramètres de l'agent

Pour accéder aux paramètres de l'agent :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Cliquez sur Agent Settings (Paramètres de l'agent).
  5. Mettez à jour les paramètres comme vous le souhaitez.
  6. 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 d'agent Ressource d'agent
RPC Interface de l'agent Interface de l'agent
C++ Agent Agent Non disponible
C# Agent Agent Non disponible
Go Agent Agent Non disponible
Java Agent Agent Agent Agent
Node.js Agent Agent Agent Agent
PHP Non disponible Non disponible
Python Agent Agent Agent Agent
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 de 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. Une fois l'agent créé, la langue par défaut ne peut plus être modifiée. Toutefois, vous pouvez effectuer les opérations suivantes:

    1. Exportez l'agent au format JSON.
    2. Décompressez le fichier téléchargé.
    3. Recherchez le fichier agent.json.
    4. Mettez à jour les champs defaultLanguageCode et supportedLanguageCodes avec les valeurs souhaitées.
    5. Restaurez l'agent sur le même agent ou sur l'agent obtenu à l'étape 1.
    6. Mettez à jour les phrases d'entraînement et les valeurs d'entité spécifiques à la langue si nécessaire.
  • Verrouillage de l'agent

    • Verrouiller l'agent

      Indique si l'agent est verrouillé. Impossible de modifier un agent verrouillé.

  • Paramètres de journalisation

    • Activer Stackdriver 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é.

  • BigQuery

    • Activer BigQuery Export

      Indique si l'exportation vers BigQuery est activée.

    • Ensemble de données BigQuery

      Nom de l'ensemble de données BigQuery.

    • BigQuery table

      Le nom de la table BigQuery

  • Modèle de charge utile personnalisé

    Dans cette section, vous pouvez créer des descriptions et des charges utiles pour les modèles de charges utiles personnalisées.

Pour en savoir plus sur l'application des données à différents niveaux, consultez les niveaux de l'application de données.

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 pour toutes les langues compatibles avec Dialogflow, mais est actuellement limitée à certaines régions spécifiques.

    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 (par défaut).
    • Avancé : technologie NLU avancée. Ce type de NLU est plus performant que la version standard, en particulier pour les agents et flux volumineux. L'entraînement du modèle sera plus long que celui de la NLU standard.
  • 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 réaliser un entraînement manuel si nécessaire pour les flux volumineux.

  • 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 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), paramètres de page (s'applique à la page et remplace les paramètres de flux et d'agent) et les paramètres de fulfillment (s'applique au fulfillment) et remplace les paramètres de page, 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.

    • Sensibilité de la fin de voix

      Contrôle la sensibilité de la reconnaissance de fin de voix dans les entrées audio de l'utilisateur final. La valeur varie de 0 (faible sensibilité, probabilité plus faible de fin de voix) à 100 (haute sensibilité, probabilité plus élevée de fin de voix).

    • Délai avant expiration de la reconnaissance vocale

      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.

    • Barge-in

      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 arrête la lecture du contenu audio de tous les messages en file d'attente avec la fonctionnalité de désynchronisation (barge-in) activée.

    • URI Google Cloud Storage

      Si elles sont fournies, toutes les données audio associées à une requête seront enregistrées dans le bucket Cloud Storage:

      Enregistrement audio enregistré Demandes applicables
      Entrée audio de l'utilisateur final DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent
      Audio de la synthèse vocale (TTS) synthétisé pour obtenir 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.

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.

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, puis le restaurer à l'aide de ce fichier.

Une exportation d'agent inclut toutes les données de l'agent, à l'exception des suivantes:

  • Versions de flux : seuls les brouillons sont exportés vers un fichier.
  • Environnements : les environnements personnalisés ne sont pas exportés dans le fichier.

La restauration d'un agent écrase toutes les données de l'agent cible (y compris toutes les versions de flux), à l'exception des suivantes:

  • 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. Cependant, ces versions de flux non actualisées ne sont pas répertoriées ni sélectionnables pour l'agent.

Lors de l'exportation, vous pouvez sélectionner le format de fichier d'exportation. Si vous utilisez la gestion des versions pour le contrôle des sources de vos données d'agent, vous devez exporter au format JSON. Lorsque vous restaurez un agent, Dialogflow détermine automatiquement le format de fichier.

Pour exporter ou restaurer un agent :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez le projet Google Cloud pour l'agent.
  3. Cliquez sur le menu Option d'un agent dans la liste.
  4. Cliquez sur le bouton Exporter ou Restaurer.
  5. 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 d'agent Ressource d'agent
RPC Interface de l'agent Interface de l'agent
C++ Agent Agent Non disponible
C# Agent Agent Non disponible
Go Agent Agent Non disponible
Java Agent Agent Agent Agent
Node.js Agent Agent Agent Agent
PHP Non disponible Non disponible
Python Agent Agent Agent Agent
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

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez le projet Google Cloud pour l'agent.
  3. Cliquez sur le menu Option d'un agent dans la liste.
  4. Cliquez sur le bouton Supprimer .
  5. 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 d'agent Ressource d'agent
RPC Interface de l'agent Interface de l'agent
C++ Agent Agent Non disponible
C# Agent Agent Non disponible
Go Agent Agent Non disponible
Java Agent Agent Agent Agent
Node.js Agent Agent Agent Agent
PHP Non disponible Non disponible
Python Agent Agent Agent Agent
Ruby Non disponible Non disponible

Si vous supprimez votre projet, tous les agents Dialogflow CX et les données associées au projet sont immédiatement supprimés.