IBM Cloud Docs
Visão geral: editando ações

Visão geral: editando ações

Se você estiver procurando a documentação do AI Assistant Builder, consulte Criando assistentes de IA.

Como um assistente pessoal humano, o assistente que você cria ajuda seus clientes a concluir tarefas e responder a perguntas. Construa seu assistente definindo ações.

Uma ação representa um resultado discreto que você deseja que o seu assistente seja capaz de realizar em resposta a uma solicitação do usuário. Uma ação compreende a interação entre um cliente e o assistente sobre uma determinada pergunta ou solicitação. Essa interação começa com a entrada do usuário que inicia a ação (por exemplo, I want to withdraw money). Em seguida, ela pode incluir mais trocas à medida que o assistente reúne mais informações e termina quando o assistente realiza a solicitação ou responde à pergunta do cliente.

Criando e editando uma ação

Para saber como as ações funcionam e como construir uma, veja um exemplo.

Quando você cria uma nova ação do zero, o site watsonx Assistant solicita um exemplo da entrada do cliente que inicia a ação. Esse texto também é usado como nome padrão para a ação, mas é possível editar o nome da ação posteriormente. Além disso, cada ação deve ter um nome exclusivo, portanto, certifique-se de não incluir um exemplo que duplique um nome de ação existente.

Nova ação
Nova ação

Digite I want to withdraw money e, em seguida, clique em Salvar para criar a ação.

Inicialmente, é necessário especificar apenas um exemplo de entrada típica do usuário que inicia a ação. É possível incluir mais exemplos de entrada de usuário posteriormente. Para obter mais informações, consulte Entendendo as perguntas ou solicitações dos usuários.

Visualizando o fluxo da ação

Depois de criar uma ação, você tem a opção de alternar entre a guia Editar e a guia Visualizar Ao escolher a guia de visualização, é possível visualizar o fluxograma da ação

Editor
Editor

Enquanto estiver visualizando o fluxograma da ação, será possível aplicar zoom e panoramizar ao redor da tela.

Visualização
Visualização

Usando o editor de ação

Depois de criar a ação, o editor de ação é aberto.

Editor de ações mostrando a ação recém-criada
Editor de ações
..

A janela do editor mostra as partes de uma ação:

  • Nome de exibição: defina um nome de exibição para substituir o título da ação que aparece como o texto do botão na desambiguação. Para permitir a desambiguação, consulte Fazer perguntas de esclarecimento.

  • Adicione frases de exemplo: Insira frases que seu cliente poderia usar para iniciar essa ação. Quanto mais frases você inserir, melhor o assistente reconhecerá o que o cliente deseja.

  • Em Etapas de conversa, é possível ver as etapas que compõem a ação. Uma etapa é uma interação entre o assistente e o cliente; as etapas são executadas em ordem, da primeira à última. É possível reordenar as etapas em uma ação clicando e arrastando etapas na lista.

  • O botão Visualizar abre uma área de janela que mostra como o assistente responde à entrada do cliente. Você pode visualizar o assistente a qualquer momento para ver o efeito das alterações feitas.

  • O ícone Notas de ação abre uma área na qual é possível incluir uma descrição, documentação, comentários ou quaisquer outras anotações para ajudar a controlar seu trabalho à medida que você constrói uma ação.

O editor de ação suporta sintaxe básica de Markdown.

Etapas

Uma ação consiste em uma ou mais etapas. As etapas em uma ação definem os turnos da conversa que seguem a entrada inicial do cliente que acionou a ação. Em um caso simples, uma etapa pode consistir em uma resposta direta a uma pergunta do cliente; por exemplo, se o cliente perguntar What are your business hours?, uma ação de uma etapa pode responder com We are open Monday through Friday from 9 AM to 5 PM..

Porém, o mais comum é que uma ação exija várias etapas para entender completamente a solicitação do cliente. Para o nosso exemplo I want to withdraw money, precisamos de mais informações:

  • De qual conta deve vir o dinheiro?
  • Qual é a quantidade para retirar?

Cada uma dessas perguntas de acompanhamento representa uma etapa na ação.

Editando uma etapa

Dentro de uma etapa, você define o seguinte:

  • Um título da etapa que descreve o que a etapa faz O título da etapa é opcional
  • Quaisquer condições que determinem se a etapa é processada no tempo de execução. (Por padrão, uma etapa é sempre processada se a entrada do usuário corresponder)
  • O que o assistente diz para o cliente quando a etapa é processada.
  • Regras para como o cliente pode responder o que o assistente diz (se alguma resposta for esperada).
  • O que fazer após a etapa ser concluída

