A análise de sentimentos inspeciona a entrada do utilizador e identifica a opinião subjetiva predominante, especialmente para determinar a atitude de um utilizador como positiva, negativa ou neutra. Quando faz um pedido de deteção de intenção, pode especificar que a análise de sensação geral seja realizada, e a resposta vai conter valores de análise de sensação geral.
O Dialogflow usa a API Natural Language para realizar esta análise. Para mais informações sobre essa API e documentação sobre a interpretação dos resultados da análise de sentimentos do Dialogflow:
Idiomas suportados
Para ver uma lista dos idiomas suportados, consulte a coluna sentimento na página idiomas.
Se pedir a análise de sentimentos para um idioma não suportado,
o seu pedido de deteção de intenção não falha,
mas o campo QueryResult.diagnostic_info contém informações de erro.
Antes de começar
Esta funcionalidade só se aplica quando usa a API para interações do utilizador final. Se estiver a usar uma integração, pode ignorar este guia.
Antes de ler este guia, deve fazer o seguinte:
- Leia as noções básicas do Dialogflow.
- Realize os passos de configuração.
Crie um agente
Se ainda não tiver criado um agente, crie um agora:
- Aceda à consola do Dialogflow ES.
- Se lhe for pedido, inicie sessão na consola do Dialogflow. Consulte a vista geral da consola do Dialogflow para mais informações.
- Clique em Criar agente no menu da barra lateral esquerda. (Se já tiver outros agentes, clique no nome do agente, desloque a página para baixo e clique em Criar novo agente.)
- Introduza o nome do agente, o idioma predefinido e o fuso horário predefinido.
- Se já tiver criado um projeto, introduza esse projeto. Se quiser permitir que a consola do Dialogflow crie o projeto, selecione Criar um novo projeto Google.
- Clique no botão Criar.
Importe o ficheiro de exemplo para o seu agente
Os passos neste guia baseiam-se em pressupostos sobre o seu agente. Por isso, tem de importar um agente preparado para este guia. Quando importa, estes passos usam a opção restaurar, que substitui todas as definições, intenções e entidades do agente.
Para importar o ficheiro, siga estes passos:
-
Transfira o ficheiro
room-booking-agent.zip. - Aceda à consola do Dialogflow ES.
- Selecione o seu agente.
- Clique no botão Definições settings junto ao nome do agente.
- Selecione o separador Exportar e importar.
- Selecione Restaurar do ZIP e siga as instruções para restaurar o ficheiro ZIP que transferiu.
Definições do agente para a análise de sentimentos
Pode acionar a análise de sentimentos por pedido de intenção de deteção, ou pode configurar o seu agente para devolver sempre resultados da análise de sentimentos.
Para ativar a análise de sentimentos para todas as consultas:
- Aceda à consola do Dialogflow ES.
- Selecione um agente.
- Clique no botão settings de definições junto ao nome do agente.
- Selecione o separador Avançadas.
- Ative a opção Ativar análise de sentimentos para a consulta atual.
Use o simulador do Dialogflow
Pode interagir com o agente e receber resultados da análise de sentimentos através do simulador do Dialogflow:
Escreva "Obrigado por me ajudar."
Consulte a secção SENTIMENTO na parte inferior do simulador. Deve apresentar uma pontuação de sentimento positiva.
Em seguida, escreva "Não funcionou de todo" no simulador.
Consulte a secção SENTIMENTO na parte inferior do simulador. Deve apresentar uma pontuação de sentimento negativa.
Detetar intenção
Para detetar a intenção, chame o método detectIntent no tipo Sessions.
REST
Chame o métododetectIntent e
forneça o campo sentimentAnalysisRequestConfig.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- PROJECT_ID: o ID do seu projeto do Google Cloud
- SESSION_ID: um ID da sessão
Método HTTP e URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/sessions/SESSION_ID:detectIntent
Corpo JSON do pedido:
{
"queryParams": {
"sentimentAnalysisRequestConfig": {
"analyzeQueryTextSentiment": true
}
},
"queryInput": {
"text": {
"text": "please reserve an amazing meeting room for six people",
"languageCode": "en-US"
}
}
}
Para enviar o seu pedido, expanda uma destas opções:
Deve receber uma resposta JSON semelhante à seguinte:
{
"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
}
}
}
}
Tenha em atenção que o campo sentimentAnalysisResult contém os valores score e magnitude.
Java
Para se autenticar no Dialogflow, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Para se autenticar no Dialogflow, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Python
Para se autenticar no Dialogflow, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.