IBM Cloud Docs
Incluindo respostas do assistente

Incluindo respostas do assistente

Quando uma ação é ativada, o corpo da ação é composto de várias etapas que formam a conversa entre o assistente e os usuários. Uma parte de cada etapa é o que o assistente diz para o cliente quando a etapa é processada.

Para criar a resposta do assistente em uma etapa, você usa a seção Assistente diz. Isso representa o texto ou a fala que o assistente fornece a um usuário em uma determinada etapa. Dependendo da etapa, é possível incluir uma resposta completa para uma pergunta do usuário ou fazer uma pergunta de acompanhamento.

É possível inserir uma resposta de texto simples digitando o texto que você quer que o assistente exiba para o usuário. Também é possível adicionar formatação e conteúdo da Web e fazer referência a informações do usuário usando variáveis.

Formatando respostas

Use as ferramentas do editor de texto para aplicar o estilo de fonte, como negrito ou itálico, no texto ou para incluir links.

Em segundo plano, o estilo de fonte e a sintaxe de link são armazenados em formato Markdown. Se você estiver usando a integração de bate-papo da web, as identificações HTML e Markdown serão suportadas Para obter mais informações, consulte Formatação deMarkdown.

As tags HTML (exceto para links) são removidas automaticamente das respostas de texto enviadas para as integrações do Facebook, WhatsApp, e Slack, porque esses canais não oferecem suporte à formatação HTML. As tags HTML ainda são manipuladas em canais que as suportam (como o bate-papo da web) e armazenadas no histórico de sessão..

Se estiver usando um aplicativo cliente customizado que não suporta Markdown, não aplique o estilo de texto nas respostas de texto.

Incluindo e consultando variáveis

Durante a conversa, o assistente armazena informações como variáveis. Variáveis são contêineres para valores de dados que se tornam disponíveis no tempo de execução. O valor de uma variável pode mudar ao longo do tempo. As variáveis incluem variáveis de ação, que persistem apenas durante uma ação em particular, e variáveis de sessão, que estão disponíveis para qualquer ação. Para obter mais informações sobre variáveis, consulte Gerenciando informações durante a conversa.

Na saída do seu assistente, você pode fazer referência a variáveis para personalizar a conversa ou incluir informações disponíveis em tempo de execução. Para obter mais informações sobre como referenciar variáveis naquilo que o assistente diz, consulte Usando variáveis para customizar a conversa.

Testando respostas

Para verificar se as respostas do assistente estão formatadas corretamente, você pode usar o Preview.

  1. Clique no botão Visualizar.
  2. Para iniciar a ação, digite a primeira frase, por exemplo: What are your store hours?.
  3. Quando o assistente responder, verifique se a mensagem é exibida como você pretendia, com formatação e uso de variáveis.

Dicas para incluir respostas

  • Mantenha as respostas curtas e úteis.
  • Reflita a intenção do usuário na resposta. Fazer isso garante aos usuários que o robô os esteja compreendo e que, caso ele não esteja, eles tenham uma chance de corrigir um equívoco imediatamente.
  • Inclua links para sites externos nas respostas se a resposta depender de dados que mudam com frequência.
  • Palavra de suas respostas cuidadosamente. Você pode alterar a forma como alguém reage ao seu sistema com base na maneira como você formula uma resposta. A mudança de uma linha de texto pode evitar que você tenha que gravar múltiplas linhas de código para implementar uma solução programática complexa.

Incluindo variações

Se os usuários retornam ao assistente com frequência, eles podem ficar entediados ao ver as mesmas saudações e respostas todas as vezes. É possível incluir variações de resposta para que seu assistente possa responder à mesma solicitação de maneiras diferentes..

É possível optar por alternar pelas variações de respostas sequencialmente ou em ordem aleatória. Por padrão, as respostas são alternadas sequencialmente, como se fossem escolhidas em uma lista ordenada.

