Configurar a Integração do bate-papo IBM Watson Assistant para a API V2 do assistente

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • Configure a IBM Watson Assistant Integração de bate-papo para executar uma habilidade de diálogo (conversa) criada em IBM Watson Assistant com a API V2 do assistente. A API V2 permite que o cliente de bate-papo da web Virtual Agent execute um tópico que usa o recurso de desambiguação de intenção do Watson Assistant para melhorar a descoberta de tópico.

    Antes de Iniciar

    Com a integração de bate-papo da API V2 IBM Watson Assistant, o cliente de bate-papo da web se comunica com um assistente em vez de com um espaço. Os espaços são chamados de habilidades de diálogo. Para obter mais informaçõesIBM Watson Assistant, consulte Migrar para a API V2, na documentaçãoIBM Watson Assistant.

    Função necessária: virtual_agent_admin ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Essa integração executa um diálogo IBM Watson Assistant como um tópico Virtual Agent no cliente de bate-papo da web. Não é necessário habilitar o Compreensão da linguagem natural (NLU) ou definir o IBM Watson Assistant NLU como provedor de serviço de NLUpara Virtual Agent.

    A API V2 IBM Watson Assistant permite que o cliente de bate-papo da web use o recurso de desambiguação de intenção do Watson Assistant, o que pode reduzir potencialmente as previsões de intenção de falso-positivos. Se o enunciado de um usuário for ambíguo, IBM Watson Assistant a API sugerirá intenções adicionais que podem corresponder melhor à verdadeira intenção do usuário. Por exemplo, se o enunciado do usuário for restaurante, IBM Watson Assistant ela poderá sugerir outras intenções possíveis, como reservar um restaurante ou avaliações de restaurantes.

    Procedimento

    1. Configure IBM Watson Assistant.
      1. Crie seu assistente e adicione uma habilidade de diálogo.
        Para obter detalhes, consulte Como criar um assistente na documentaçãoIBM Watson Assistant.
      2. Na página da lista de recursos, localize e registre a chave da API e a URL necessários para configurar a integração do bate-papo:
        Página da lista de recursos em IBM Watson Assistant, que mostra a chave de API e os valores de URL do assistente.
      3. Selecione o ícone de três pontos verticais e selecione Configurações.
        • Selecione a guia Detalhes API.
        • Na página Configurações do assistente, localize a chave do ID do Assistente.

        IBM Watson Assistant Configurações para a habilidade de diálogo a ser usada. Os detalhes da API e o ID do assistente são realçados aqui.

    2. Habilite o recurso de desambiguação em IBM Watson Assistant (somente para usuários premium e plus).
      É possível habilitar (ou desabilitar) a desambiguação para cada habilidade e também especificar uma mensagem de desambiguação e o número de sugestões a serem exibidas para o usuário final.
      1. Acesse sua habilidade clicando no ícone da árvore de habilidades no painel.
        Lista de assistentes em IBM Watson Assistant com o ícone da árvore de habilidades realçado.
      2. Navegar até Opções > Desambiguação para habilitar a desambiguação e definir os recursos de desambiguação.
        O exemplo a seguir mostra os recursos de desambiguação que podem ser definidos, como a mensagem de desambiguação e o número de intenções sugeridas a serem exibidas para o usuário final.

        Formulário de desambiguação em IBM Watson Assistant. As opções guia de desambiguação, alternância de ativação/desativação, mensagem de desambiguação, qualquer outra mensagem e o máximo de sugestões são realçadas.

    3. Navegue para a opção Diálogo, selecione um nó ao qual o recurso de desambiguação será aplicado e forneça um resumo do nó que será exibido para os usuários caso seja uma das sugestões de intenção.
      Nó de diálogo com um resumo da finalidade do nó exibido para os usuários como uma opção de intenção alternativa para desambiguação. O resumo do nó opcional está realçado.
    4. Em sua instância ServiceNow, ative os seguintes plug-ins:
      • Glide Virtual Agent (com.glide.cs.chatbot), se ainda não estiver ativado (requer assinatura)
      • Plug-in da Integração do Watson Assistant do IBM V2 (com.glide.cs.ibm.watson.assistant.topicV2)
    5. Em Designer do Virtual Agent, publique o tópico IBM Watson Assistant V2:
      1. Navegar até Todos > Interfaces conversacionais > Virtual Agent > Designer.
      2. Na página Tópicos, selecione o tópico IBM Watson Assistant V2 para abrir a página Propriedades do tópico.
        Observe que a palavra-chave desse tópico é IBM Watson Assistant V2.
      3. Na página Propriedades do tópico, clique em Publicar para implantar o tópico no seu cliente Web Virtual Agent.
    6. Navegue até Tudo e insira sys_properties.list no filtro.
    7. Atualize as seguintes propriedades.

      • watson_assistant.v2.assistantID - No campo Valor, insira o ID do Watson Assistant do seu assistente e clique em Atualizar.

        Formulário Propriedade do sistema para a propriedade watson_assistant.v2.assistantID. Exemplo de valor do ID do Watson Assistant e botão Atualizar são realçados.

      • watson_assistant.v2.service_endpoint - No campo Valor, substitua o valor existente pela URL do Watson Assistant e clique em Atualizar.

        Formulário para a propriedade watson_assistant.v2.service_endpoint. com o valor de URL de exemplo e o botão Atualizar realçado.
        Nota:
        É possível especificar apenas a parte do local da URL da instância de serviço no campo Valor. Por exemplo, se a URL base do endpoint de serviço do IBM Watson for https://gateway.watsonplatform.net/assistant/api, você poderá inserir apenas o local da instância de serviço, gateway.watsonplatform.net no campo Valor.

        Se o Watson Assistant estiver hospedado em um data center que não seja Dallas, como Washington DC, a URL base será https://gateway-wdc.watsonplatform.net/assistant/api. Nesse caso, você deve inserir gateway-wdc.watston.platform.net no campo Valor.

    8. Defina a chave da API do Watson Assistant como a senha no perfil IBM Watson Assistant.
      1. Navegue até Todos e insira sys_auth_profile_basic.list no filtro.
      2. Abra o Registro de perfil IBM Watson Assistant.
      3. No formulário Configuração de autenticação básica, insira a chave da API do Watson Assistant no campo Senha e clique em Atualizar.
        Configuração de autenticação básica para o perfil IBM Watson Assistant, com o campo Senha e o botão Atualizar realçados.
    9. Adicione o cliente Virtual Agent (bate-papo da Web) ao Portal de serviços.
      1. Navegar até Portal de serviços > Configuração do Portal de serviços.
      2. Clique em Designer, em seguida, na página principal do Portal de serviços.
      3. Pesquise o Virtual Agent widget e arraste-o para a área destacada.
        O ícone de bate-papo roxo aparece no canto inferior direito.

        Portal de serviços página do designer com Virtual Agent Portal de serviços Widget, tela de design e ícone de bate-papo realçados.

    10. Configure o Virtual Agent widget do Virtual Agent clicando no ícone de edição no canto superior direito para definir os parâmetros da URL passados para o cliente de bate-papo e mudar a cor do botão de bate-papo flutuante.
      1. No campo Parâmetros da URL do cliente do Virtual Agent, insira o parâmetro sysparm_skip_load_history=true para que o histórico do tópico não seja exibido no cliente de bate-papo e o parâmetro sysparm_topic com o sys_id do tópico do Watson Assistant do IBM V2 publicado a ser executado.
        Você pode encontrar o sys_id de um tópico na tabela Tópicos [sys_cs_topic].

        Se você não configurar o comportamento da instância no Portal de serviços, poderá especificar a URL da instância com os parâmetros sysparm_topic e sysparm_skip_load_history ao abrir o cliente Web de bate-papo. Por exemplo: https://<a URL da sua instância>$sn-va-web-client-app.do?sysparm_skip_load_history=true&sysparm_topic=<sys_id> , em que <sys_id> é o sys_id do tópico V2 a ser executadoIBM Watson Assistant.

        Importante:

        Use o parâmetro sysparm_topic somente para carregar o tópico fornecido no cliente de bate-papo Portal de serviços ou ao usar as integrações de bate-papo do IBM Watson Assistant (plug-ins com.glide.cs.ibm.watson.assistant.topic e com.glide.cs.ibm.watson.assistant.topicV2). Esse parâmetro não permite que os usuários iniciem uma nova conversa ou transfiram para um atendente. Ele também desativa o menu de contexto e não é compatível com outros clientes de bate-papo de terceiros.

      2. Para mudar a cor do botão flutuante, insira a nova cor (formato hexadecimal RGB) no campo Cor do botão flutuante.
      3. Selecione Salvar.
        Portal de serviços página do designer com a caixa de diálogo Instância aberta. O campo Parâmetros de URL do cliente do Virtual Agent está realçado.
    11. Teste se o recurso de desambiguação está funcionando para o seu tópico.
      Certifique-se de que a desambiguação esteja habilitada para sua habilidade do Watson Assistant e pelo menos dois nós de diálogo. No exemplo a seguir, o Virtual Agent fornece quatro intenções adicionais que podem ser selecionadas pelo usuário.
      Figura 1. Tópico de exemplo com desambiguação
      Virtual Agent Conversa do que mostra as intenções adicionais descobertas por meio do recurso de desambiguação.