Componente Watson Assistant
Esse componente permite criar um motor de conversação conectando-se ao Watson Assistant, a tecnologia de inteligência artificial conversacional da IBM. Para utilizá-lo, é preciso conhecer as credenciais de acesso de uma instância do Watson na IBM Cloud.
Dica
Um nível de confiança mínimo pode ser definido, de modo que só sejam apresentadas as respostas em que o Watson tenha um determinado grau de certeza.
Parâmetro | Obrigatório | Valor Padrão | Descrição |
---|---|---|---|
watson.assistant.version | Sim | 2020-04-01 | Data da versão da API do IBM Watson Assistant no formato YYYY-MM-DD (ex: 2020-04-01)' |
watson.assistant.endpoint | Sim | https://gateway.watsonplatform.net/assistant/api | URL da API do IBM Watson Assistant') |
watson.assistant.apikey | Sim | Chave da API da instância do IBM Watson Assistant | |
watson.assistant.id | Sim | ID da instância do IBM Watson Assistant | |
watson.minimumLevelConfidence | Sim | 0.5 | Nível de confiança mínimo para aceitar uma resposta do IBM Watson Assistant |
Passando Parâmetros
O Serprobots permite que os parâmetros informados através da QueryString da UI sejam repassados para o Watson Assistant. Por exemplo, caso o seu chatbot esteja publicado em https://serprobots.estaleiro.serpro.gov.br/web/meu-chatbot, você pode adicionar a QueryString ?nome=João a essa URL, ficando com https://serprobots.estaleiro.serpro.gov.br/web/meu-chatbot?nome=João.
Neste caso, o parâmetro nome chegará até o Watson Assistant como uma variável de contexto, podendo ser acessada apenas usando o prefixo sb_ antes do nome do parâmetro. Por exemplo, para acessar o parâmetro nome usado na QueryString, use a variável de contexto sb_nome no Watson Assistant.
Estilo das Options
O Watson Assistant permite que seja exibida, como resposta a uma pergunta do usuário, uma lista de opções selecionáveis. Por padrão, este formato de resposta é exibido como um conjunto de botões na interface do Serprobots, conforme podemos ver na imagem abaixo.

Entretanto, este formato de exibição pode ser modificado a cada resposta do Watson Assistant. Para alterar este formato, dentro do diálogo do Watson Assistant onde você tem uma resposta do tipo Options, selecione Open Context Editor, conforme a imagem abaixo.

Logo em seguida, conforme a imagem abaixo, crie uma variável de contexto chamada optionsStyle e informe um dos seguintes valores: button, selection ou dropdown. Lembre-se de colocar o valor entre aspas.

Abaixo, você pode ver como serão exibidos os três formatos suportados pelo Serprobots:



Desambiguação
Quando o Watson Assistant fica em dúvida sobre qual diálogo deve escolher como resposta para uma determinada pergunta, pois o nível de semelhança entre os diálogos é muito grande, entra em ação seu mecanismo de desambiguação. Neste mecanismo, o Watson Assistant delega ao usuário a escolha do diálogo, apresentando todos os diálogos semelhantes para o usuário, que deve escolher apenas um para obter uma resposta.
O Serprobots possui suporte nativo ao mecanismo de desambiguação do Watson Assistant, apresentando as opções de desambiguação como uma lista de opções.