Integração de Virtual Agent com IBM Watson Assistant para a API V2 do Assistente

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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 widget de bate-papo 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ópicos.

    Antes de Iniciar

    Nota:
    Uma interface do usuário Designer do Virtual Agent atualizada está disponível quando você instala Now Assist em Virtual Agent e ativa a habilidade Now Assist Tópicos. Este conteúdo pressupõe que você ativou esta habilidade e pode ver a exibição de lista. Se esta habilidade não estiver ativada, você verá a IU legada e a página de tópicos. Para obter mais informações, consulte a página de tópicos legados do Designer do Virtual Agent.

    Com a integração de bate-papo da API IBM Watson Assistant v2, o widget de bate-papo 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 admin

    Por Que e Quando Desempenhar Esta Tarefa

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

    A IBM Watson Assistant V2 API permite que o widget de bate-papo use o recurso de desambiguação de intenção do Watson Assistant, o que pode reduzir potencialmente as previsões de intenção falso-positivas. 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 Ícone de mais ações. 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 selecionando o ícone da árvore de habilidades Í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é Interfaces conversacionais > Virtual Agent > Designer e selecione a alternância NLU/palavra-chave.Tudo > Interfaces conversacionais > Virtual Agent > Designer.
      2. Na página inicial Designer do Virtual Agent, 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, selecione Publicar para implantar o tópico no widget de bate-papo Virtual Agent.
    6. Navegue até Todos 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 o widget Virtual Agent Portal de serviços, tela de design e ícone de bate-papo realçados.

    10. Configure o widget Virtual Agent selecionando o ícone de edição Ícone de edição. no canto superior direito para definir os parâmetros de 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 em Portal de serviços, poderá especificar o URL da instância com os parâmetros sysparm_topic e sysparm_skip_load_history ao abrir o widget 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 Save (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.