Criando seu assistente de IA com ações

Editar online

No criador de assistentes de IA, uma _ação _ representa um resultado específico que você deseja que seu assistente de IA execute em resposta à solicitação de um usuário. Uma ação é composta por etapas, que são as instruções predefinidas para a conversa entre um cliente e o assistente de IA. Essa conversa começa com a entrada do usuário que dá início à ação (por exemplo, I want to withdraw money). Em seguida, pode incluir mais trocas de mensagens à medida que o assistente de IA coleta mais informações, e termina quando o assistente de IA conclui as tarefas solicitadas ou responde à pergunta do cliente.

Você pode usar o criador de assistentes de IA para desenvolver assistentes de IA que funcionam como um assistente pessoal humano. Você pode criar seu assistente de IA definindo açõe s orientadas por IA, açõe s baseadas em habilidades ou açõe s personalizadas.

Os exemplos neste tópico estão relacionados a um caso de uso sobre a construção de uma ação para retirada de dinheiro. Adapte os valores de exemplo para construir uma ação que se ajuste ao caso de uso.

Criação de uma ação orientada por IA

SaaS

É possível criar ações orientadas por IA para ajudar seus assistentes a responderem a um conjunto específico de consultas que são baseadas no conhecimento e nas instruções pré-carregadas

Importante:

Se você estiver na experiência de agente de IBM watsonx Orchestrate, as ações orientadas por IA podem não estar disponíveis.

Para criar uma ação orientada por IA, siga estas etapas:

  1. Clique no bloco do criador de assistentes de IA em watsonx Orchestrate para acessar o criador de assistentes de IA.

  2. No criador de assistentes de IA, vá para Ações > Nova ação > Ação orientada por IA.

  3. Na caixa Novo ação de diálogo, digite a frase que o cliente deve digitar para iniciar a interação.

  4. Clique em Salvar.

  5. Na página Ação orientada por IA , selecione o grande modelo de idioma (LLM) na lista suspensa Selecionar um modelo . Para obter mais informações sobre modelos, consulte Modelos de fundação suportados para diferentes componentes.

  6. Opcional: no campo Incluir conhecimento , é possível incluir um conteúdo, que é a referência de conhecimento para a ação guiada por IA. Esse conhecimento é enviado para o LLM juntamente com o prompt

: Você pode concatenar o texto de referência de conhecimento com valores de variáveis de sessão. Para fazer isso, faça referência à variável de sessão usando a estrutura ' ${}. Por exemplo, ${sessionVariable}. Ao fazer isso, certifique-se de que a variável não esteja vazia; caso contrário, o nome da variável será exibido no chat do assistente de IA.

  1. Na seção Incluir instruções do prompt , clique no botão Incluir instruções se desejar incluir instruções para o prompt padrão em seu assistente

  2. Insira as instruções de prompt no campo Instrução de prompt que ajudam o LLM em seu assistente a fornecer respostas refinadas e orientar as conversas com clareza e especificidade..

: Você pode concatenar o texto das instruções do prompt com os valores das variáveis da sessão. Para fazer isso, faça referência à variável de sessão usando a estrutura ' ${}. Por exemplo, ${sessionVariable}. Quando fizer isso, certifique-se de que a variável de sessão não esteja vazia; caso contrário, o nome da variável será exibido no chat do assistente de IA.

Criando uma ação baseada em habilidades

As ações baseadas em habilidades, também conhecidas como ações de habilidades de conversação, são as habilidades que você adiciona aos assistente s de IA para implementar a coordenação de conversas específicas. Crie açõe s a partir das habilidades disponíveis em IBM watsonx Orchestrate, utilizando a API ou a interface do usuário.

Importante:

Se você estiver na experiência de agência de IBM watsonx Orchestrate, as ações baseadas em habilidades podem não estar disponíveis.

Antes de iniciar

Cumpra os seguintes requisitos, conforme necessário, antes de criar suas ações baseadas em habilidades.

Requisitos para criar ações baseadas em habilidades

Você deve se conectar ao aplicativo da habilidade para que ela apareça como uma opção para ações baseadas em habilidades. Para obter mais informações, consulte Gerenciamento de conexões.

As ações baseadas em habilidades podem ter problemas e limitações conhecidas que afetam seu uso. Para obter mais informações, consulte “Ações baseadas em habilidades”.

Requisitos para criar ações baseadas em habilidades a partir de fluxos de habilidades

