Configurar a Integração com bate-papo IBM Watson Assistant

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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

    • 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 > Designer.
      2. Na página Tópicos, 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, clique em Publicar para implantar o tópico no seu cliente Web Virtual Agent.
    6. Configure o tópico padrão para o cliente Web do 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 cliente Web.

      • 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.