Artefatos de condição

É possível usar um ou mais dos seguintes artefatos em qualquer combinação para definir uma condição:

• Variável de contexto: o nó é usado se a expressão da variável de contexto que você especifica é verdadeira. Use a sintaxe $variable_name:value ou $variable_name == 'value'.

  Para condições de nó, esse tipo de artefato é normalmente usado com um operador AND ou OR e outro valor de condição. Isso é porque algo na entrada do usuário deve acionar o nó; o valor da variável de contexto que está sendo correspondido sozinho não é suficiente para acioná-lo. Se o objeto de entrada do usuário configurar o valor da variável de contexto de alguma forma, por exemplo, o nó será acionado.

  Não defina uma condição do nó com base no valor de uma variável de contexto no mesmo nó de diálogo no qual você configurou o valor da variável de contexto.

  Para condições de resposta, esse tipo de artefato pode ser usado sozinho. É possível mudar a resposta com base em um valor específico da variável de contexto. Por exemplo, $city:Boston verifica se a variável de contexto $city contém o valor Boston. Se sim, a resposta será retornada.

  Para obter mais informações sobre variáveis de contexto, veja Variáveis de contexto.

• Entidade: O nó é usado quando qualquer valor ou sinônimo para a entidade é reconhecido na entrada do usuário. Use a sintaxe @entity_name. Por exemplo, @city verifica se algum dos nomes de cidades que são definidos para a entidade @city foram detectados na entrada do usuário. Se for assim, o nó ou a resposta será processada.

  Considere a criação de um nó de mesmo nível para manipular o caso em que nenhum dos valores ou sinônimos da entidade é reconhecido.

  Para obter mais informações sobre entidades, veja Definindo entidades.

• Valor da entidade: o nó é usado se o valor da entidade é detectado na entrada do usuário. Use a sintaxe @entity_name:value e especifique um valor definido para a entidade, não um sinônimo. Por exemplo: @city:Boston verifica se o nome da cidade específica, Boston, foi detectado na entrada do usuário.

  Se você verificar a presença da entidade, sem especificar um valor específico para ela, em um nó de mesmo nível, certifique-se de posicionar esse nó (que verifica um valor de entidade específico) antes do nó de mesmo nível que verifica somente a presença da entidade. Caso contrário, esse nó nunca será avaliado.

  Se a entidade é uma entidade de padrão com grupos de captura, é possível verificar uma determinada correspondência de valor do grupo. Por exemplo, é possível usar a sintaxe: @us_phone.groups[1] == '617'

  Consulte Armazenando e reconhecendo grupos de entidades padrão na entrada para obter mais informações.

• Intenção: a condição mais simples é uma única intenção. O nó será usado se, após o processamento de língua natural de seu assistente avaliar a entrada do usuário, ele determinar que o propósito da entrada do usuário é mapeado para a intenção predefinida. Use a sintaxe #intent_name. Por exemplo, #weather verifica se a entrada do usuário está solicitando uma previsão meteorológica. Em caso positivo, o nó com a condição de intenção #weather é processado.

  Para obter mais informações sobre intenções, veja Definindo intenções.

• Condição especial: condições fornecidas com o produto que podem ser usadas para executar funções de diálogo comuns. Consulte a tabela Condições especiais na próxima seção para obter detalhes.

Condições especiais

Detalhes da sintaxe de condição

Use uma dessas opções de sintaxe para criar expressões válidas em condições:

• Notações abreviadas para consultar intenções, entidades e variáveis de contexto. Consulte Acessando e avaliando objetos.

• Spring Expression Language SpEL ), que é uma linguagem de expressão que suporta a consulta e a manipulação de um gráfico de objetos em tempo de execução. Consulte Spring Expression Language(SpEL) para obter mais informações.

É possível usar expressões regulares para verificar valores com relação a uma condição. Para localizar uma sequência correspondente, por exemplo, é possível usar o método String.find. Consulte Métodos para obter mais detalhes.

Resposta de texto simples

Para fornecer uma resposta de texto, basta inserir o texto que deseja que seu assistente exiba para o usuário.

{caption="Simple response" caption-side="bottom"}