Editor de ações mostrando partes de uma etapa
Etapa

Vamos editar a etapa 1 para saber de qual conta o cliente quer retirar dinheiro:

  1. Clique no ícone Editar título da etapa e insira o título Determinar conta

  2. No campo Is taken, use o valor padrão de without conditions (sem condições ). Essa etapa será sempre necessária para qualquer retirada.

  3. No campo Assistente diz, digite Withdraw from which account?.

  4. Clique em Definir resposta do cliente.

    Definindo a resposta do cliente para uma etapa
    Definir resposta do cliente

    Como estamos pedindo ao usuário para selecionar em uma lista de opções predefinidas, clique em Opções. A janela Editar resposta é aberta.

  5. No campo Opção 1, digite Savings. Assim que você digitar um valor para a opção 1, será exibido um campo para a opção 2.

    Editar uma resposta de Opções
    Editar resposta

    Clique em Opção 2 e digite Checking.

    Clique em Aplicar para salvar a resposta ao cliente.

  6. Agora podemos verificar se a etapa funciona como esperamos. Clique em Visualizar para abrir a área de janela Visualizar e digite I want to withdraw money:

    Visualizar ação com uma etapa
    Visualizar

    Como esperado, agora o assistente solicita que você selecione a conta da qual deseja retirar dinheiro.

Duplicando uma etapa

É possível duplicar uma etapa para não precisar recriar configurações e customizações variáveis. A duplicação de uma etapa é útil quando é preciso incluir uma etapa semelhante a uma etapa anterior, mas com pequenas modificações.

Conclua as etapas a seguir para duplicar uma etapa:

  1. Clique no ícone Duplicar na etapa que deseja duplicar.

    Botão Duplicar em uma etapa
    Ícone Duplicar

    Uma etapa aparece imediatamente após a etapa que você duplicou. Essa etapa é idêntica à etapa duplicada e exibe um círculo azul na parte superior direita para indicar que a etapa é uma duplicata.

    Etapa duplicada
    Etapa duplicada

  2. Edite as informações na nova etapa conforme necessário.

Incluindo etapas condicionais

Suponhamos que nosso banco cobre uma taxa para saques de contas correntes e precisamos confirmar que o cliente entendeu. Nossa ação precisa ter um comportamento ligeiramente diferente, dependendo do tipo de conta que o cliente selecionar. Isso pode ser abordado usando condições de etapa.

Quando uma etapa pede informações do usuário, a resposta do usuário é armazenada como uma variável de ação. Ao fazer referência às variáveis de ação armazenadas por etapas anteriores, é possível construir condições de etapa com base nas respostas anteriores do cliente.

  1. Clique em Nova etapa.

  2. No campo A etapa 2 é tomada, selecione com condições. A seção Condições é expandida.

    Editor de ação: especificando condições
    Condições

  3. Por padrão, uma condição é criada automaticamente com base na variável de ação armazenada na etapa anterior (Withdraw from which account?). No entanto, por padrão, ela está verificando um valor de Savings, que não é o que queremos. Clique no campo de valor e selecione Checking como alternativa.

    Editando uma condição para selecionar Verificar como o valor para verificar
    Editar condição

  4. No campo Assistente diz, digite Withdrawals from checking accounts might incur a fee. Do you want to continue?

  5. Clique em Definir resposta do cliente e selecione Confirmação, que tem as opções Yes e No.

    Clique em Aplicar para salvar a resposta ao cliente.

  6. Como queremos garantir que o cliente sempre concorde explicitamente, clique no ícone Configurações para abrir Configurações de resposta ao cliente, em seguida, selecione Sempre peça essas informações, independentemente de mensagens anteriores.

    Configurações de resposta do cliente
    Configurações de resposta do cliente

Agora precisamos de outra etapa condicional para lidar com a situação em que o cliente decide não continuar.

  1. Clique em Nova etapa.

  2. No campo A etapa 3 é tomada, selecione com condições.

  3. Edite a condição para que ela verifique se a resposta do cliente na etapa 2 foi No.

    Editor de ações: especificando condições
    Editar condições

  4. No campo Assistente diz, digite Canceling transaction..

  5. No campo E depois, selecione Terminar a ação. Se essa etapa for executada (o que significa que o cliente decide não prosseguir), nenhuma etapa subsequente da ação será executada.

