---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Integração Virtual Agentcom IBM Watson AssistantPara a API do Assistente V2

# Integração Virtual Agentcom IBM Watson AssistantPara a API do Assistente V2 {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

Configure o. IBM Watson AssistantIntegração de bate-papo para executar uma habilidade de diálogo (conversa) criada em IBM Watson AssistantCom a API do Assistente V2. A API V2 habilita o. Virtual AgentWidget de bate-papo para executar um tópico que usa o recurso de desambiguação de intenção do Assistente do Watson para melhorar a descoberta de tópicos.

## Antes de Iniciar

Nota:  
Uma interface do usuário atualizada do Designer do Virtual Agent está disponível quando você instala o Now Assist no Virtual Agent e ativa a habilidade "Tópicos do Now Assist". Este conteúdo pressupõe que você ativou essa habilidade e pode ver a exibição de lista. Se você não ativou essa habilidade, você verá a IU e a página de tópicos legadas. Para obter mais informações, consulte a [página de tópicos legados do Designer do Virtual Agent](https://servicenow-prod.fluidtopics.net/dJqoTKj3yBMX0F3rRrlq3w ". Designer do Virtual Agenta página inicial legada lista cartões para tópicos disponíveis em sua instância.").

Com o. IBM Watson Assistantv2 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 informações sobre IBM Watson Assistant, consulte [Migrando para a API v2](https://cloud.ibm.com/docs/services/assistant?topic=assistant-api-migration&locale=en-us#overview)em IBM Watson Assistantdocumentação.

Função necessária: virtual_agent_admin ou admin

## Por Que e Quando Desempenhar Esta Tarefa

Esta integração executa um IBM Watson Assistantcaixa de diálogo como um Virtual Agentno widget de bate-papo. Não requer ativação Compreensão da linguagem natural( NLUou configuração IBM Watson Assistant NLUcomo NLUprovedor de serviços para Virtual Agent.

. IBM Watson AssistantA API V2 permite que o widget de bate-papo use o recurso de desambiguação de intenção do Assistente do Watson, 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 Assistantsugere intenções adicionais que podem corresponder melhor à verdadeira intenção do usuário. Por exemplo, se o enunciado do usuário for <kbd class="ph userinput">restaurante </kbd>, IBM Watson Assistantpode sugerir outras intenções possíveis, como <kbd class="ph userinput">reserve um restaurante </kbd>ou <kbd class="ph userinput">avaliações de restaurantes </kbd>.

## Procedimento

1. Configurar IBM Watson Assistant.
   1. Crie seu assistente e adicione uma habilidade de diálogo.  
      Para obter detalhes, consulte [Criando um assistente](https://cloud.ibm.com/docs/services/assistant?topic=assistant-assistant-add)em IBM Watson Assistantdocumentação.
   2. Na página Lista de recursos, localize e registre sua chave de API e o URL, que você precisa para configurar a integração do bate-papo:  
   3. Selecione o ícone de três pontos verticais ![Ícone Mais ações.]()e selecione Configurações .  
      * Selecione Detalhes da API .
      * Na página Configurações do assistente, encontre ID do assistente chave.

      {#configure-watson-assistant-topicV2__ul_iyb_qn1_hlb}

   {#configure-watson-assistant-topicV2__substeps_alx_zm1_hlb}
2. Habilite o recurso de desambiguação em IBM Watson Assistant(somente para usuários premium e plus).  
   Você pode 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. Selecione o ícone da árvore de habilidades para acessar sua habilidade ![Ícone de árvore de habilidades.]()no painel.  
   2. Navegar até OpçõesDesambiguaçã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 ao usuário final.

   {#configure-watson-assistant-topicV2__substeps_qpx_mt1_hlb}
3. Navegue até Caixa de diálogo , selecione um nó ao qual o recurso de desambiguação será aplicado e forneça um resumo do nó que será exibido aos usuários se for uma das sugestões de intenção.  
4. Em seu ServiceNow, ative estes plug-ins:  
   * Glide Virtual Agent (com.glide.cs.chatbot), se ainda não estiver ativado (requer uma assinatura)
   * Plug-in V2 de integração do Assistente do IBM Watson (com.glide.cs.ibm.watson.assistant.topicV2)
   {#configure-watson-assistant-topicV2__ul_kww_tgg_hlb}
5. Em Designer do Virtual Agent, publique o. IBM Watson AssistantTópico V2:
   1. Navegar até Interfaces conversacionaisVirtual AgentDesigner e selecione NLU/palavra-chave alternância.TudoInterfaces conversacionaisVirtual AgentDesigner.
   2. Em Designer do Virtual Agentpágina inicial, selecione IBM Watson AssistantTópico V2 para abrir a página Propriedades do tópico.  
      Observe que Palavra-chave para este tópico é IBM Watson AssistantV2.
   3. Na página Propriedades do tópico, selecione Publicar para implantar o tópico no Virtual Agentwidget de bate-papo.
   {#configure-watson-assistant-topicV2__substeps_gvk_v2g_hlb}
6. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">sys_properties.list </kbd>no filtro.
7. Atualize as propriedades a seguir.  
   * watson_assistant.v2.assistantID- No Valor Insira o ID do Assistente do Watson para seu assistente e selecione Atualizar .

   * watson_assistant.v2.service_endpoint- No Valor Substitua o valor existente pelo URL do Assistente do Watson e selecione Atualizar .

     Nota:  
     Você pode especificar apenas a parte do local da URL da instância de serviço no Valor campo. Por exemplo, se o 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, <kbd class="ph userinput">gateway.watsonplatform.net </kbd>em Valor campo.

     Se o Assistente do Watson estiver hospedado em um datacenter diferente de Dallas, como Washington DC, o URL base será https://gateway-wdc.watsonplatform.net/assistant/api. Você inseriria <kbd class="ph userinput">gateway-wdc.watston.platform.net </kbd>em Valor campo.
   {#configure-watson-assistant-topicV2__ul_djy_yck_hlb}
8. Defina a chave de API do Assistente do Watson como a senha no IBM Watson AssistantPerfil.
   1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">sys_auth_profile_basic.list </kbd>no filtro.
   2. Abra o. IBM Watson AssistantRegistro de perfil.
   3. No formulário Configuração básica de autenticação, insira a chave da API do Assistente do Watson no Senha e selecione Atualizar .  
   {#configure-watson-assistant-topicV2__substeps_jjt_z13_hlb}
9. Adicione o. Virtual Agent(bate-papo na web) para Portal de serviços.
   1. Navegar até Portal de serviçosConfiguração do Portal de serviços.
   2. Selecione Designer e, em seguida, selecione Portal de serviços página principal.
   3. PESQUISE Virtual Agente arraste o widget para a área delineada.  
      O ícone roxo de bate-papo aparece no canto inferior direito.

   {#configure-watson-assistant-topicV2__substeps_kdn_hmh_hlb}
10. Configure o. Virtual Agentselecionando 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. Em Parâmetros de URL do cliente do Virtual Agent , insira sysparm_skip_load_history=truepara que o histórico do tópico não seja exibido no cliente de bate-papo e no sysparm_topicParâmetro com o sys_id do tópico publicado do IBM Watson Assistant V2 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 o 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: <kbd class="ph userinput">https://&lt;Your URL da instância&gt; sn-va-web-client-app.do?sysparm_skip_load_history <var class="keyword varname">&lt;sys_id&gt; </var> </kbd>onde <var class="keyword varname">&lt;sys_id&gt; </var>é o sys_id do publicado IBM Watson AssistantTópico V2 a ser executado.  
       Importante:  
       Use o. `sysparm_topic `parâmetro somente para carregar o tópico fornecido no Portal de serviçoscliente de bate-papo ou ao usar o. IBM Watson AssistantIntegrações de bate-papo (com.glide.cs.ibm.watson.assistant.topic e com.glide.cs.ibm.watson.assistant.topicV2 plug-ins). Este parâmetro não permite que os usuários iniciem uma nova conversa ou transfiram para um atendente. Ele também desabilita 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 Cor do botão flutuante campo.
    3. Selecione Salvar.  
    {#configure-watson-assistant-topicV2__substeps_fw3_1p3_hlb}
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 Assistente do Watson e pelo menos dois nós de diálogo. No exemplo a seguir, o virtual agent fornece quatro intenções adicionais que o usuário pode selecionar.  
    Figura 1. Tópico de exemplo com desambiguação