L'analyse des sentiments inspecte les entrées de l'utilisateur et identifie l'opinion subjective dominante, en particulier pour déterminer l'attitude d'un utilisateur comme étant positive, négative ou neutre. Lorsque vous effectuez une requête de détection d'intent, vous pouvez spécifier l'utilisation de l'analyse des sentiments. La réponse contiendra ainsi des valeurs d'analyse des sentiments.
L'API Natural Language est utilisée par Dialogflow pour effectuer cette analyse. Pour plus d'informations sur cette API et la documentation sur l'interprétation des résultats de l'analyse des sentiments Dialogflow, consultez les sections suivantes :
Langages acceptés
Pour obtenir la liste des langues acceptées, consultez la colonne Sentiment de la page Langues.
Si vous effectuez une requête d'analyse des sentiments pour une langue non acceptée, votre requête de détection d'intent n'échoue pas, mais le champ QueryResult.diagnostic_info
contient des informations d'erreur.
Avant de commencer
Cette fonctionnalité n'est disponible que lorsque l'API est utilisée pour les interactions de l'utilisateur final. Si vous utilisez une intégration, vous pouvez ignorer ce guide.
Avant de lire ce guide, procédez comme suit :
- Consultez la section Principes de base de Dialogflow.
- Effectuez la procédure de configuration.
Créer un agent
Si vous n'avez pas encore créé d'agent, créez-en un maintenant :
- Accédez à la console Dialogflow ES.
- Si nécessaire, connectez-vous à la console Dialogflow. Consultez la section Présentation de la console Dialogflow pour plus d'informations.
- Cliquez sur Créer un agent dans le menu de la barre latérale de gauche. (Si vous avez déjà d'autres agents, cliquez sur le nom de l'un d'eux, faites défiler vers le bas, puis cliquez sur Créer un agent.)
- Saisissez le nom de l'agent, la langue par défaut et le fuseau horaire par défaut.
- Si vous avez déjà créé un projet, saisissez son nom. Si vous souhaitez autoriser la console Dialogflow à créer le projet, sélectionnez Créer un projet Google.
- Cliquez sur le bouton Créer.
Importer le fichier d'exemple dans l'agent
Dans la mesure où les étapes de ce guide sont fondées sur certaines hypothèses concernant votre agent, vous devez importer un agent préparé pour ce guide. Lors de l'importation, ces étapes utilisent l'option de restauration qui écrase l'ensemble des paramètres, des intents et des entités de l'agent.
Pour importer le fichier, procédez comme suit :
- Téléchargez le fichier
room-booking-agent.zip
. - Accédez à la console Dialogflow ES.
- Sélectionnez votre agent.
- Cliquez sur le bouton des paramètres settings à côté du nom de l'agent.
- Sélectionnez l'onglet Exporter et importer.
- Sélectionnez Restaurer depuis un fichier ZIP et suivez les instructions pour restaurer le fichier ZIP que vous avez téléchargé.
Paramètres de l'agent pour l'analyse des sentiments
Vous pouvez déclencher l'analyse des sentiments par requête de détection d'intent ou configurer votre agent pour qu'il renvoie toujours les résultats de l'analyse des sentiments.
Pour activer l'analyse des sentiments pour toutes les requêtes, procédez comme suit :
- Accédez à la console Dialogflow ES.
- Sélectionnez un agent.
- Cliquez sur le bouton des paramètres settings à côté du nom de l'agent.
- Cliquez sur l'onglet Avancé.
- Activez l'option Activer l'analyse des sentiments pour la requête actuelle.
Utiliser le simulateur Dialogflow
Vous pouvez interagir avec l'agent et recevoir des résultats d'analyse des sentiments via le simulateur Dialogflow :
Saisissez "Merci de votre aide".
Consultez la section SENTIMENT au bas du simulateur. Un score de sentiment positif doit s'afficher.
Ensuite, saisissez "Cela n'a pas fonctionné" dans le simulateur.
Consultez la section SENTIMENT au bas du simulateur. Un score de sentiment négatif doit s'afficher.
Détecter un intent
Pour détecter l'intent, appelez la méthode detectIntent
du type Sessions
.
REST
Appelez la méthodedetectIntent
et renseignez le champ sentimentAnalysisRequestConfig
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- SESSION_ID : un ID de session
Méthode HTTP et URL :
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/sessions/SESSION_ID:detectIntent
Corps JSON de la requête :
{ "queryParams": { "sentimentAnalysisRequestConfig": { "analyzeQueryTextSentiment": true } }, "queryInput": { "text": { "text": "please reserve an amazing meeting room for six people", "languageCode": "en-US" } } }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "responseId": "747ee176-acc5-46be-8d9a-b7ef9c2b9199", "queryResult": { "queryText": "please reserve an amazing meeting room for six people", "action": "room.reservation", "parameters": { "date": "", "duration": "", "guests": 6, "location": "", "time": "" }, "fulfillmentText": "I can help with that. Where would you like to reserve a room?", ... "sentimentAnalysisResult": { "queryTextSentiment": { "score": 0.8, "magnitude": 0.8 } } } }
Notez que le champ sentimentAnalysisResult
contient les valeurs score
et magnitude
.
Java
Pour vous authentifier auprès de Dialogflow, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour vous authentifier auprès de Dialogflow, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour vous authentifier auprès de Dialogflow, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.