El análisis de opiniones inspecciona las entradas de los usuarios e identifica la opinión subjetiva predominante; en especial para determinar la actitud de un usuario como positiva, negativa o neutral. Cuando se realiza una solicitud de detección de intent, puedes especificar que se realice un análisis de opiniones y la respuesta incluirá valores del análisis de opiniones.
Dialogflow usa la API de Natural Language para realizar este análisis. Si deseas obtener más información sobre esa API y documentación sobre cómo interpretar los resultados del análisis de opiniones de Dialogflow, consulta los siguientes recursos:
Lenguajes compatibles
Para obtener una lista de los idiomas admitidos, consulta la columna Opiniones en la página de idiomas.
Si solicitas un análisis de opiniones para un idioma que no es compatible, tu solicitud de intent de detección no falla, pero el campo QueryResult.diagnostic_info
contiene información de error.
Antes de comenzar
Esta función solo es aplicable cuando se usa la API para las interacciones del usuario final. Si usas una integración, puedes omitir esta guía.
Debes hacer lo siguiente antes de leer esta guía:
- Lee los conceptos básicos de Dialogflow.
- Realiza los pasos de configuración.
Crea un agente
Si aún no creaste un agente, sigue estos pasos para crearlo:
- Ve a la consola de Dialogflow ES.
- Si se te solicita, accede a la consola de Dialogflow. Consulta Descripción general de la consola de Dialogflow para obtener más información.
- Haz clic en Create agent, en el menú de la barra lateral izquierda. (Si ya tienes otros agentes, haz clic en el nombre del agente, desplázate hacia la parte inferior y haz clic en Create new agent).
- Ingresa el nombre del agente, y el idioma y la zona horaria predeterminados.
- Si ya creaste un proyecto, ingrésalo. Si quieres que la consola de Dialogflow cree el proyecto, selecciona Create a new Google project.
- Haz clic en el botón Create.
Importa el archivo de ejemplo al agente
En los pasos que se brindan en esta guía, se hacen suposiciones sobre tu agente, por lo que debes importar un agente preparado para esta guía. Cuando realizas la importación, en estos pasos se usa la opción restablecer, que reemplaza todas las opciones de configuración, intents y 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 el agente.
- Haz clic en el botón de configuración settings que se encuentra junto al nombre del agente.
- Selecciona la pestaña Export and Import.
- Selecciona Restore From Zip y sigue las instrucciones para restablecer el archivo ZIP que descargaste.
Configuración del agente para el análisis de opiniones
Puedes activar un análisis de opiniones por solicitud de detección de intent, o puedes configurar tu agente para que siempre muestre los resultados del análisis de opiniones.
Si quieres habilitar el análisis de opiniones para todas las consultas, haz lo siguiente:
- Ve a la consola de Dialogflow ES.
- Selecciona un agente.
- Haz clic en el botón de configuración settings junto al nombre del agente.
- Selecciona la pestaña Avanzada.
- Activa Habilitar análisis de opiniones para la consulta actual.
Usa el simulador de Dialogflow
Puedes interactuar con el agente y recibir los resultados del análisis de opiniones a través del simulador de Dialogflow:
Escribe “Gracias por ayudarme”.
Consulta la sección OPINIONES que se encuentra en la parte inferior del simulador. Debería mostrar una puntuación de la opinión positiva.
Luego, escribe “No funcionó.” en el simulador.
Consulta la sección OPINIONES que se encuentra en la parte inferior del simulador. Debería mostrar una puntuación de la opinión negativa.
Detecta intents
Para detectar un intent, llama al método detectIntent
en el tipo Sessions
.
REST
Llama al métododetectIntent
y
proporciona el campo sentimentAnalysisRequestConfig
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto de Google Cloud.
- SESSION_ID: Es 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, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "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 } } } }
Ten en cuenta que el campo sentimentAnalysisResult
contiene los valores score
y magnitude
.
Java
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.