A criação de ações baseadas em habilidades a partir de fluxos de habilidades exige que você ajuste as habilidades componentes dos fluxos de habilidades para atender aos seguintes critérios:

Por padrão, todas as habilidades são de conversação, a menos que a anotação x-ibm-conversational-skill seja definida como false. Os fluxos de habilidades não possuem a x-ibm-conversational-skill propriedade que permite defini-los como ações baseadas em habilidades. Certifique-se de que as habilidades dos componentes sigam os critérios anteriores para tornar os fluxos de habilidades elegíveis para criar ações.

Todas as habilidades componentes devem estar conectadas ao conjunto de habilidades. wo-identity A habilidade de construtor de automação baseada em é considerada conectada por padrão.

Todas as habilidades componentes devem ser publicadas no conjunto de habilidades.

Por padrão, todos os fluxos de habilidades criados podem usar apenas habilidades visíveis.

Criação de ações baseadas em habilidades usando a API

Para criar uma ação baseada em habilidade usando a API, você deve primeiro criar uma especificação OpenAPI da habilidade.

Depois disso, você pode importar a habilidade usando o endpoint “Import skills” na API do watsonx Assistant. Quando isso for feito, você poderá usar a habilidade em seu assistente.

Criação de ações baseadas em habilidades usando a interface do usuário

Para criar uma ação baseada em habilidades usando a interface do usuário, siga estas etapas:

  1. Clique no bloco do criador de assistentes de IA em watsonx Orchestrate para acessar o criador de assistentes de IA.

  2. No criador de assistentes de IA, vá para Ações > Nova ação > Ação baseada em habilidade.

  3. Na página “Criar uma ação a partir de uma habilidade ”, clique na habilidade à qual deseja vincular a ação, tornando-a a base da sua ação. Se você não conseguir ver sua skill, verifique se ela está ativada no conjunto de skills correspondente ao seu assistente.

  4. No campo “Nome da ação ”, digite um nome para a sua ação.

  5. Em Incluir condições de ação, é possível incluir ou editar as condições para o acionador de ação

Para obter mais informações, consulte Incluindo ou editando condições para acionar uma ação para qualificação

  1. No campo “Digite uma frase ”, insira a frase que os clientes devem digitar ou perguntar para acionar uma ação na habilidade “ watsonx Orchestrate ”. Por exemplo, I want to pay my electricity bills.

  2. Você pode usar as seguintes opções no canto superior direito da página para melhorar a experiência com o assistente de IA :

    • Modo de resposta à ação

Define o modo de resposta do seu assistente de IA, como “Esclarecedor” ou “Confiado”**.

  • Notas de ação

Abre a janela "Notas da ação" para adicionar uma descrição, documentação, comentários ou quaisquer outras anotações que ajudem você a acompanhar seu trabalho à medida que cria uma ação.

  • Configurações de ação

Abre a janela de configurações da ação para ativar ou desativar as configurações “Fazer pergunta esclarecedora” e “Mudar o tema da conversa” na ação.

  1. Clique no botão Salvar para salvar a ação.

Dica:

Quando um usuário aciona uma ação baseada em habilidade, ela pode retornar a resposta na forma de um formulário ou de uma conversa com várias trocas de mensagens. Para obter mais informações sobre como definir a forma como os usuários interagem com ações baseadas em habilidades no chat, consulte Definindo como solicitar uma habilidade em uma conversa

Criando uma ação personalizada

Você cria uma nova ação do zero quando deseja definir cada etapa da ação na sua conversa. É possível definir as etapas com ou sem condições, que ajudam a controlar as respostas do cliente..

Você também pode usar as açõe s orientadas por IA e baseadas em habilidades que criou como subações para suas etapas. Isso permite passar valores gerados entre essas açõe s para que você os utilize como desejar. Para obter mais informações sobre como usar açõe s orientadas por IA e baseadas em habilidades como subações, consulte Ir para uma subação.

Para criar uma ação do zero, siga estas etapas:

  1. Clique no bloco “As sistentes de IA” no site watsonx Orchestrate para acessar o criador de assistentes de IA.

  2. No criador de assistentes de IA, vá para Ações > Criar ação > Ação personalizada.

  3. Na caixa Novo ação de diálogo, digite a frase que o cliente deve digitar para iniciar a interação. Por exemplo, I want to withdraw money.

Nova ação}" caption-side="bottom"}

  1. Clique no botão Salvar para salvar a nova entrada e criar a ação.

