Integração do Virtual Agent com o IBM Watson Assistant

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Configure o tópico IBM Watson Assistant para executar habilidades de diálogo (conversas criadas em IBM Watson Assistant) no cliente de bate-papo baseado na web. Este tópico retorna informações trocadas durante a conversa do atendente para IBM Watson Assistant.

    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.
    • Em IBM Watson Assistant:
      • Crie a habilidade de diálogo (conversa) no seu espaço IBM Watson Assistant. A habilidade inclui o diálogo e todas as intenções e entidades definidas por você.
      • Navegue até seu bloco de habilidades e, no menu bloco, selecione Exibir detalhes da API. Exibir os Detalhes da habilidade e as Credenciais de serviço. Copie os seguintes itens: ID da habilidade, Espaço, Nome do usuárioe Senha. Você precisa desses itens ao configurar esta integração.
    • Ative o Plug-in de integração IBM Watson Assistant (com.glide.cs.ibm.watson.assistant).

    Função necessária: virtual_agent_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    Este tópico executa uma diálogo IBM Watson Assistant em Virtual Agent. 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.

    Procedimento

    1. Em sua instância ServiceNow, atualize a propriedade do sistema watson_assistant.workspaceID.
      1. No filtro de navegação, insira sys_properties.list.
      2. Na tabela Propriedades do sistema [sys_properties], localize a propriedade watson_assistant.workspaceID.
      3. Substitua o Valor existente pela ID do espaço da sua habilidade e clique em Atualizar.
    2. Verifique se a mensagem REST do IBM Watson Assistant fornece o endpoint de autenticação correto para sua habilidade IBM:
      1. Navegar até Serviços web do sistema > Saída > Mensagem REST.
      2. Selecione o registro do IBM Watson Assistant para abrir o formulário do Assistente do IBM Watson da Mensagem REST.
      3. Confirme se o campo Endpoint e a coluna Endpoint, exibidos na guia Autenticação, têm o URL de endpoint correto para sua conta do IBM Watson.
        Formulário de Mensagens de REST para IBM Watson Assistant com URLs de endpoint da IBM destacados.
    3. No campo Perfil de autenticação básica, na guia Autenticação, abra o registro do Perfil do assistente.
    4. No formulário Configuração de autenticação básica, insira os valores Nome de usuário e Senha das Credenciais de serviço do IBM Watson Assistant e clique em Atualizar.
      Configuração de autenticação básica do Perfil do IBM Watson Assistant .
    5. Publique o tópico de habilidades IBM:
      1. Navegar até Interfaces conversacionais > Virtual Agent > Designere deslize o comutador de alternância do tipo de descoberta para NLU/palavra-chave.
      2. Na página inicial Designer do Virtual Agent, selecione o tópico IBM Watson Assistant para abrir a página Propriedades do tópico.
        Observe que a palavra-chave desse tópico é IBM Watson Assistant e a Categoria é IBM.
      3. Na página Propriedades do tópico, selecione Publicar para implantar o tópico no widget de bate-papo Virtual Agent.
    6. Configure o tópico padrão para o widget de bate-papo Virtual Agent de uma das seguintes maneiras:
      • Forneça o URL que especifica o tópico IBM Watson Assistant como o tópico padrão que é aberto no cliente Portal de serviços:

        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 do IBM Watson Assistant publicado. O parâmetro sysparm_skip_load_history não carrega o histórico da conversa no widget de bate-papo.

      • Configure o widget do Portal de serviços clicando no ícone de edição (o lápis) no canto superior direito do widget Virtual Agent.
        Para definir o tópico padrão usando os parâmetros da instância de widget, insira sysparm_topic = sys_id (em que <sys_id> é o sys_id do tópico do IBM Watson Assistant publicado) no campo Parâmetros de URL do Cliente do Virtual Agent e clique em Salvar.
        Nota:
        Você pode encontrar o sys_id de um tópico na tabela Tópicos [sys_cs_topic].
      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.