Para incluir um valor da variável de contexto na resposta, use a sintaxe $variable_name para especificá-lo. Veja Variáveis de contexto para obter mais detalhes. Por exemplo, se você souber que a variável de contexto $user está configurada para o nome do usuário atual antes de um nó ser processado, será possível se referir a ele na resposta de texto do nó como esta:

Hello $user

Se o nome do usuário atual for Norman, a resposta exibida para Norman será Hello Norman.

Se você incluir um desses caracteres especiais em uma resposta de texto, escape-o incluindo uma barra invertida (\) na frente dele. Se você estiver usando o editor JSON, será preciso usar duas barras invertidas para escapar (\\). O escape do caractere evita que o assistente o interprete mal como um dos tipos de artefato a seguir:

As integrações integradas suportam os elementos de sintaxe de Redução de preço a seguir:

Se você não codificar um link ao especificar um número de telefone em uma resposta de texto, ele não será convertido em um link de telefone em nenhum lugar, exceto em uma integração de chat web acessada por meio de um dispositivo móvel.

A área de janela "Experimente" não suporta a sintaxe de Redução de preço atualmente. Para fins de teste, é possível usar o assistente Visualização para ver como a sintaxe Markdown é renderizada.

A área de janela "Experimentar", o assistente Visualização e o chat web suportam a sintaxe HTML. As integrações Slack e Facebook não.

Respostas ricas

É possível retornar respostas com elementos interativos ou de multimídia, como imagens ou botões clicáveis, para simplificar o modelo de interação de seu aplicativo e aprimorar a experiência do usuário.

Além do tipo de resposta padrão de Texto, para o qual você especifica o texto a ser retornado para o usuário como uma resposta, os tipos de resposta a seguir são suportados:

• Conectar ao agente humano: o diálogo chama um serviço que você designa, normalmente um serviço que gerencia as filas de chamado de suporte de agente humano, para transferir a conversa para uma pessoa. É possível incluir, opcionalmente, uma mensagem que resume o problema do usuário para ser fornecida para o agente humano.
• Transferência de canal: o diálogo solicita que a conversa seja transferida para um canal diferente (por exemplo, da integração Slack à integração do chat web).
• 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.
• Opção: inclui uma lista de uma ou mais opções. Quando um usuário clica em uma das opções, um valor de entrada do usuário associado é enviado ao seu assistente. A forma como as opções são renderizadas pode diferir, dependendo do número de opções e de onde o diálogo é implementado.
• Pausar: força o aplicativo a aguardar por um número especificado de milissegundos antes de continuar com o processamento. É possível optar por mostrar um indicador de que o assistente está trabalhando na digitação de uma resposta. Use esse tipo de resposta se for necessário executar uma ação que possa levar algum tempo.
• Habilidade de pesquisa: Plus Busca em uma fonte de dados externa informações relevantes para retornar ao usuário. A fonte de dados pesquisada é uma coleção de dados do serviço Discovery que você configura quando adiciona a pesquisa ao assistente que usa essa caixa de diálogo.
• Definido pelo usuário: se você usar o editor JSON para definir a resposta, será possível criar seu próprio tipo de resposta definido pelo usuário. Para obter mais informações, consulte Definindo respostas usando o editor JSON.

Diferentes integrações têm capacidades diferentes para exibir respostas ricas. Para definir diferentes respostas customizadas para diferentes canais, edite a resposta usando o editor JSON. Para obter mais informações, consulte Visando integrações específicas.

Para incluir uma resposta rica, conclua as etapas a seguir:

1. Clique no menu suspenso no campo Assistente responde para escolher um tipo de resposta e, em seguida, forneça qualquer informação necessária.

   Para obter mais informações, consulte as seções a seguir:

   • Conectar ao agente humano
   • Transferência de canal
   • Imagem
   • Opção
   • Pausa
   • Procurar qualificação Mais
   • Texto

