L'analisi del sentiment esamina l'input utente dell'utente e identifica l'opinione soggettiva prevalente, soprattutto per determinare l'atteggiamento di un utente come positivo, negativo o neutro. Quando effettui una richiesta di rilevamento dell'intent, puoi specificare che venga eseguita l'analisi del sentiment e la risposta conterrà i valori dell'analisi del sentiment.
L'API Natural Language viene utilizzata da Dialogflow per eseguire questa analisi. Per saperne di più su questa API e sulla documentazione relativa all'interpretazione dei risultati dell'analisi del sentiment di Dialogflow:
Lingue supportate
Per un elenco delle lingue supportate, consulta la colonna Sentimento nella pagina
Lingue.
Se richiedi l'analisi del sentiment per una lingua non supportata,
la richiesta di rilevamento dell'intent non ha esito negativo,
ma il campo QueryResult.diagnostic_info
contiene informazioni sull'errore.
Prima di iniziare
Questa funzionalità è applicabile solo quando si utilizza l'API per le interazioni con gli utenti finali. Se utilizzi un'integrazione, puoi saltare questa guida.
Prima di leggere questa guida, devi:
- Leggi Nozioni di base su Dialogflow.
- Esegui la procedura di configurazione.
Crea un agente
Se non hai ancora creato un agente, creane uno ora:
- Vai alla console Dialogflow ES.
- Se richiesto, accedi alla console Dialogflow. Per ulteriori informazioni, consulta la panoramica della console di Dialogflow.
- Fai clic su Crea agente nel menu della barra laterale a sinistra. Se hai già altri agenti, fai clic sul nome dell'agente, scorri verso il basso e fai clic su Crea nuovo agente.
- Inserisci il nome, la lingua predefinita e il fuso orario predefinito dell'agente.
- Se hai già creato un progetto, inseriscilo. Se vuoi consentire alla console Dialogflow di creare il progetto, seleziona Crea un nuovo progetto Google.
- Fai clic su pulsante Crea.
Importa il file di esempio nell'agente
I passaggi di questa guida si basano su ipotesi relative al tuo agente, quindi devi importare un agente preparato per questa guida. Durante l'importazione, questi passaggi utilizzano l'opzione Ripristina, che sovrascrive tutte le impostazioni, gli intent e le entità dell'agente.
Per importare il file:
-
Scarica il file
room-booking-agent.zip
. - Vai alla console Dialogflow ES.
- Seleziona il tuo agente.
- Fai clic sul pulsante Impostazioni settings accanto al nome dell'agente.
- Seleziona la scheda Esporta e importa.
- Seleziona Ripristina da ZIP e segui le istruzioni per ripristinare il file ZIP che hai scaricato.
Impostazioni dell'agente per l'analisi del sentiment
Puoi attivare l'analisi del sentiment per ogni richiesta di rilevamento dell'intent oppure puoi configurare l'agente in modo che restituisca sempre i risultati dell'analisi del sentiment.
Per attivare l'analisi del sentiment per tutte le query:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.
- Seleziona la scheda Avanzate.
- Attiva l'opzione Abilita l'analisi del sentiment per la query corrente.
Utilizzare il simulatore di Dialogflow
Puoi interagire con l'agente e ricevere i risultati dell'analisi del sentiment tramite il simulatore Dialogflow:
Digita "Grazie per l'aiuto".
Consulta la sezione SENTIMENT nella parte inferiore del simulatore. Dovrebbe mostrare un punteggio di sentiment positivo.
Poi, digita "Non ha funzionato per niente" nel simulatore.
Consulta la sezione SENTIMENT nella parte inferiore del simulatore. Dovrebbe mostrare un punteggio del sentiment negativo.
Rilevare l'intento
Per rilevare l'intent,
chiama il metodo detectIntent
sul
tipo Sessions
.
REST
Chiama il metododetectIntent
e fornisci il campo sentimentAnalysisRequestConfig
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- SESSION_ID: un ID sessione
Metodo HTTP e URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/sessions/SESSION_ID:detectIntent
Corpo JSON della richiesta:
{ "queryParams": { "sentimentAnalysisRequestConfig": { "analyzeQueryTextSentiment": true } }, "queryInput": { "text": { "text": "please reserve an amazing meeting room for six people", "languageCode": "en-US" } } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "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 } } } }
Nota che il campo sentimentAnalysisResult
contiene i valori score
e magnitude
.
Java
Per eseguire l'autenticazione in Dialogflow, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Dialogflow, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Dialogflow, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.