Para incluir variações de respostas:

  1. No Assistente diz, clique no Incluir variações de resposta ícone Incluir variações de resposta..

  2. Para Tipo de Variação de Resposta, escolha se deseja girar as variações de resposta sequencialmente ou em ordem aleatória. Para obter mais informações, consulte Sequencial ou aleatório

    Variações de Resposta
    Variações de Resposta

  3. Inclua cada variação em seu campo. Por exemplo:

    Exemplos de variação de resposta
    Número de resposta. Variação
    Resposta 1 Como posso ajudá-lo?
    Resposta 2 O que posso fazer por você hoje?
    Resposta 3 Diga-me com o que posso ajudar.
    Resposta 4 Posso te ajudar?
  4. Ao concluir, clique em Aplicar. As variações aparecem como um bloco dentro de O assistente diz É possível clicar no ícone Editar para atualizar as variações ou clicar no ícone Excluir para remover todas as variações Além disso, é possível incluir vários conjuntos de variações de resposta em uma etapa

    Variações de resposta no Assistant diz
    Variações de resposta no Assistant diz

Sequencial ou aleatório

Para Tipo de variação de resposta, é possível escolher Sequencial ou Aleatório.

Sequencial retorna a primeira variação de resposta na primeira vez em que a ação é acionada, a segunda variação de resposta na segunda vez em que a ação é acionada, e assim por diante, na mesma ordem em que você inseriu as variações. Isso resulta em respostas retornadas na seguinte ordem quando o nó é processado:

  • Primeira vez:

    How can I help you?
    
  • Segunda vez:

    What can I do for you today?
    
  • Terceira vez:

    Tell me what I can help with.
    
  • Quarta vez:

    Can I help you?
    

Aleatório seleciona a variação na primeira vez que a ação é acionada e seleciona aleatoriamente outra variação na próxima vez, mas sem repetir a mesma variação consecutivamente. Este exemplo mostra uma ordem em que as respostas podem aparecer:

  • Primeira vez:

    Tell me what I can help with.
    
  • Segunda vez:

    Can I help you?
    
  • Terceira vez:

    How can I help you?
    
  • Quarta vez:

    What can I do for you today?
    

Respostas de mídia

Além das respostas de texto, é possível usar outros tipos de resposta para enviar respostas que incluam elementos multimídia ou interativos.

O editor de ação suporta os seguintes tipos de resposta de mídia:

  • Imagem: integra uma imagem à resposta. O arquivo de imagem de origem deve ser hospedado em algum lugar e ter uma URL que você possa usar para referenciá-lo. Ele não pode ser um arquivo que esteja armazenado em um diretório que não está publicamente acessível.
  • Vídeo: integra um reprodutor de vídeo à resposta. O vídeo de origem deve estar hospedado em algum lugar, seja como um vídeo reproduzível em um serviço de streaming de vídeo suportado ou como um arquivo de vídeo, com uma URL que possa ser usada para fazer referência a ele. Ele não pode ser um arquivo que esteja armazenado em um diretório que não está publicamente acessível.
  • Áudio: integra um clipe de áudio à resposta. O arquivo de áudio de origem deve estar hospedado em algum lugar e ter uma URL que possa ser usada para fazer referência a ele. Ele não pode ser um arquivo que esteja armazenado em um diretório que não está publicamente acessível.
  • iframe: integra conteúdo de um website externo, como um formulário ou outro componente interativo, diretamente dentro do chat. O conteúdo de origem deve estar publicamente acessível usando HTTP e ser integrável como um elemento HTML iframe.

Diferentes integrações de canais têm diferentes recursos para exibir respostas de mídia. Para ver quais integrações de canal suportam quais tipos de resposta, consulte Suporte de integração de canal para tipos de respostas.

Se quiser definir respostas diferentes que sejam personalizadas para canais diferentes, você poderá fazer isso editando a resposta usando o editor JSON. Para obter mais informações, consulte Visando integrações específicas.