2. Para incluir outro tipo de resposta à resposta atual, clique em Incluir tipo de resposta.

   Você pode desejar incluir diversos tipos de resposta em uma única resposta para fornecer uma resposta mais rica para uma consulta do usuário. Por exemplo, se um usuário solicitar locais de armazenamento, será possível mostrar um mapa e exibir um botão para cada local de armazenamento que o usuário pode clicar para obter detalhes do endereço. Para construir esse tipo de resposta, é possível usar uma combinação de imagem, opções, e tipos de resposta de texto. Outro exemplo é o uso de um tipo de resposta de texto antes de um tipo de resposta de pausa para que seja possível avisar os usuários antes de pausar o diálogo.

   Não é possível incluir mais que 5 tipos de resposta em uma única resposta. Isso significa que se você definir três respostas condicionadas para um nó de diálogo, cada resposta condicionada poderá ter no máximo cinco tipos de resposta incluídos nela.

   Não é possível incluir mais de um tipo de resposta Conectar ao agente humano ou Habilidade de procura em um único nó de diálogo.

   Não inclua mais de um tipo de resposta de opção em um único nó de diálogo, pois ambas as listas são exibidas de uma só vez, mas o cliente pode escolher uma opção de apenas uma delas.

3. Se você incluiu mais de um tipo de resposta, será possível clicar nas setas Mover para cima ou para baixo para organizá-los na ordem na qual deseja que seu assistente os processe.

Incluindo um tipo de resposta Conectar ao agente humano

Se o aplicativo cliente puder transferir uma conversa para uma pessoa, como um agente de suporte ao cliente, será possível incluir um tipo de resposta Conectar ao agente humano para iniciar a transferência. Algumas das integrações incorporadas, como chat web e Intercom, suportam transferências para agentes de service desk. Se estiver usando um aplicativo customizado, você deverá programar o aplicativo para reconhecer quando esse tipo de resposta for acionado.

Se quiser aproveitar a métrica de restrição para controlar a taxa de sucesso do assistente, inclua esse tipo de resposta no diálogo ou use um método alternativo para identificar quando os clientes são direcionados para o suporte externo. Para obter mais informações, consulte Medindo a restrição.

Para incluir um tipo de resposta Conectar ao agente humano, conclua as etapas a seguir:

1. No nó de diálogo no qual deseja incluir o tipo de resposta, clique no menu suspenso no campo Assistente responde e, em seguida, escolha Conectar ao agente humano.

2. Opcional. Inclua uma mensagem para compartilhar com o agente humano para o qual a conversa é transferida no campo Mensagem para agente humano.

3. Inclua uma mensagem para mostrar ao cliente para explicar que ele está sendo transferido.

   É possível incluir uma mensagem para mostrar quando os agentes estiverem disponíveis e uma mensagem para mostrar quando os agentes estiverem indisponíveis. Cada mensagem pode ter até 320 caracteres de comprimento.

   Apenas integrações de service desk integrado do chat web: o texto incluído nos campos Resposta quando os agentes estão on-line e Resposta quando nenhum agente está on-line é usado para transferências no chat web versão 3 e mais recente. Se você ainda não tiver incluído suas próprias mensagens, o texto de sugestão (texto esmaecido exibido como mensagens de exemplo) será usado.

   Se você usar esse tipo de resposta em vários nós e quiser usar o mesmo texto customizado toda vez, mas não quiser editar cada nó individualmente, será possível mudar o texto padrão usado pelo chat web. Para alterar as mensagens padrão, edite o arquivo de origem de idioma Procure os valores default_agent_availableMessage e default_agent_unavailableMessage. Para obter mais informações sobre como mudar o texto do bate-papo da web, consulte Idiomas

4. Opcional: se o canal no qual o assistente é implementado for integrado a um service desk, será possível incluir informações de roteamento inicial para passar com a solicitação de transferência.

   • Escolha o tipo de integração no campo Roteamento de service desk.

   • Inclua informações de roteamento que sejam significativas para o service desk sendo usado.

     Opções de roteamento de service desk

     Tipo de service desk	Informações de roteamento	Descrição
     Salesforce	ID do botão	Especifique um ID de botão válido da implementação do Salesforce.
     Zendesk	Departamento	Especifique um nome de departamento válido por meio da conta do Zendesk.

A transferência da caixa de diálogo não ocorre quando você testa os nós de diálogo com esse tipo de resposta no painel "Try it out" da caixa de diálogo. Deve-se acessar um nó que usa esse tipo de resposta por meio do botão Visualização para o assistente ver como os usuários vão experimentá-lo.

Incluindo um tipo de resposta Transferência de canal