Inicialmente, você precisa especificar apenas um exemplo de entrada típica do usuário que dê início à ação. É possível incluir mais exemplos de entrada de usuário posteriormente.

Definindo as etapas de uma ação

Uma ação consiste em uma ou mais _etapas_. As etapas de uma ação formam uma sequência de solicitações que definem as trocas de mensagens com o usuário após a inserção da frase que aciona a ação. Em um caso simples, uma etapa pode consistir em uma resposta direta para uma pergunta do cliente. Por exemplo, se o cliente perguntar What are your business hours?, um assistente de IA com uma ação de uma única etapa responde com We are open Monday through Friday from 9 AM to 5 PM..

Uma ação requer várias etapas para compreender totalmente a solicitação do cliente. Por exemplo, para a entrada do usuário I want to withdraw money, o assistente de IA requer as seguintes informações adicionais:

  • De qual conta deve vir o dinheiro?

  • Qual é a quantidade para retirar?

Cada uma das perguntas de acompanhamento representa uma etapa da ação.

No criador de assistentes de IA, você pode adicionar, editar ou duplicar etapas de uma ação. 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

Consulte os tópicos a seguir para obter mais informações sobre como adicionar, editar e duplicar etapas em ação :

Incluindo uma nova etapa

Depois de inserir a frase para iniciar a interação, você deve adicionar etapas a uma ação para criar o fluxo da conversa. Para incluir uma etapa, use as seguintes instruções:

  1. No criador de assistentes de IA, vá para Página inicial > Ações.

  2. Clique no botão Nova etapa na área de janela Etapas de Conversa para incluir uma etapa

Editando uma etapa

Editor de ação mostrando partes de uma etapa

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

  2. No campo É usado , use o valor padrão de 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

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

  1. No campo Opção 1, digite Savings. Ao inserir um valor para a opção 1, um campo aparece para a opção 2.

Editando uma resposta Opções

Clique em Opção 2 e digite Checking.

Clique em Aplicar para salvar a resposta ao cliente.

  1. 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:

Visualizando a ação com uma etapa

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

Duplicando uma etapa

Duplique uma etapa se você desejar criar uma etapa semelhante a outra, 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 duplicado em uma etapa

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

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

Incluindo etapas condicionais

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

Quando uma etapa solicita informações ao usuário, a resposta deste é armazenada como uma _variável de ação_. Ao consultar as variáveis de ação armazenadas pelas etapas anteriores, você pode definir condições para a etapa com base nas respostas anteriores do seu 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ções: especificando condições

  1. Por padrão, uma condição é criada automaticamente com base na variável de ação armazenada pela etapa anterior (Withdraw from which account?). No entanto, por padrão, ele 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 a ser verificado

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

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

Clique em Aplicar para salvar a resposta ao cliente.

  1. Como queremos ter certeza de que o cliente sempre concorda explicitamente, clique no ícone Configurações para abrir Configurações de resposta do clientee, em seguida, selecione Sempre solicitar essas informações, independentemente de mensagens anteriores.

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 para a etapa 2 foi No

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

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

  2. No campo E depois, selecione Terminar a ação. Se essa etapa for executada (significando que o cliente decide não continuar), nenhuma etapa subsequente na ação será executada.

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

Usando o editor de ações

Quando você cria a ação, o editor de ações é aberto

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

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. É possível visualizar o assistente a qualquer momento para ver o efeito das mudanças 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 ajudá-lo a controlar seu trabalho conforme você constrói uma ação.

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

Visualizando o desenrolar da ação

Depois de criar uma ação do início, você tem a opção de alternar entre a guia Editar e a guia Visualização . Acesse a guia Visualização para visualizar o fluxograma da ação.

Editor

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

Visualização

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 uma quantia monetária, portanto, selecione Moeda.

Concluindo a ação

Agora temos toda a informação de que precisamos. Para 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 (representando respostas de clientes de etapas anteriores) em nossa resposta. No 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 esta resposta, digite o texto da mensagem no campo “O Assistente diz”, mas, no lugar dos valores das variáveis, clique no ícone Ícone de variável de ação “Inserir uma variável” 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 de variáveis

  1. 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 de etapa Excluir no bloco correspondente à 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 uma conversa anterior ainda estiver visível, clique no ícone Atualização da visualização Atualizar 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 na 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ê construiu uma ação simples que inclui várias etapas, coleta informações que ela armazena como variáveis de ação e condiciona suas respostas com base no que seu 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 de opções Ícone de estouro da 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.