Introdução às ações do bot
Uma ação do bot é um componente que permite programar condições lógicas que levam a respostas e associar ações do usuário para criar fluxos conversacionais complexos. As ações do bot geralmente são acionadas por intenções, mas também podem ser ativadas por um filtro.
📌 Observação:
Não há diferença técnica entre uma "ação inicial do bot" e uma "ação do bot" padrão.
Execução de uma ação do bot
Uma ação do bot é executada de acordo com estas regras:
Chamadas de API: Executadas na ordem das conexões de API.
Condições: Avaliadas de cima para baixo. A primeira condição correspondente determina a resposta exibida ao usuário.
Conexões de API
Tutorial em vídeo
Assista a um tutorial passo a passo sobre a integração de APIs externas na sua plataforma ViaSay Chatbot em Tutoriais em vídeo.
Quando usar conexões de API
Use conexões de API ao interagir com sistemas externos por meio de APIs web ou de uma Base de Conhecimento hospedada pela ViaSay.
Adicionar uma conexão de API
Clique em Adicionar uma conexão de API.
Selecione uma API (observação: configure a API primeiro na seção Integrate/APIs).
Executar em paralelo
As chamadas de API são executadas sequencialmente por padrão. Ative a configuração "Executar em paralelo" para executar várias conexões simultaneamente. Observe que a ordem de execução não pode ser controlada no modo paralelo.
Entradas e saídas
Entradas: Defina os campos de entrada aceitos pela API. Para entradas obrigatórias:
Use um nome de variável do contexto do bot.
Envie valores fixos como strings.
Envie JSON convertendo-o em uma string e, em seguida, desfazendo essa conversão usando filtros e funções Jinja.
Saídas: Atribua nomes de variáveis para que a resposta da API apareça no contexto do bot. Evite conflitos entre as variáveis de saída.
Entrada padrão: "status_code" (armazena o código de status da API).
Loops
Ative loops para chamadas de API repetitivas:
For: Especifique a variável de entrada que será alterada.
Em: Defina a lista de elementos sobre os quais o loop será executado (use JMESPath).
Os loops estão limitados a 8 chamadas por API. .
Condições e respostas
Condições
Instruções IF: Use Jinja para escrever condições. Variáveis, funções e extensões da ViaSay podem ser utilizadas. Para execução incondicional, use IF True.
Ir para: Direcione o usuário para outro nó no grafo conversacional. As opções incluem:
Ação inicial do usuário: redireciona para o início de outro caso de uso.
Ação atual do usuário: mantém o usuário na ação atual (por exemplo, após uma resposta de incompreensão).
Apagar: Defina as variáveis a serem apagadas após a execução. As opções incluem:
"erase_all": Redefine o contexto."erase_all_except variable1, variable2": Mantém as variáveis especificadas.
Eventos: Acione eventos para análises quando uma condição for correspondente.
Agendadores
Adicione agendadores clicando no ícone de ação.
Respostas
As respostas são exibidas aos usuários após a execução de uma ação do bot. Elas são acionadas por condições dentro das ações do bot.