Se o seu assistente usar várias integrações para suportar diferentes canais para interação com os usuários, pode haver algumas situações nas quais um cliente inicia uma conversa em um canal mas depois precisa ser transferido para um canal diferente.

Esse tipo de situação mais comum é transferir uma conversa para a integração do chat web para aproveitar os recursos do chat web, como a integração de service desk.

Atualmente, o chat web é o único destino suportado para uma transferência de canal.

Apenas as integrações a seguir podem iniciar uma transferência de canal:

• Slack
• Facebook Messenger
• WhatsApp

Outras integrações ignoram o tipo de resposta Transferência de canal .

Para incluir um tipo de resposta Transferência de canal, conclua as etapas a seguir:

1. No nó de diálogo no qual deseja incluir o tipo de resposta, clique no menu suspenso no campo Assistente responde e, em seguida, escolha Transferência de canal.

2. Opcional. No campo Mensagem antes do link para o chat web, edite a mensagem introdutória a ser exibida para o usuário (no canal de origem) antes do link que inicia a transferência. Por padrão, essa mensagem é OK, click this link for additional help. Chat will continue on a new web page.

3. No campo URL para chat web, digite a URL para o website ao qual o widget de chat web está integrado.

Na integração que processa a resposta Transferência de canal, a mensagem introdutória é exibida seguida por um link para a URL que você especificar. O usuário deve, então, clicar no link para iniciar a transferência.

Quando uma conversa é transferida de um canal para outro, o histórico de sessão e o contexto são preservados, portanto, o canal de destino pode continuar a conversa de onde ele partiu. Observe que a saída de mensagem que contém a resposta Transferência de canal é processada primeiro pelo canal que inicia a transferência e, em seguida, pelo canal de destino. Se a saída contiver várias respostas (talvez usando tipos de resposta diferentes), elas serão processadas por ambos os canais (antes e depois da transferência). Se quiser destinar respostas individuais a canais específicos, edite a resposta usando o editor JSON. Para obter mais informações, consulte Visando integrações específicas.

Incluindo um tipo de resposta de Imagem

Às vezes, uma imagem vale mais que mil palavras. Inclua imagens em sua resposta para fazer coisas como ilustrar um conceito, mostrar desconto de mercadorias para venda ou talvez para mostrar um mapa de localização de sua loja.

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

1. Escolha Imagem.

2. Inclua a URL completa no arquivo de imagem hospedado no campo Origem da imagem.

   A imagem deve estar no formato .jpg, .gif ou .png. O arquivo de imagem deve ser armazenado em um local que possa ser publicamente acessado por uma URL https:.

   Por exemplo: https://www.example.com/assets/common/logo.png.

   Se desejar exibir um título e uma descrição da imagem acima da imagem integrada na resposta, inclua-os nos campos fornecidos.

   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.

   Alguns canais de integração ignoram títulos ou descrições.

Incluindo um tipo de resposta de Vídeo

Inclua vídeos em sua resposta para compartilhar demonstrações de instruções, clipes promocionais, etc. No chat web, uma resposta de vídeo é renderizada como um reprodutor de vídeo integrado.

Para incluir um tipo de resposta de Vídeo, conclua as etapas a seguir:

1. Escolha Vídeo.

