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

• Ensine watsonx Assistant sobre suas intenções.

  Depois de decidir quais solicitações de negócios você deseja que seu aplicativo manipule para seus clientes, deve-se ensinar watsonx Assistant sobre elas. 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. Adapte os exemplos do usuário 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.

  Seu assistente usa os exemplos que você fornece para construir um modelo de aprendizado de máquina que pode reconhecer os mesmos tipos de elocuções e mapeá-los 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. Clique em 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 prefixo de sinal de número # é incluído no nome da intenção automaticamente para ajudar a identificar o termo como uma intenção. Não é necessário incluí-lo.

   Mantenha o nome o mais curto possível para capacidade de leitura no painel "Experimente" e nos logs de conversa.

   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.

   Nomes de intenção e texto de exemplo podem ser mostrados em URLs quando um aplicativo interage com o watsonx 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. Quando terminar de incluir exemplos, clique na seta de fechamento para concluir a criação da intenção.

O sistema treina a si mesmo nos exemplos de intenção e 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, se ele aparecer 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

Referenciando diretamente um nome de entidade em um exemplo de intenção

Esta abordagem é avançada. Ao adotá-la, use-a de forma consistente.

É possível escolher referenciar diretamente as entidades em seus exemplos de intenção. Por exemplo, digamos que você tenha uma entidade chamada @PhoneModelName que contém os valores Galaxy S8, Moto Z2, LG G6 e Google Pixel 2. Ao criar uma intenção, por exemplo #order_phone, você poderá fornecer dados de treinamento da seguinte forma:

• Posso obter um @PhoneModelName?
• Ajude-me pedir um @PhoneModelName.
• O @PhoneModelName está no estoque?
• Inclua um @PhoneModelName em minha ordem.

Atualmente, é possível referenciar diretamente somente as entidades de sinônimos que você define (os valores padrão são ignorados). Não é possível usar as entidades do sistema

Se optar por referenciar uma entidade como um exemplo de intenção (por exemplo, @PhoneModelName) em qualquer lugar de seus dados de treinamento, ela cancelará o valor do uso de uma referência direta (por exemplo, Galaxy S8) em um exemplo de intenção em qualquer outro lugar. Todas as intenções usarão, então, a abordagem de entidade como um exemplo de intenção. Não é possível aplicar essa abordagem somente a uma intenção específica.

Na prática, isso significa que, se você tiver treinado anteriormente a maioria de suas intenções com base em referências diretas (Galaxy S8) e agora usar referências de entidade (@PhoneModelName) para apenas uma intenção, a mudança afetará seu treinamento anterior. Se você escolhe usar referências @Entity, deve-se substituir todas as referências diretas anteriores por referências @Entity.

Definir uma intenção de exemplo com uma @Entity com 10 valores definidos para ela não equivale a especificar essa intenção de exemplo 10 vezes. O serviço watsonx Assistant não dá tanto peso a essa sintaxe de intenção de exemplo.

Testando suas intenções

Depois de concluir a criação de novas intenções, é possível testar o sistema para ver se ele reconhece suas intenções conforme o esperado.

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 você fizer mudanças recentes em sua qualificação, poderá ver uma mensagem indicando que o sistema ainda está retreinando. 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.

   

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.

Pontuação absoluta

O serviço watsonx 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.

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 watsonx 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 exemplos para uma intenção diferente

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 Intentos, clique no ícone Procurar .

2. Envie um termo de procura ou frase. Também é possível selecionar Incluir correspondência parcial.

   A primeira vez que você procurar algo, poderá receber uma mensagem informando que o conteúdo está sendo indexado. 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 o download de várias intenções para um arquivo CSV, assim será possível fazer o upload e reutilizá-las em outro aplicativo watsonx Assistant.

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

• Para fazer download de todas as intenções, ou seja, as intenções que estão 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. Em seguida, clique no botão Download..

• Para fazer download de uma ou mais intenções específicas, selecione as intenções das quais você deseja fazer download e, em seguida, clique no botão Download.

1. 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 você tiver muitos intentos e exemplos, poderá achar mais fácil fazer upload deles 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 de intentos

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 Fazer upload de intenções.

   O arquivo é validado e transferido por upload e o sistema se treina nos 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.

Excluindo intenções

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

Ao excluir intenções, você também está excluindo todos os exemplos associados e esses itens não podem ser recuperados 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 todos os intentos, ou seja, os intentos que estão listados nesta e quaisquer páginas adicionais, não selecione quaisquer intentos individuais. 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.