Integração Virtual Agent com IBM Watson Assistant Para API do Assistente V2

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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 habilita o. Virtual Agent Widget de bate-papo para executar 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:
    Atualizado Designer do Virtual Agent a interface do usuário está disponível quando você instala Now Assist em Virtual Agent e ligue o. Now Assist Habilidade de tópicos. Este conteúdo presume 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 Tópicos. Para obter mais informações, consulte Página de tópicos legados do Virtual Agent Designer .

    Com IBM Watson Assistant v2 API de integração de bate-papo, 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 um IBM Watson Assistant caixa de diálogo como um Virtual Agent tópico 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 NLU para Virtual Agent.

    . 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 potencialmente reduzir as previsões de intenção falso-positiva. 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 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 de árvore de habilidades Ícone de árvore de habilidades.no painel .
        Lista de assistentes em IBM Watson Assistantícone de árvore de habilidades realçado.
      2. Navegar até Opções > Desambiguação para habilitar 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 é 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 NLU/palavra-chave alternar.Tudo > Interfaces conversacionais > Virtual Agent > Designer.
      2. Em Designer do Virtual Agent página inicial, selecione 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 seu Virtual Agent widget de bate-papo.
    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 de propriedade do sistema para a propriedade watson_assistant.v2.assistantID. O valor do ID do Watson Assistant e o botão Atualizar estã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. Exemplo de valor de URL e botão Atualizar realçados.
        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 selecionando o ícone de edição Ícone Editar.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, Você pode especificar a URL da instância com sysparm_topice. sysparm_skip_load_historyparâmetros quando você abre o widget de bate-papo 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 caixa de diálogo Abrir instância. 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 mostrando intenções adicionais descobertas por meio do recurso de desambiguação.