Les agents disposent de nombreux paramètres qui affectent leur comportement. Chaque console propose des paramètres différents.
Paramètres de l'agent de la console Dialogflow CX
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 l'agent vers la Format JSON :
- Décompressez le fichier téléchargé.
- Recherchez le fichier
agent.json
. - Mettez à jour
defaultLanguageCode
etsupportedLanguageCodes
. par les valeurs souhaitées. - Restaurer l'agent au même agent ou à 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.
-
Bloquer l'agent
Indique si l'agent est verrouillé. Un agent verrouillé ne peut pas être modifié.
-
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 pour améliorer la qualité.
Activer la masquage des entrées utilisateur final sur la base du consentement
Si ce paramètre est activé, vous pouvez utiliser un paramètre de session spécial pour contrôler si les entrées et les paramètres de l'utilisateur final sont masqués dans l'historique des conversations et dans les journaux Cloud. Par défaut, le paramètre de session est
true
. Si ce paramètre est désactivé, aucun masquage n'est effectué.Le consentement de l'utilisateur est recueilli à l'aide d'un paramètre de session booléen :
$session.params.conversation-redaction
. Si ce paramètre est activé et que le paramètre de session est défini surfalse
, aucune suppression n'est effectuée (les autres stratégies de suppression s'appliquent toujours). Si ce paramètre est activé et que le paramètre de session est défini surtrue
, la suppression est effectuée.Voici un exemple de flux de demande de consentement : demandez d'abord à l'utilisateur s'il souhaite conserver l'entrée de l'utilisateur final, puis faites correspondre la réponse à deux intents, l'un étant "intent oui" et l'autre "intent non". Définissez ensuite le paramètre de session sur
false
(aucune suppression) dans les préréglages de paramètre de la route "intent oui" dans le fulfillment, et surtrue
(suppression effectuée) dans le préréglage de paramètre de la route "aucun intent".
-
Activer l'exportation vers BigQuery
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 suggestions d'intent.
Modèle de charge utile personnalisé
Dans cette section, vous pouvez créer des descriptions et des charges utiles pour des modèles de charge utile personnalisés.
Paramètres de ML
Les agents conversationnels (Dialogflow CX) utilisent 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. Les agents conversationnels (Dialogflow CX) apprennent à partir des expressions d'entraînement que vous fournissez et des modèles de langage intégrés aux agents conversationnels (Dialogflow CX). 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, et le modèle créé par les agents conversationnels (Dialogflow CX) 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, en anglais, en espagnol, en français et en italien. Il est disponible dans toutes les régions des agents conversationnels (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 :
- NLU avancé (par défaut) : technologie NLU avancée. Ce type de NLU fonctionne mieux que la norme, en particulier pour les grands agents et flux.
- NLU standard : technologie NLU standard. Volonté ne bénéficient plus des 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 une variété des entrées correspondantes en langage naturel pour l'agent, vous pouvez régler le seuil de classification de l'apprentissage. 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 au seuil , puis un événement sans correspondance est appelé.
Vous pouvez définir une valeur de seuil de classification distincte pour chaque flux dans chaque langue activée pour l'agent. afin de s'adapter aux différentes langues à différents seuils de classification. Pour plus d'informations sur la création d'un agent multilingue, consultez la documentation sur les agents multilingues.
-
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
-
Liste des expressions interdites pour l'IA générative. Si une expression interdite apparaît dans l'invite ou dans la réponse générée, la génération échoue.
-
Configurez les niveaux de sensibilité des filtres de sécurité en fonction des différentes catégories d'IA responsable. Les contenus seront évalués en fonction des quatre catégories suivantes :
Catégorie Description Incitation à la haine Commentaires négatifs ou offensants ciblant l'identité et/ou les attributs protégés. Contenu dangereux Encourage ou facilite l'accès à des activités, produits et services dangereux Contenu à caractère sexuel explicite Contient des références à des actes sexuels ou à d'autres contenus obscènes Harcèlement Commentaires malveillants, intimidants ou abusifs ciblant une autre personne Le contenu est bloqué s'il est susceptible d'être nuisible. Le niveau de sensibilité peut être personnalisé en choisissant l'une des options Bloquer quelques, Bloquer une partie ou Tout bloquer pour chaque catégorie. Vous pouvez également accéder à l'option Ne rien bloquer, qui désactive les vérifications RAI pour la catégorie après avoir envoyé une demande de confirmation des risques pour votre projet et reçu l'approbation.
Pour en savoir plus, consultez la section Configurer les attributs de sécurité.
-
Vous pouvez cocher le paramètre enable prompt security check (Activer le contrôle de sécurité immédiat) pour activer les contrôles de sécurité immédiats. Lorsque cette option est activée, l'agent tentera d'empêcher les attaques par injection de requête. Ces attaques peuvent servir à révéler des parties de l'invite de l'agent ou pour fournir des réponses que l'agent n'est pas censé fournir. Pour ce faire, une requête LLM supplémentaire est envoyée qui vérifie si la requête de l'utilisateur est potentiellement malveillante.
Ce paramètre est activé par défaut pour les nouveaux agents. Si votre agent a été créé avant la publication de ce paramètre, il n'est pas activé.
-
Agent génératif
Sélection d'un modèle génératif
Sélectionner le modèle utilisé par les caractéristiques génératives Pour plus d'informations, Consultez la section Versions de modèle.
Retour génératif
Configuration des requêtes textuelles
Consultez Remplacement génératif: définir votre propre requête.
Datastore
Consultez Paramètres de l'agent du 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 boîte de dépôt de sélection et indiquez le nom de la voix personnalisée dans la section . Le nom vocal personnalisé 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 autorisé avec "Prédicteur AutoML" dans votre projet de voix personnalisée. - Pour les appels d'API réguliers, assurez-vous que le compte de service utilisé pour appeler les agents conversationnels (Dialogflow CX) se voit attribuer le rôle "Prédicteur AutoML" dans votre projet de voix personnalisée.
- 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.
-
Pour en savoir plus sur les options avancées de synthèse vocale, consultez le guide Paramètres avancés de synthèse vocale.
DTMF
Consultez la section DTMF pour les intégrations de téléphonie afin de découvrir plus d'informations.
Multimode
Consultez Compagnon d'appel.
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. Consultez le documentation sur la détection automatique des langues pour en savoir plus.
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.
Paramètres de la console Agent Builder
Cette section décrit les paramètres disponibles pour les applications d'agent.
Général
Les paramètres généraux suivants sont disponibles pour les applications d'agent:
-
Nom lisible de votre application d'agent.
-
Région de l'application agent.
-
Si cette option est activée, vous n'êtes pas autorisé à modifier l'application de l'agent.
Journalisation
Les paramètres de journalisation suivants sont disponibles pour les applications de l'agent:
-
Si cette option est activée, les journaux sont envoyés à Cloud Logging.
Activer l'historique des conversations
Si cette option est activée, historique de la conversation sera disponible. Indique si vous souhaitez que Google collecte et stocke les requêtes des utilisateurs finaux masquées. pour améliorer la qualité. Ce paramètre n'a aucune incidence sur l'utilisation de l'historique des conversations pour générer des réponses d'agent.
-
Si cette option est activée, l'historique des conversations est exporté vers BigQuery. Le paramètre Activer l'historique des conversations doit également être activé.
IA générative
Les paramètres d'IA générative suivants sont disponibles pour les applications agents:
Sélection d'un modèle génératif
Sélectionnez l'icône modèle génératif que les agents doivent utiliser par défaut.
-
Sélectionnez la limite de jetons d'entrée pour le modèle génératif. Il s'agit de la taille maximale du jeton pour les entrées envoyées au modèle. Selon le modèle, un jeton peut être compris entre un caractère et un mot. Les limites de jeton plus faibles réduisent la latence, mais la taille d'entrée du modèle est limitée. Les limites de jetons plus élevées ont une latence plus élevée, mais la taille d'entrée du modèle peut être plus importante.
-
Sélectionnez la limite de jetons de sortie pour le modèle génératif. Il s'agit de la taille maximale des jetons pour la sortie reçue du modèle. Selon le modèle, un jeton peut être compris entre un caractère et un mot. Avec des limites de jetons plus faibles, la latence est plus faible. mais la taille de sortie du modèle est limitée. Les limites de jeton plus élevées entraînent une latence plus élevée, mais la taille de sortie du modèle peut être plus importante.
-
La température d'un LLM vous permet de contrôler le degré de créativité des réponses. Une valeur faible permet d'obtenir des réponses plus prévisibles. Une valeur élevée fournit des réponses plus créatives ou aléatoires.
-
Liste des expressions interdites pour l'IA générative. Si une expression interdite apparaît dans l'invite ou dans la réponse générée, l'agent renvoie plutôt une réponse de remplacement.
-
Configurez les niveaux de sensibilité des filtres de sécurité en fonction des différentes catégories d'IA responsable. Les contenus seront évalués en fonction des quatre catégories suivantes :
Catégorie Description Incitation à la haine Commentaires négatifs ou offensants ciblant l'identité et/ou les attributs protégés. Contenu dangereux Encourage ou facilite l'accès à des activités, produits et services dangereux Contenu à caractère sexuel explicite Contient des références à des actes sexuels ou à d'autres contenus obscènes Harcèlement Commentaires malveillants, intimidants ou abusifs ciblant une autre personne Le contenu est bloqué s'il est susceptible d'être nuisible. Pour chaque catégorie, vous pouvez personnaliser le niveau de sensibilité en choisissant l'une des options Bloquer peu (blocage des instances à forte probabilité de contenu nuisible), Bloquer certaines (instances de probabilité moyenne et élevée) ou Bloquer la plupart (probabilité faible, moyenne et élevée). Vous pouvez également accéder à l'option Ne rien bloquer, qui désactive les vérifications RAI pour la catégorie après avoir envoyé une demande de confirmation des risques pour votre projet et reçu l'approbation.
Pour en savoir plus, consultez la section Configurer les attributs de sécurité.
-
Vous pouvez cocher le paramètre enable prompt security check (Activer le contrôle de sécurité immédiat) pour activer les contrôles de sécurité immédiats. Lorsque cette option est activée, l'agent tentera d'empêcher les attaques par injection de requête. Ces attaques peuvent servir à révéler des parties de l'invite de l'agent ou pour fournir des réponses que l'agent n'est pas censé fournir. Pour ce faire, une requête LLM supplémentaire est envoyée qui vérifie si la requête de l'utilisateur est potentiellement malveillante.
Ce paramètre est activé par défaut pour les nouveaux agents. Si votre agent a été créé avant le lancement de ce paramètre, le paramètre n'est pas activé.
Git
Ces paramètres permettent une intégration Git. Suivez les instructions pour configurer l'intégration.