El análisis de sentimiento inspecciona la entrada del usuario e identifica la opinión subjetiva predominante, sobre todo para determinar si la actitud del usuario es positiva, negativa o neutra. Cuando hagas una solicitud de detección de intent, puedes especificar que se realice un análisis de sentimiento y la respuesta contendrá los valores de dicho análisis.
Dialogflow usa la API Natural Language para realizar este análisis. Para obtener más información sobre esa API y documentación sobre cómo interpretar los resultados del análisis de sentimientos de Dialogflow, consulta los siguientes recursos:
Idiomas disponibles
Para ver una lista de los idiomas admitidos, consulta la columna Sentimiento de la página Idiomas.
Si solicitas el análisis de sentimiento de un idioma no admitido,
tu solicitud de detección de intención no falla,
pero el campo QueryResult.diagnostic_info
contiene información de error.
Antes de empezar
Esta función solo se aplica cuando se usa la API para las interacciones con el usuario final. Si usas una integración, puedes saltarte esta guía.
Antes de leer esta guía, debes hacer lo siguiente:
- Consulta los conceptos básicos de Dialogflow.
- Sigue los pasos de configuración.
Crear un agente
Si aún no has creado un agente, hazlo ahora:
- Ve a la consola de Dialogflow ES.
- Si se te solicita, inicia sesión en la consola de Dialogflow. Para obtener más información, consulta el artículo Información general sobre la consola de Dialogflow.
- En el menú de la barra lateral de la izquierda, haz clic en Crear agente. Si ya tienes otros agentes, haz clic en el nombre del agente, desplázate hasta la parte inferior y haz clic en Crear nuevo agente.
- Introduce el nombre, el idioma predeterminado y la zona horaria predeterminada del agente.
- Si ya has creado un proyecto, accede a él. Si quieres permitir que la consola de Dialogflow cree el proyecto, selecciona Crear un proyecto de Google.
- Haz clic en el botón Crear.
Importar el archivo de ejemplo a tu agente
En los pasos de esta guía se presupone que tienes un agente, por lo que debes importar un agente preparado para esta guía. Al importar, estos pasos utilizan la opción Restaurar, que sobrescribe todos los ajustes, las intenciones y las entidades del agente.
Para importar el archivo, sigue estos pasos:
-
Descarga el archivo
room-booking-agent.zip
. - Ve a la consola de Dialogflow ES.
- Selecciona tu agente.
- Haz clic en el botón de configuración settings situado junto al nombre del agente.
- Selecciona la pestaña Exportar e importar.
- Selecciona Restaurar desde ZIP y sigue las instrucciones para restaurar el archivo ZIP que has descargado.
Configuración del agente para el análisis de sentimiento
Puede activar el análisis de sentimiento por cada solicitud de detección de intención o configurar su agente para que siempre devuelva los resultados del análisis de sentimiento.
Para habilitar el análisis de sentimiento en todas las consultas, sigue estos pasos:
- Ve a la consola de Dialogflow ES.
- Selecciona un agente.
- Haz clic en el botón de configuración settings situado junto al nombre del agente.
- Selecciona la pestaña Avanzado.
- Activa Habilitar análisis de sentimiento para la consulta actual.
Usar el simulador de Dialogflow
Puedes interactuar con el agente y recibir los resultados del análisis de sentimiento a través del simulador de Dialogflow:
Escribe "Gracias por ayudarme".
Consulta la sección SENTIMENT (SENTIMIENTO) en la parte inferior del simulador. Debería mostrar una puntuación de sentimiento positiva.
A continuación, escribe "No ha funcionado en absoluto" en el simulador.
Consulta la sección SENTIMENT (SENTIMIENTO) en la parte inferior del simulador. Debería mostrar una puntuación de sentimiento negativa.
Detectar un intent
Para detectar la intención, llama al método detectIntent
del tipo Sessions
.
REST
Llama al métododetectIntent
y proporciona el campo sentimentAnalysisRequestConfig
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: tu ID de proyecto de Google Cloud
- SESSION_ID: un ID de sesión
Método HTTP y URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/sessions/SESSION_ID:detectIntent
Cuerpo JSON de la solicitud:
{ "queryParams": { "sentimentAnalysisRequestConfig": { "analyzeQueryTextSentiment": true } }, "queryInput": { "text": { "text": "please reserve an amazing meeting room for six people", "languageCode": "en-US" } } }
Para enviar tu solicitud, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{ "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 } } } }
Verá que el campo sentimentAnalysisResult
contiene los valores score
y magnitude
.
Java
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.