Adicionar respostas do assistente de IA

Editar online

Isto é para testar a versão de teste

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

Para criar a resposta do seu assistente de IA em uma etapa, use a seção “O assistente diz ”. Isso representa o texto ou a mensagem que o assistente de IA transmite ao 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.

Você pode inserir uma resposta de texto simples apenas digitando o texto que deseja que seu assistente de IA exiba ao usuário. Você também pode adicionar formatação e conteúdo da web, além de fazer referência às informações do usuário por meio de 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 na Web, há suporte para marcação HTML e Markdown. Para obter mais informações, consulte Formatação Markdown.

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 tratadas nos canais que as suportam (como o bate-papo na Web) e armazenadas no histórico da 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, seu assistente de IA armazena as informações como variáveis. As variáveis são contêineres para valores de dados que se tornam disponíveis em tempo de execução. O valor de uma variável pode mudar com o 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 “Gerenciamento de informações durante a conversa ”.

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

Testando respostas

Para verificar se as respostas do assistente de IA estão formatadas corretamente, você pode usar a função "Visualizar".

  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 de IA responder, verifique se a mensagem é exibida conforme o esperado, incluindo a formatação e o 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.

Adição de variações

Se os seus usuários recorrerem ao seu assistente de IA com frequência, eles podem acabar se cansando de ver as mesmas saudações e respostas todas as vezes. Você pode adicionar variações de resposta para que seu assistente de IA 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 adicionar variações de resposta:

  1. No Assistant, clique no ícone “Adicionar Adicionar variações de respostavariações de resposta”.

  2. Para o Tipo de variação de resposta, escolha se deseja alternar entre 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

  1. Adicione cada variação em seu próprio campo. Por exemplo:

Tabela 1. Exemplos de variação de respostas

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 no que posso ajudar.

Resposta 4

Posso ajudá-lo?

  1. Quando terminar, clique em Aplicar. As variações aparecem como um bloco dentro de Assistant says. Você pode clicar no ícone Editar para atualizar as variações ou clicar no ícone Excluir para remover todas as variações. Além disso, você pode adicionar vários conjuntos de variações de resposta a uma etapa.

Variações de resposta no Assistant diz

Sequencial ou aleatório

Para o tipo de variação de resposta, você pode 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?

O Random seleciona a variação na primeira vez em 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 da mídia

Além das respostas de texto, você pode usar outros _tipos de resposta_ para enviar respostas que incluam elementos multimídia ou interativos.

O editor de ações é compatível com 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 oferecem suporte a quais tipos de resposta, consulte Suporte de integração de canal para tipos de resposta.

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.

Ao editar suas respostas no editor JSON, você também pode acessar mais tipos de resposta para lidar com interações específicas do canal.

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

Adicionar uma resposta com imagem

Adicione uma resposta de imagem para exibir uma imagem para o cliente.