2. Inclua a URL completa no vídeo hospedado no campo Fonte do vídeo:

   • 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 chat web, o vídeo vinculado será renderizado como um reprodutor de vídeo integrado.

     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 chat web, o vídeo vinculado será renderizado usando o reprodutor integrável para o serviço de hospedagem.

     Especifique a URL que você usaria para visualizar o vídeo em seu navegador (por exemplo, https://www.youtube.com/watch?v=52bpMKVigGU). Não é preciso converter a URL para um formulário integrável; o chat web fará isso automaticamente.

     É possível integrar vídeos hospedados nos serviços a seguir:

     • YouTube
     • Facebook
     • Vimeo
     • Twitch
     • Transmissível
     • Wistia
     • Vidyard

   Para exibir um título e uma descrição de um vídeo acima do vídeo integrado na resposta, inclua-os nos campos fornecidos.

   Alguns canais de integração ignoram títulos ou descrições.

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

3. O tipo de resposta de Vídeo é suportado nas integrações de chat web, Facebook, WhatsApp, Slack e SMS.

Incluindo um tipo de resposta de Áudio

Inclua clipes de áudio em sua resposta para compartilhar conteúdo falado ou outro conteúdo audível. No chat web, uma resposta de vídeo é renderizada como um reprodutor de vídeo integrado. Na integração telefônica, uma resposta de áudio toca por telefone.

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

1. Escolha Áudio.

2. Inclua a URL completa no clipe de áudio hospedado no campo Fonte do vídeo:

   • 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 chat web, o áudio vinculado será renderizado como um reprodutor de áudio integrado.

   • 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 chat web, o clipe de áudio vinculado será renderizado usando o reprodutor integrável para o serviço de hospedagem.

     Especifique a URL que você usaria para acessar o arquivo de áudio em seu navegador (por exemplo, https://soundcloud.com/ibmresearch/fallen-star-amped). Não é preciso converter a URL para um formulário integrável; o chat web fará isso automaticamente.

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

     • SoundCloud
     • Mixcloud

   Para exibir um título e uma descrição de um áudio acima do reprodutor de áudio integrado na resposta, inclua-os nos campos fornecidos.

   Alguns canais de integração ignoram títulos ou descrições.

   Se você quiser que o clipe de áudio faça loop indefinidamente, selecione Ativado no campo Loop. Por exemplo, você pode querer usar essa opção para tocar música enquanto um usuário espera no telefone. (Por padrão, o áudio toca apenas uma vez e depois para.)

   Atualmente, a opção Loop é suportada apenas pela integração telefônica. Essa opção não terá efeito se você estiver usando a integração de chat web ou qualquer outro canal.

3. O tipo de resposta de Áudio é suportado nas integrações de chat web, Facebook, WhatsApp, Slack, SMS e telefônicas.

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:

• Um mapa interativo no Google Mapas
• Uma pesquisa de opinião que usa SurveyMonkey
• Um formulário para fazer reservas pelo OpenTable
• Um formulário de planejamento que usa Calendly

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.

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 ().

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

<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" />

Incluindo um tipo de resposta de Opção

Inclua um tipo de resposta de opção quando você quiser oferecer um conjunto de opções para o cliente escolher. Por exemplo, é possível construir uma resposta como esta:

A maioria das integrações exibe as opções como botões se houver somente alguns itens (4 ou menos, por exemplo).

{caption="Option buttons" caption-side="bottom"}

Caso contrário, as opções serão exibidas como uma lista.

Para incluir um tipo de resposta de Opção, conclua as etapas a seguir:

1. No nó de diálogo no qual deseja incluir o tipo de resposta, clique no menu suspenso no campo Assistente responde e, em seguida, escolha Opção.

2. Clique em ** Incluir opção **.

3. No campo Rótulo da lista, insira a opção a ser exibida na lista.

   O rótulo deve ter menos de 2.048 caracteres de comprimento.

4. No campo correspondente Value, insira a entrada do usuário a ser transmitida ao seu assistente quando essa opção for selecionada.

   O valor deve ter menos que 2.048 caracteres de comprimento.

   Para integrações Slack nas quais as opções são exibidas como uma lista, cada valor deve ter 75 caracteres ou menos de comprimento.

   Especifique um valor que você sabe que acionará a intenção correta quando ele for enviado. Por exemplo, pode ser um exemplo do usuário dos dados de treinamento para a intenção.

5. Repita as etapas anteriores para incluir mais opções na lista.

   É possível incluir até 20 opções.

6. Inclua uma introdução de lista no campo Título. O título pode solicitar ao usuário para selecionar dentre a lista de opções.

   Alguns canais de integração não exibem o título.

7. Opcionalmente, inclua informações adicionais no campo Descrição. Se especificado, a descrição será exibida após o título e antes da lista de opções.

   Alguns canais de integração não exibem a descrição.

8. Opcional: para indicar uma preferência de como as opções são exibidas, como botões ou em uma lista, é possível incluir uma propriedade preference para a resposta.

   Para fazer isso, abra o editor JSON para a resposta e, em seguida, inclua um par de nome e valor preference antes do par de nome e valor response_type. É possível configurar a preferência como dropdown ou button.

   {
     "output": {
       "generic": [
         {
           "title": "Insurance types",
           "options": [
             {
               "label": "Boat",
               "value": {
                 "input": {
                   "text": "I want to buy boat insurance."
                 }
               }
             },
             {
               "label": "Car",
               "value": {
                 "input": {
                   "text": "I want to buy car insurance."
                 }
               }
             },
             {
               "label": "House",
               "value": {
                 "input": {
                   "text": "I want to buy house insurance."
                 }
               }
             }
           ],
           "preference": "dropdown", //add this name and value pair
           "description": "Which of these items do you want to insure?",
           "response_type": "option"
         }
       ]
     }
   }
   

   Ao definir uma lista de opções com somente 3 itens, as opções são geralmente exibidas como botões. Ao incluir uma propriedade de preferência que indica dropdown como a preferência, por exemplo, é possível ver na área de janela "Experimentar" que a lista é exibida alternativamente como uma lista suspensa.

   

   Alguns tipos de integração, como o bate-papo da web, refletem sua preferência. Outros tipos de integração, como o Slack, não refletem a preferência ao renderizar as opções.

Não inclua mais de um tipo de resposta de opção em um único nó de diálogo, pois ambas as listas são exibidas de uma só vez, mas o cliente pode escolher uma opção de apenas uma delas.

Se precisar preencher a lista de opções com valores diferentes com base em alguns outros fatores, você poderá projetar uma lista de opções dinâmicas. Para obter mais informações, consulte a postagem do blog How to Dynamically Add Response Options to Dialog Nodes(Como adicionar dinamicamente opções de resposta a nós de diálogo ).

Incluindo um tipo de resposta de Pausa

Inclua um tipo de resposta de pausa para dar tempo para o assistente responder. Por exemplo, é possível incluir um tipo de resposta de pausa em um nó que chama um webhook. A pausa indica que o assistente está trabalhando em uma resposta, o que dá tempo ao assistente para fazer a chamada do webhook e obter uma resposta. Em seguida, é possível ir para um nó filho para mostrar o resultado.

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

1. No nó de diálogo no qual deseja incluir o tipo de resposta, clique no menu suspenso no campo Assistente responde e, em seguida, escolha Pausa.

2. Inclua o período de tempo para a pausa para durar como um número de milissegundos (ms) no campo Duração.

   O valor não pode ultrapassar 10.000 ms. Geralmente os usuários estão dispostos a esperar cerca de 8 segundos (8.000 ms) até alguém dar uma resposta. Para evitar que um indicador de digitação seja exibido durante a pausa, escolha Desativado.

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

Esse tipo de resposta não é renderizado na área de janela "Experimente". Deve-se acessar um nó que use esse tipo de resposta em uma implementação de teste para ver como será a experiência de seus usuários.

Incluindo um tipo de resposta Qualificação de Procura

Plus

Se você tiver algum material existente voltado para o cliente, como uma FAQ, um catálogo de produtos ou um material de vendas, que possa responder às perguntas que os clientes costumam fazer, coloque essas informações em uso. É possível incluir uma procura do material existente em tempo real para obter a resposta mais recente e mais atualizada para seus clientes.

Para usar o tipo de resposta de qualificação de procura, deve-se incluir a procura no mesmo assistente que usa esse diálogo Para obter mais informações, consulte IBM Watson® Discovery configuração de integração de procura

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

1. No nó de diálogo no qual deseja incluir o tipo de resposta, clique no menu suspenso no campo Assistente responde e, em seguida, escolha Habilidade de procura.

   Indica que você deseja consultar uma origem de dados externa para obter uma resposta relevante.

2. Para editar a consulta de procura a ser transmitida ao serviço Discovery, clique em Customizar e preencha os campos a seguir:

   • Consulta: opcional. É possível determinar uma consulta específica em língua natural a ser transmitida ao Discovery. Se uma consulta não for incluída, o texto de entrada exato do cliente será transmitido como a consulta.

     Por exemplo, é possível especificar What cities do you fly to?. Esse valor de consulta é passado para Discovery como uma consulta de pesquisa. Discovery usa a compreensão da linguagem natural para entender a consulta e encontrar uma resposta ou informações relevantes sobre o assunto na coleção de dados configurada para a pesquisa.

     É possível incluir informações específicas fornecidas pelo usuário fazendo referência a entidades detectadas na entrada do usuário como parte da consulta. Por exemplo, Tell me about @product. Além disso, também é possível fazer referência a uma variável de contexto, como Do you have flights to $destination?. Apenas certifique-se de projetar seu diálogo de forma que a procura não seja acionada, a menos que entidades ou variáveis de contexto referenciadas na consulta tenham sido configuradas para valores válidos.

     Esse campo é equivalente ao parâmetro natural_language_query do Discovery. Para obter mais informações, consulte Parâmetros de consulta.

     • Filtro: opcional. Especifique uma sequência de texto que defina informações que devam estar presentes em qualquer um dos resultados da procura retornados.

       • Para indicar que deseja retornar apenas documentos com impressões positivas detectadas, por exemplo, especifique enriched_text.sentiment.document.label:positive.

       • Para filtrar os resultados para incluir apenas documentos que o processo de ingestão identificou que contêm a entidade Boston, MA, especifique enriched_text.entities.text:"Boston, MA".

       • Para filtrar os resultados para incluir apenas documentos que o processo de ingestão identificou que contêm um nome de produto fornecido pelo cliente, é possível especificar enriched_text.entities.text:@product.

       • Para filtrar os resultados para incluir apenas documentos que o processo de ingestão identificou que contêm um nome de cidade salvo em uma variável de contexto denominada $destination, é possível especificar enriched_text.entities.text:$destination.

       Esse campo é equivalente ao parâmetro filter do Discovery. Para obter mais informações, consulte Parâmetros de consulta.

     Se você incluir tanto uma consulta quanto um valor de filtro, o parâmetro filter será aplicado primeiro para filtrar os documentos da coleta de dados e armazenar os resultados em cache. Em seguida, o parâmetro de consulta classificará os resultados armazenados em cache.

3. Opcional: mude o tipo de consulta que é usado para a procura.

   A pesquisa envia uma consulta em linguagem natural para Discovery automaticamente. Como alternativa, se quiser usar a linguagem de consulta Discovery, você poderá especificá-la. Para isso, abra o editor JSON para a resposta do nó.

   Edite o fragmento de código JSON para substituir natural_language por discovery_query_language. Por exemplo:

   {
     "output": {
       "generic": [
         {
           "query": "",
           "filter": "enriched_text.sentiment.document.label:positive",
           "query_type": "discovery_query_language",
           "response_type": "search_skill"
         }
       ]
     }
   }
   

Teste esse tipo de resposta por meio do assistente Visualização. Você não pode testá-lo no painel "Try it out".

Respostas condicionais

Um único nó de diálogo pode fornecer diferentes respostas, cada uma acionada por uma condição diferente. Use essa abordagem para abordar cenários diversos em um único nó.

O nó ainda tem uma condição principal, que é a condição para usar o nó e processar as condições e respostas que ele contém.

Neste exemplo, seu assistente usa as informações coletadas anteriormente sobre o local do usuário para customizar sua resposta e fornecer informações sobre a loja mais próxima do usuário. Consulte Variáveis de contexto para obter informações adicionais sobre como armazenar informações coletadas do usuário.

{caption="Conditional responses" caption-side="bottom"}

Esse nó único agora fornece a função equivalente de quatro nós separados.

Para incluir respostas condicionais em um nó, conclua as etapas a seguir:

1. Clique em Customizar e, em seguida, configure o comutador Múltiplas respostas condicionadas para Ativado.

   A seção de resposta do nó muda para mostrar um par de campos de condição e resposta. É possível incluir uma condição e uma resposta neles.

2. Para personalizar ainda mais uma resposta, clique no ícone Personalizar ao lado da resposta.

   Deve-se abrir a resposta para edição para concluir as tarefas a seguir:

   • ** Atualizar contexto **. Para mudar o valor de uma variável de contexto quando a resposta é acionada, especifique o valor de contexto no editor de contexto. Você atualiza o contexto para cada resposta condicional individual; não há nenhum editor de contexto comum ou editor JSON para todas as respostas condicionais.

   • ** Incluir respostas ricas **. Para incluir mais de uma resposta de texto ou para incluir tipos de resposta diferentes de respostas de texto para uma única resposta condicional, deve-se abrir a visualização de resposta de edição.

   • ** Configure um salto **. Para instruir seu assistente a ir para um nó diferente após o processamento dessa resposta condicional, selecione Ir para na seção E, finalmente da visualização de edição de resposta. Identifique o nó que deseja que seu assistente processe em seguida. Consulte Configurando a ação Ir para para obter mais informações.

     Uma ação Ir para que está configurada para o nó não é processada até que todas as respostas condicionais sejam processadas. Portanto, se uma resposta condicional estiver configurada para ir para outro nó e a resposta condicional for acionada, o salto configurado para o nó nunca será processado e, portanto, não ocorrerá.

3. Clique em Incluir resposta para incluir outra resposta condicional.

As condições em um nó são avaliadas na ordem, assim como os nós. Certifique-se de que as respostas condicionais estejam listadas na ordem correta. Se for necessário mudar a ordem, selecione um par de condição e resposta e mova-o para cima ou para baixo na lista usando as setas que são exibidas.

Configurando a ação Ir Para

Se você escolher ir para outro nó, especifique quando o nó de destino será processado escolhendo uma das opções a seguir:

• Condição: se a instrução estiver direcionada à seção de condição do nó de diálogo selecionado, seu assistente verificará primeiro se a condição do nó de destino foi avaliada como true.

  • Se a condição é avaliada como true, o sistema processa o nó de destino imediatamente.

  • Se a condição não é avaliada como true, o sistema move para o próximo nó irmão do nó de destino para avaliar sua condição e repete esse processo até que localize um nó de diálogo com uma condição que seja avaliada como true.

  • Se o sistema processa todos os irmãos e nenhuma das condições é avaliada como true, a estratégia básica de fallback é usada e o diálogo avalia os nós no nível base da árvore de diálogo.

  Destinar a condição é útil para encadear as condições de nós de diálogo. Por exemplo, você pode desejar primeiro verificar se a entrada contém uma intenção, tal como #turn_on e, se contém, você pode desejar verificar se a entrada contém entidades, como @lights, @radio ou @wipers. O encadeamento das condições ajuda a estruturar árvores de diálogo maiores.

  Evite escolher essa opção ao configurar um salto de uma resposta condicional que irá para um nó situado acima do nó atual na árvore de diálogo. Caso contrário, um loop infinito poderá ser criado. Se o nó anterior for acessado por seu assistente e tiver sua condição verificada por ele, false provavelmente será retornado porque a mesma entrada do usuário que está sendo avaliada acionou o nó atual pela última vez através do diálogo. Seu assistente irá para o próximo irmão ou voltará para a raiz para verificar as condições nesses nós e, provavelmente, acionará esse nó novamente, o que significa que o processo será repetido.

• Resposta: se a instrução se destina à seção de resposta do nó de diálogo selecionado, ela é executada imediatamente. Ou seja, o sistema não avalia a condição do nó de diálogo selecionado; ele processa a resposta do nó de diálogo selecionado imediatamente.

  Destinar a resposta é útil para encadear vários nós de diálogo juntos. A resposta é processada como se a condição desse nó de diálogo fosse true. Se o nó de diálogo selecionado tiver outra ação Ir para, essa ação também será executada imediatamente.

• Aguardar entrada do usuário: aguarda uma nova entrada do usuário e, em seguida, começa a processá-la por meio do nó para o qual você houve o salto. Essa opção será útil se o nó de origem fizer uma pergunta, por exemplo, e você desejar ir para um nó separado para processar a resposta do usuário para a pergunta.

Próximas etapas

• Certifique-se de testar o seu diálogo à medida que o construir. Para obter mais informações, consulte Testando o diálogo.
• Para obter mais informações sobre maneiras de abordar casos de uso comum, consulte Dicas de construção de diálogo.
• Para obter mais informações sobre a linguagem de expressão que pode ser usada para melhorar o seu diálogo, como os métodos que reformatam datas ou texto, consulte Métodos de linguagem de expressão.

Também é possível usar a API para incluir nós ou, caso contrário, editar um diálogo. Consulte Modificando um diálogo usando a API para obter mais informações.