Criando intenções

Visão Geral da Criação de Intenção

• Planeje as intents para seu aplicativo.

  Considere o que seus clientes podem desejar fazer e o que você deseja que seu aplicativo seja capaz de manipular em seu nome. Por exemplo, você pode desejar que o aplicativo ajude seus clientes a fazer uma compra. Neste caso, é possível incluir uma intenção #buy_something (o # incluído como um prefixo no nome da intenção ajuda a identificá-la claramente como uma intenção).

• Ensina o Watson sobre suas intents.

  Depois de decidir quais solicitações de negócios o aplicativo deve manipular para os clientes, deve-se ensinar o Watson sobre eles. Para cada objetivo de negócios (como #buy_something), deve-se fornecer pelo menos 5 exemplos de elocuções que são usadas normalmente pelos clientes para indicar seus objetivos. Por exemplo, I want to make a purchase.

  Idealmente, localize exemplos de elocução do usuário do mundo real que podem ser extraídos de processos de negócios existentes. Os exemplos do usuário devem ser customizados para seus negócios específicos. Por exemplo, se você for uma empresa de seguros, um exemplo de usuário poderá ser semelhante a I want to buy a new XYZ insurance plan.

  Os exemplos fornecidos são utilizados por seu assistente para construir um modelo de aprendizado de máquina que possa reconhecer os mesmos tipos de elocuções e elocuções semelhantes, mapeando-os para a intenção apropriada.

Inicie com algumas intenções e teste-as conforme você expande iterativamente o escopo do aplicativo.

Criando intenções

1. Abra a habilidade de diálogo. A qualificação é aberta para a página Intenções.

2. Selecione Criar intenção.

3. No campo Nome da intenção, digite um nome para a intenção.

   • O nome de intenção pode conter letras (em Unicode), números, sublinhados, hifens e pontos.
   • O nome não pode consistir em .. ou em qualquer outra sequência somente de pontos finais.
   • Os nomes das intenções não podem conter espaços e não devem exceder 128 caracteres. A seguir estão exemplos de nomes de intenção:
     • #weather_conditions
     • #pay_bill
     • #escalate_to_agent

   Um sinal de número # precede automaticamente o nome da intenção para ajudar a identificar o termo como uma intenção. Não é necessário incluí-lo.

   Mantenha o nome o mais curto possível. É mais fácil para ler nos logs da área de janela "Experimentar" e de conversa se você mantiver o nome da intenção curto e conciso.

   Opcionalmente, inclua uma descrição da intenção no campo Descrição.

4. Selecione Criar intenção para salvar o nome da intenção.

   

5. No campo Exemplo do usuário, digite o texto de um exemplo do usuário para a intenção. Um exemplo pode ser qualquer sequência de até 1.024 caracteres de comprimento. As elocuções a seguir podem ser exemplos para a intenção #pay_bill:

   • I need to pay my bill.
   • Pay my account balance
   • make a payment

   Para saber sobre o impacto de incluir referências a entidades em seus exemplos do usuário, consulte Como as referências de entidade são tratadas.

   Os nomes de intenção e o texto de exemplo podem ser expostos em URLs quando um aplicativo interage com o Watson Assistant. Não inclua informações sensíveis ou pessoais nestes artefatos.

6. Clique em Incluir exemplo para salvar o exemplo de usuário.

   

7. Repita o mesmo processo para incluir mais exemplos.

   Forneça pelo menos cinco exemplos para cada intenção.

8. Ao concluir a inclusão de exemplos, clique em para finalizar a criação da intenção.

O sistema começa a treinar a si mesmo sobre a intenção e os exemplos do usuário que você incluiu.

Importante:

• Os dados de exemplo de intenção devem ser representativos e típicos de dados fornecidos por seus usuários. Os exemplos podem ser coletados de dados reais do usuário ou de pessoas que são especialistas em seu campo específico. A natureza representativa e precisa dos dados é importante.
• Os dados de treinamento e teste (para propósitos de avaliação) devem refletir a distribuição de intenções no uso real. Geralmente, intenções mais frequentes têm relativamente mais exemplos e melhor cobertura de resposta.
• É possível incluir pontuação no texto de exemplo, contanto que apareça naturalmente. Se acreditar que alguns usuários expressem suas intenções com exemplos que incluam pontuação e outros não, inclua ambas as versões. Geralmente, quando mais cobertura para vários padrões, melhor a resposta.

Como as referências de entidade são tratadas

Quando você inclui uma menção de entidade em um exemplo do usuário, o modelo de aprendizado de máquina usa as informações de diferentes maneiras nestes cenários:

• Referenciando valores de entidade e sinônimos em exemplos de intenção
• Menas anotadas
• Referenciando diretamente um nome de entidade em um exemplo de intenção

Testando suas intenções

Depois de ter concluído a criação de novas intenções, é possível testar o sistema para ver se ele reconhece suas intenções como você espera.

1. Clique em Experimente-o.

   

2. Na área de janela "Experimentar", insira uma pergunta ou outra sequência de texto e pressione Enter para ver qual intenção é reconhecida. Se a intenção incorreta é reconhecida, você pode melhorar seu modelo incluindo esse texto como um exemplo para a intenção correta.

   Se tiver feito mudanças recentemente em sua qualificação, uma mensagem poderá ser exibida indicando que o sistema ainda está realizando o novo treinamento. Se você vir essa mensagem, aguarde até que o treinamento seja concluído antes de testar:

   

   A resposta indica qual intenção foi reconhecida de sua entrada.

   

3. Se o sistema não reconhecer a intenção correta, será possível corrigi-la. Para corrigir a intenção reconhecida, selecione a intenção exibida e, em seguida, selecione a intenção correta na lista. Após o envio de sua correção, o sistema inicia automaticamente um novo treinamento para incorporar os novos dados.

   

4. Se a entrada não estiver relacionada a nenhuma intenção em seu aplicativo, isso poderá ser ensinado ao seu assistente selecionando a intenção exibida e, em seguida, clicando em Marcar como irrelevante.

   

   Para obter mais informações sobre essa ação, consulte Ensinando seu assistente sobre tópicos a serem ignorados.

Se suas intenções não estão sendo corretamente reconhecidas, considere fazer os seguintes tipos de mudanças:

• Inclua o texto não reconhecido como um exemplo para a intenção correta.
• Mova exemplos existentes de uma intenção para outra.
• Considere se suas intenções são muito semelhantes e redefina-as conforme apropriado.

Pontuação absoluta

O serviço Watson Assistant pontua a confiança de cada intenção independentemente, não em relação a outras intenções. Essa abordagem inclui flexibilidade; diversas intenções podem ser detectadas em uma única entrada do usuário. Isso também significa que o sistema pode não retornar nenhuma intenção. Se a intenção superior tiver uma pontuação de confiança baixa (menor que 0,2), a intenção superior será incluída na matriz de intenções que é retornada pela API, mas quaisquer nós que condicionarem a intenção não serão acionados. Se você desejar detectar o caso quando nenhuma intenção com boa pontuação de confiança foi detectada, use a condição especial irrelevant em seu nó de diálogo. Consulte Condições especiais para obter mais informações.

Conforme as pontuações de confiança de intenção mudam, seus diálogos podem precisar de reestruturação. Por exemplo, se um nó de diálogo usar uma intenção em sua condição e a pontuação de confiança da intenção começar a cair de forma consistente abaixo de 0,2, o nó de diálogo parará de ser processado. Se a pontuação de confiança mudar, o comportamento do diálogo também poderá mudar.

Limites de intenção

O número de intenções e exemplos que podem ser criados depende do tipo de plano de seu Watson Assistant:

Editando intenções

É possível clicar em qualquer intenção na lista para abri-la para edição. É possível fazer as seguintes mudanças:

• Renomear a intenção.
• Excluir a intenção.
• Incluir, editar ou excluir exemplos.
• Mover um exemplo para uma intenção diferente.

É possível tabular do nome da intenção para cada exemplo.

1. Para mover ou excluir um exemplo, clique na caixa de seleção que está associada a ele e, em seguida, clique em Mover ou Excluir.

   

Procurando intenções

Use o recurso Procurar para localizar exemplos de usuários, nomes de intenções e descrições.

1. Na página Intenções, clique no ícone Procurar.

   

2. Envie um termo de procura ou frase.

   Na primeira vez que você procurar algo, provavelmente obterá uma mensagem informando que a habilidade está sendo indexada. Se sim, aguarde um minuto e, em seguida, reenvie o termo de procura.

   As intenções que contêm seu termo de procura são exibidas.

   

Fazendo o download de intenções

É possível fazer download de várias intenções para um arquivo CSV, portanto, é possível fazer upload e reutilizá-las em outro aplicativo Watson Assistant.

1. Acesse a página Intenções.

   • Para fazer o download de todas as intenções, o que significa as intenções listadas nesta e em quaisquer páginas adicionais, não selecione nenhuma intenção individual. Em vez disso, clique no ícone Fazer download de todas as intenções.

   • Para fazer o download das intenções listadas apenas na página atual, marque a caixa de seleção no cabeçalho. Essa ação seleciona todas as intenções na página atual. Clique no ícone Download.

   • Para fazer o download de uma ou mais intenções específicas, selecione as intenções que deseja transferir por download e, em seguida, clique no ícone Download. .

2. Especifique o nome e o local no qual armazenar o arquivo CSV que é gerado e, em seguida, clique em Salvar.

Fazendo upload de intenções e exemplos

Se tiver um grande número de intenções e exemplos, talvez você ache mais fácil fazer o upload por meio de um arquivo de valor separado por vírgula (CSV) do que defini-los um por um. Certifique-se de remover quaisquer dados pessoais dos exemplos do usuário que você incluir no arquivo.

1. Colete as intenções e exemplos em um arquivo CSV ou exporte-os de uma planilha para um arquivo CSV. O formato obrigatório para cada linha no arquivo é o seguinte:

   <example>,<intent>
   

   em que <example> é o texto de um exemplo de usuário e <intent> é o nome da intenção a que o exemplo deve corresponder. Por exemplo:

   Tell me the current weather conditions.,weather_conditions
   Is it raining?,weather_conditions
   What's the temperature?,weather_conditions
   Where is your nearest location?,find_location
   Do you have a store in Raleigh?,find_location
   

   Importante: Salve o arquivo CSV com codificação UTF-8 e nenhuma marca de ordem de byte (BOM).

2. Na página Intenções, clique no ícone Upload .

3. Arraste um arquivo ou navegue para selecionar um arquivo do computador.

   Importante: o tamanho máximo do arquivo CSV é de 10 MB. Se o arquivo CSV for maior, considere dividi-lo em vários arquivos e carregá-los separadamente.

4. Clique em ** Upload **.

   O arquivo é validado e carregado e o sistema começa a se treinar sobre os novos dados.

É possível visualizar as intenções transferidas por upload e os exemplos correspondentes na guia Intenções. Talvez seja necessário atualizar a página para ver as novas intenções e exemplos.

Resolvendo conflitos de intenção

Esse recurso está disponível apenas para usuários de planos pagos.

O aplicativo Watson Assistant detecta um conflito quando dois ou mais exemplos de intenção em intenções separadas são tão semelhantes que o {{site.data.keassistant_classic_shortnshort}} fica confuso quanto a qual intenção usar.

Para resolver conflitos:

1. Na página Intenções, revise quaisquer intenções com conflitos.

   

2. Clique em uma intenção com um conflito para abri-la. Localize o exemplo do usuário que está causando o conflito e, em seguida, clique em Resolver conflitos.

   

3. Escolha se você deseja excluir o exemplo da intenção ou movê-lo para outra intenção.

   

   Exemplos de usuário semelhantes são exibidos para cada intenção. Esses exemplos não estão necessariamente em conflito. Eles são mostrados para dar uma visão rápida dos outros tipos de exemplos de usuário que são definidos para cada intenção. Eles fornecem a você um contexto que pode ajudá-lo a tomar uma decisão mais comunicada.

   Mantenha cada intenção como distinta e focada em um objetivo, conforme possível. Se você tiver duas intenções com diversos exemplos do usuário que se sobrepõem, talvez não precise de duas intenções separadas. É possível mover ou excluir exemplos do usuário que não se sobrepõem diretamente em uma intenção e, em seguida, excluir o outro.

4. Para mover um exemplo de usuário, clique em Mover e, em seguida, clique na intenção para a qual deseja mover o exemplo.

   

   Ao decidir onde colocar um exemplo, procure a intenção que tem exemplos de sinônimos ou quase sinônimos.

   Se o mesmo exemplo já tiver sido usado pela outra intenção, a ação de movimentação somente removerá o exemplo da intenção atual. Ela não incluirá o mesmo exemplo para a outra intenção duas vezes.

5. Depois de mover ou excluir o exemplo, clique em Enviar para resolver o conflito.

   

   Reconfiguração reverte as suas mudanças. Clique no x para fechar a página sem enviar suas mudanças.

6. Repita as etapas anteriores para resolver outras intenções com conflitos.

Excluindo intenções

É possível selecionar várias intenções para exclusão.

IMPORTANTE: ao excluir intenções, todos os exemplos associados também são excluídos e não é possível recuperá-los posteriormente. Todos os nós de diálogo que fazem referência a essas intenções devem ser atualizados manualmente para que não façam referencia ao conteúdo excluído.

1. Acesse a página Intenções

   • Para excluir todas as intenções, ou seja, aquelas listadas nesta e em todas as páginas adicionais, não selecione nenhuma intenção individual. Em vez disso, clique no ícone Excluir todas as intenções.

   • Para excluir as intenções listadas apenas na página atual, marque a caixa de seleção no cabeçalho. Essa ação seleciona todas as intenções listadas na página atual. Clique em Excluir.

   • Para excluir uma ou mais intenções específicas, selecione aquelas que você deseja excluir e, em seguida, clique em Excluir.