O tipo de resposta Image é compatível com as seguintes integrações de canal:

  • Chat web

  • SMS

  • Slack

  • Microsoft Teams

  • <

  • WhatsApp

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

  1. No campo “O Assistente diz ”, clique no ícone Imagem de imagem.

  2. No campo Source URL, digite o endereço completo URL da 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 endereçado publicamente por um https: URL (como https://www.example.com/assets/common/logo.png).

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

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

Não há suporte para referências a variáveis. Alguns canais de integração ignoram títulos ou descrições.

  1. Clique em Aplicar.

Adicionar uma resposta de áudio

Adicione uma resposta de áudio para incluir palavras faladas 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 de áudio é compatível com as seguintes integrações de canal:

  • Chat web

  • Telefone

  • SMS

  • Slack

  • <

  • WhatsApp

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

  1. No campo “O Assistente diz”, clique no ícone Áudio de Áudio.

  2. No campo Source URL, digite o endereço completo URL 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 endereç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:

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

Não há suporte para referências a variáveis. Alguns canais de integração ignoram títulos ou descrições.

Adicionar uma resposta em vídeo

Adicione uma resposta de vídeo para exibir uma demonstração de como fazer, um 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 de vídeo é compatível com as seguintes integrações de canal:

  • Chat web

  • SMS

  • Slack

  • <

  • WhatsApp

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

  1. No O assistente diz campo, clique no VídeoVídeo ícone.

  2. No campo Source URL, digite o endereço completo URL 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 endereço URL que você usaria para visualizar o vídeo no navegador (por exemplo, https://www.youtube.com/watch?v=52bpMKVigGU). Não é necessário converter o endereç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:

  1. Opcionalmente, especifique o título, a descrição e o texto alternativo do vídeo nos campos fornecidos. Na integração do bate-papo na Web, o título e a descrição são exibidos junto com o player de vídeo.

Não há suporte para referências a variáveis. Alguns canais de integração ignoram títulos ou descrições.

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

Adicionando 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 na 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, ou seja, dentro da conversa. Essa opção é boa para partes menores do conteúdo do iframe.

O tipo de resposta iframe é compatível com as seguintes integrações de canal:

  • Chat web

  • <

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

  1. No campo “O Assistente diz ”, clique no ícone do 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 a visão geral da API de incorporação do Maps. Outros sites têm processos diferentes para criação de conteúdo integrável.

Para obter detalhes técnicos sobre como usar o Content-Security-Policy: frame-src recurso que permite incorporar o conteúdo do site em seu assistente de IA, consulte CSP: frame-src.

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

No bate-papo na Web, o título que você adiciona é 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 metadados do site URL especificado e exibirá o título do conteúdo de acordo com a especificação na fonte.

Não há suporte para referências a variáveis.

  1. Para mostrar o iframe no fluxo da conversa, e não como um cartão de visualização, defina Exibir iframe em linha 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 chat online é executado em ambiente isolado, o que significa que as permissões são restringidas para reduzir vulnerabilidades de segurança. O chat na web utiliza o sandbox atributo do iframe elemento 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 a execução de scripts, mas _não_ a abertura de 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 ambiente isolado não pode alterar nenhum conteúdo fora do iframe, _se_ a página externa e o iframe tiverem origens diferentes. Tenha cuidado ao usar uma resposta iframe para incorporar conteúdo que tenha a mesma origem da página onde o widget de chat está hospedado. Nessa situação, o conteúdo incorporado pode burlar o sandboxing e obter acesso ao conteúdo fora do quadro. Para obter mais informações sobre essa possível vulnerabilidade, consulte a sandbox documentação do atributo.

Detalhes técnicos: iframe visualização da placa

O tipo de resposta " iframe no bate-papo na Web exibe o cartão de visualização, que inclui uma imagem, um título e uma descrição da página da Web que o usuário visita no bate-papo na 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" />
<!--or-->
<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 provêm do Protocolo Open Graph.

Os metadados são opcionais. O bate-papo na Web exibe um cartão de visualização com o URL e os metadados da página da Web que o bate-papo na Web buscou com êxito.

Pausa na resposta

Use uma resposta de pausa para que seu assistente de IA aguarde um intervalo especificado antes da próxima resposta. Essa pausa dá tempo para que uma solicitação seja concluída ou funciona como um agente ao vivo que faz uma pausa entre as respostas. A pausa deve ter uma duração entre 0 e 60 segundos, podendo incluir décimos de 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 do indicador de digitação aparece durante a pausa para simular um agente ao vivo.

O tipo de resposta Pausa é compatível com as seguintes integrações de canal:

  • Chat web

  • <

  • WhatsApp

No canal de telefone, é possível inserir uma pausa incluindo o elemento break SSML na saída do assistente de IA. Para mais informações, consulte o Text to Speech documentação.

Para adicionar uma resposta de Pausa:

  1. No O assistente diz campo, clique no PausarPausa ícone.

  2. No campo Duration (Duração ), digite o período de tempo para a pausa em ' seconds.

A duração não deve exceder ' 60 seconds. Além disso, você pode inserir os decimais de " second no campo Duration (Duração) para pausar a resposta até " milliseconds. Por exemplo, se você digitar " 10.50 seconds, a resposta fará uma pausa para " 10500 milliseconds. Em geral, os clientes estão dispostos a esperar cerca de 8 segundos para que alguém digite uma resposta.

  1. O indicador de digitação é definido como Ativado por padrão. Você pode definir essa opção como Desligado, 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.