IBM Cloud Docs
Criando intenções

Criando intenções

Intenções são propósitos ou objetivos que são expressos na entrada de um cliente, como responder a uma pergunta ou processar um pagamento de conta. Ao reconhecer a intenção expressa na entrada de um cliente, o serviço watsonx Assistant pode escolher o fluxo de diálogo correto para responder a isso.

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.

    Captura de tela que mostra a nova definição de intenção
    Nova 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.

    Captura de tela que mostra a inclusão de um exemplo de usuário em uma intenção
    Incluir 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 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:

Menas anotadas

Ao definir entidades, é possível anotar menções da entidade diretamente de seus exemplos de usuário de intenção existentes. Um relacionamento que você identifica dessa maneira entre a intenção e a entidade não é usado pelo modelo de classificação de intenção. No entanto, quando você inclui a menção na entidade, ela também é incluída nessa entidade como um novo valor. E quando você inclui a menção a um valor de entidade existente, ela também é incluída a esse valor de entidade como um novo sinônimo. A classificação de intenção usa esses tipos de referências de dicionário em exemplos do usuário de intenção para estabelecer uma referência fraca entre uma intenção e uma entidade.

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.

Captura de tela mostrando a definição de intenção
Definição de intenção

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.

    Captura de tela de intenções de teste
    Intenções de teste

  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.

    Captura de tela de correção de uma intenção reconhecida
    Correção de uma intenção

  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.

    Marcar como captura de tela irrelevante
    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:

Detalhes do plano
Plano Intenções por habilidade Exemplos por habilidade
Enterprise 2.000 25.000
Premium (legado) 2.000 25.000
Plus 2.000 25.000
Avaliação 100 25.000
Lite 100 25.000

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.

Captura de tela mostrando como mover ou excluir um exemplo
Mover ou excluir exemplo

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 í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 Upload de ícone

  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. Opção Excluir

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