Não precisamos de uma etapa condicional para lidar com uma resposta de Yes na etapa 2 porque, nessa situação, o processamento continua normalmente.

Obtendo a quantia

Precisamos de mais uma informação para concluirmos a solicitação do cliente: a quantia de dinheiro a ser retirada.

  1. Clique em Nova etapa.

  2. No campo Assistente diz, digite How much do you want to withdraw?.

  3. Clique em Definir resposta do cliente. Precisamos que o cliente especifique um valor monetário, portanto, selecione Currency.

Concluindo a ação

Agora temos todas as informações de que precisamos. No nosso exemplo, não vamos implementar nenhuma lógica real para fazer uma retirada, mas podemos enviar uma mensagem final para resumir o que estamos fazendo.

Para fazer esse resumo, precisamos inserir variáveis de ação (que representam as respostas do cliente de etapas anteriores) em nossa resposta. Em tempo de execução, essas variáveis de ação são substituídas pelos valores reais fornecidos pelo cliente.

  1. Clique em Nova etapa.

  2. Agora precisamos construir uma mensagem de confirmação que diz "OK, vamos retirar quantia da conta account_type."

    Para criar essa resposta, digite o texto da mensagem no campo Assistente diz, mas no lugar dos valores variáveis, clique no ícone Inserir uma variável Ícone da variável de ação para inserir referências às variáveis de ação:

    • Para quantia, selecione 4. Quanto deseja retirar?.
    • Para account_type, selecione 1. Retirar de qual conta?.

    Editor de ação: mensagem incluindo referências variáveis

  3. Como essa é a última etapa na ação, não é preciso especificar nenhuma resposta ao cliente.

Se você decidir que uma etapa não é mais necessária, ela poderá ser excluída da ação. Para excluir uma etapa, clique no ícone Excluir Ícone Excluir etapa no tile da etapa.

Testando a ação

Agora você pode testar a ação para ter certeza de que ela funciona. Clique em Visualizar para abrir a área de janela Visualizar. Se o texto de um teste anterior ainda aparecer, clique no ícone Atualizar visualização para reiniciar a conversa.

Comece digitando I want to withdraw money. Experimente várias permutações de entrada para testar como o assistente se comporta:

  • Tente selecionar Savings e Checking. Confirme que se você selecionar Checking, o assistente avisará sobre a incorrência de uma taxa e perguntará se você deseja continuar, mas se você selecionar Savings, ele continuará sem o aviso.

  • Ao selecionar Checking, tente ambas as respostas quando o assistente perguntar se você deseja continuar. Confirme que se você selecionar No, a ação terminará.

  • Tente incluir informações adicionais em sua mensagem inicial. Por exemplo, tente digitar I want to withdraw $50 from my savings account. Confirme se o assistente não pede novamente que você especifique as informações que já forneceu.

É isso! Você criou uma ação simples que inclui várias etapas, coleta informações que armazena como variáveis de ação e condiciona suas respostas com base no que o cliente escolhe. É possível fazer muito mais com as ações, mas tudo isso é construído sobre esse padrão básico.

Renomeando uma ação

Se quiser renomear sua ação, execute as etapas a seguir:

  1. Clique no menu Overflow ícone Overflow na ação que você deseja renomear e selecione Renomear.

  2. Clique no campo Título da ação para alterar o título da ação que você vê.

  3. Clique no campo Nome de exibição (opcional) para alterar o título da ação que o usuário vê.

Ações de pesquisa e filtragem

Se você quiser pesquisar uma ação, execute as seguintes etapas:

  1. Clique na barra de pesquisa na página Ações e digite o nome da ação.

  2. Clique no ícone de filtro ícone de filtro para filtrar por subação, extensão ou variável.

  3. Clique em Aplicar.

Limites de ação

O número de ações, etapas e variáveis que podem ser criadas depende do seu tipo de plano do watsonx Assistant .

Detalhes do plano
Plano Ações Etapas Variáveis
Lite 100 1.000 2.000
Avaliação 100 1.000 2.000
Plus 2.000 5.000 8.000
Enterprise 2.000 5.000 8.000
Enterprise com isolamento de dados 2.000 5.000 8.000