Editando suas respostas no editor JSON, também é possível acessar mais tipos de resposta para manipular interações específicas do canal

Para obter mais informações sobre como editar respostas usando o editor JSON, consulte Definição de respostas usando o editor JSON.

Adição de uma resposta de imagem

Inclua uma resposta Image para exibir uma imagem para o cliente.

O tipo de resposta Imagem é suportado pelas integrações de canal a seguir:

  • Chat web
  • SMS
  • Slack
  • Equipes da Microsoft
  • Facebook
  • WhatsApp

Para adicionar uma resposta de imagem, conclua as etapas a seguir:

  1. No campo Assistant says, clique no ícone Image Image.

  2. No campo Fonte URL, digite o endereço completo URL para a imagem hospedada.

    A imagem deve estar no formato JPEG, GIF ou PNG. O arquivo de imagem deve ser armazenado em um local que possa ser acessado publicamente por um URL https: (como https://www.example.com/assets/common/logo.png ).

    Para acessar uma imagem armazenada no IBM Cloud® Object Storage, ative o acesso público ao objeto de armazenamento de imagem individual e, em seguida, faça referência a ele especificando a origem da imagem com uma sintaxe semelhante a seguinte: https://s3.eu.cloud-object-storage.appdomain.cloud/your-bucket-name/image-name.png.

  3. Opcionalmente, especifique um título de imagem, descrição e texto alternativo nos campos fornecidos. Na integração de bate-papo da Web, o título e a descrição são exibidos junto com a imagem

    As referências a variáveis não são suportadas Alguns canais de integração ignoram títulos ou descrições.

  4. Clique em Aplicar.

Adição de uma resposta de áudio

Inclua uma resposta Áudio para incluir palavra em spool ou outro conteúdo audível. No bate-papo na Web, uma resposta de áudio é renderizada como um player de áudio incorporado. Na integração telefônica, uma resposta de áudio toca por telefone.

O tipo de resposta Áudio é suportado pelas integrações de canal a seguir:

  • Chat web
  • Telefone
  • SMS
  • Slack
  • Facebook
  • WhatsApp

Para adicionar uma resposta de áudio, conclua as etapas a seguir:

  1. No campo Assistente diz, selecione o ícone Áudio Áudio.

  2. No campo URL de origem, digite o URL completo do clipe de áudio hospedado:

    • Para se vincular diretamente a um arquivo de áudio, especifique a URL para um arquivo em qualquer formato padrão, como MP3 ou WAV. No bate-papo na Web, o clipe de áudio vinculado é renderizado como um player de áudio incorporado.

    • Para se vincular a um clipe de áudio em um serviço de hospedagem de áudio suportado, especifique a URL para o clipe de áudio. No bate-papo na Web, o clipe de áudio vinculado é renderizado usando o player incorporado do serviço de hospedagem.

      Especifique o URL que você usaria para acessar o arquivo de áudio no seu navegador (por exemplo, https://soundcloud.com/ibmresearch/fallen-star-amped ). Não é necessário converter o URL em um formato incorporável; o bate-papo na Web faz isso automaticamente.

      É possível integrar áudios hospedados nos serviços a seguir:

  3. Opcionalmente, especifique um título, descrição e texto alternativo nos campos fornecidos. Na integração de bate-papo da web, o título e a descrição são exibidos junto com o reprodutor de áudio

    As referências a variáveis não são suportadas Alguns canais de integração ignoram títulos ou descrições.

Adição de uma resposta de vídeo

Inclua uma resposta Vídeo para exibir uma demonstração de instruções, clipe promocional ou outro conteúdo de vídeo. No chat web, uma resposta de vídeo é renderizada como um reprodutor de vídeo integrado.

O tipo de resposta Vídeo é suportado pelas integrações de canal a seguir:

  • Chat web
  • SMS
  • Slack
  • Facebook
  • WhatsApp

Para adicionar uma resposta de vídeo, conclua as etapas a seguir:

  1. No campo Assistente diz, clique no ícone Vídeo Video.

  2. No campo URL de origem, digite o URL completo do vídeo hospedado:

    • Para se vincular diretamente a um arquivo de vídeo, especifique a URL para um arquivo em qualquer formato padrão, como MPEG ou AVI. No bate-papo na Web, o vídeo vinculado é renderizado como um player de vídeo incorporado.

      Os vídeos de streaming HLS (.m3u8) e DASH (MPD) não são suportados.

    • Para se vincular a um vídeo hospedado em um serviço de hospedagem de vídeo suportado, especifique a URL para o vídeo. No bate-papo na Web, o vídeo vinculado é renderizado usando o player incorporado do serviço de hospedagem.

      Especifique o URL que você usaria para visualizar o vídeo em seu navegador (por exemplo, https://www.youtube.com/watch?v=52bpMKVigGU ). Não é necessário converter o URL em um formato incorporável; o bate-papo na Web faz isso automaticamente.

      Você pode incorporar vídeos hospedados nos seguintes serviços:

      • YouTube
      • Facebook
      • Vimeo
      • Twitch
      • Transmissível
      • Wistia
      • Vidyard
  3. Opcionalmente, especifique um título de vídeo, descrição e texto alternativo nos campos fornecidos. Na integração de bate-papo da web, o título e a descrição são exibidos junto com o reprodutor de vídeo

    As referências a variáveis não são suportadas Alguns canais de integração ignoram títulos ou descrições.

  4. Para escalar o vídeo para um tamanho de exibição específico, especifique um número no campo Altura de base.

Adição de uma resposta iframe

Adicione uma resposta iframe para incorporar conteúdo de outro site diretamente na janela de bate-papo como um elemento HTML iframe. Uma resposta de iframe será útil se você quiser permitir que os clientes interajam com um serviço externo sem sair do bate-papo. Por exemplo, você pode usar uma resposta iframe para exibir os seguintes exemplos no bate-papo na Web:

No bate-papo da web, há duas maneiras de incluir o iframe:

  • Como um cartão de visualização que descreve o conteúdo incorporado Os clientes podem clicar nesse cartão para exibir o quadro e interagir com o conteúdo.
  • Inline, significando dentro da conversa. Essa opção é boa para partes menores do conteúdo do iframe..

O tipo de resposta iframe é suportado pelas integrações de canal a seguir:

  • Chat web
  • Facebook

Para incluir um tipo de resposta de iframe, conclua as etapas a seguir:

  1. No campo Assistente diz, clique no ícone iframe (iframe).

  2. Inclua a URL completa no conteúdo externo no campo Fonte do iframe.

    A URL deve especificar conteúdo que pode ser integrado a um elemento HTML iframe. Sites diferentes têm restrições diferentes para incorporar conteúdo e processos diferentes para gerar URLs incorporáveis. Uma URL integrável é aquela que pode ser especificada como o valor do atributo src do elemento iframe.

    Por exemplo, para incorporar um mapa interativo que usa Google Maps, você pode usar a API de incorporação Google Maps. Para obter mais informações, consulte Visão geral da API de Integração de Mapas Outros sites têm processos diferentes para criação de conteúdo integrável.

    Para obter os detalhes técnicos do uso do Content-Security-Policy: frame-src que fornece permissão para integrar o conteúdo do website em seu assistente, consulte CSP: frame-src.

  3. Opcionalmente, inclua um título descritivo no campo Título.

    No bate-papo da web, o título incluído é exibido no cartão de visualização. O cliente clica no cartão de visualização para renderizar o conteúdo externo

    Se você não especificar um título, o bate-papo na Web tentará recuperar os metadados do URL especificado e exibirá o título do conteúdo de acordo com a especificação na fonte.

    As referências a variáveis não são suportadas

  4. Para mostrar o iframe no fluxo da conversa, em vez de como um cartão de visualização, configure Exibir iframe sequencial como Ativado. Você também pode definir a altura do iframe. O padrão é 180 pixels.

Detalhes técnicos: iframe sandboxing

O conteúdo carregado em um iframe pelo bate-papo na Web é colocado em sandbox, o que significa que ele restringe as permissões que reduzem as vulnerabilidades de segurança. O chat web usa o atributo sandbox do elemento iframe para conceder apenas as seguintes permissões:

Permissão Descrição
allow-downloads Permite o download de arquivos da rede, se o download for iniciado pelo usuário.
allow-forms Permite enviar formulários.
allow-scripts Permite executar scripts, mas não abrir janelas pop-up.
allow-same-origin Permite que o conteúdo acesse seu próprio armazenamento de dados (como cookies) e permite acesso limitado a APIs JavaScript.

Um script executado dentro de um iframe em sandbox não pode alterar nenhum conteúdo fora do iframe, se a página externa e o iframe tiverem origens diferentes. Tenha cuidado se você usar uma resposta iframe para integrar conteúdo que tenha a mesma origem da página na qual seu widget de bate-papo da web está hospedado. Nessa situação, o conteúdo incorporado pode derrotar o ambiente de simulação e obter acesso ao conteúdo fora do quadro. Para obter mais informações sobre essa vulnerabilidade em potencial, consulte a sandbox documentação do atributo

Detalhes técnicos: iframe cartão de visualização

O tipo de resposta iframe no bate-papo da web exibe o Cartão de visualização, que inclui uma imagem, título e descrição da página da web que o usuário visita no bate-papo da web.

Para exibir uma imagem, um título e uma descrição no Cartão de Visualização, a página da web precisa das seguintes tags <meta> dentro da tag <head> :

<meta property="og:image" content="https://.../image.jpg" />

<meta property="og:image:url" content="https://.../image.jpg" />

<meta property="og:title" content="The webpage title" />
<meta property="og:description" content="The webpage description" />

Essas propriedades de metadados especificadas vêm do Protocolo Open Graph.

Os metadados são opcionais.. O bate-papo da web exibe um cartão de visualização com a URL da página da web e metadados que o bate-papo da web buscou com sucesso.

Pausar resposta

Use uma resposta Pausar para que seu assistente aguarde por um intervalo especificado antes da próxima resposta Essa pausa permite tempo para que uma solicitação seja concluída ou age como um agente ativo que pausa entre as respostas. A pausa deve ser de qualquer duração de 0 a 60 segundos, o que pode incluir decimais de um segundo para configurar a pausa até milliseconds

Uma resposta de pausa é normalmente usada em combinação com outras respostas. Por padrão, uma animação de indicador de digitação aparece durante a pausa para simular um agente ativo.

O tipo de resposta Pausar é suportado pelas integrações de canais a seguir:

  • Chat web
  • Facebook
  • WhatsApp

Com o canal de telefone, é possível incluir uma pausa incluindo o elemento SSML break na saída do assistente. Para obter mais informações, consulte a documentação doText to Speech

Para adicionar uma resposta de Pausa:

  1. No campo Assistente diz, clique no ícone Pausar Pausar.

  2. No campo Duração, insira o período de tempo para a pausa em seconds.

    A duração não deve exceder 60 seconds.. Além disso, é possível inserir os decimais de second no campo Duração para pausar a resposta até milliseconds. Por exemplo, se você inserir 10.50 seconds, a resposta será pausada para 10500 milliseconds Em geral, os clientes estão dispostos a esperar cerca de 8 segundos para que alguém digite uma resposta.

  3. O Indicador de tipo é configurado como Ativado por padrão. É possível configurar isso como Off se desejar.

    Inclua outro tipo de resposta, como um tipo de resposta de texto, após a pausa para denotar claramente que a pausa acabou.