Teste os agentes do WhatsApp com o testador integrado do AI Studio

Introdução

Uma das práticas de programação mais arriscadas é escrever grandes blocos de código sem realizar testes periódicos para garantir que tudo funcione conforme o esperado. O mesmo princípio se aplica ao no-code/low-code! Felizmente, AI Studio possui um testador integrado para garantir que seu código esteja funcionando em cada etapa.

Este artigo vai mostrar como começar a usar o AI Studio Tester para agentes do WhatsApp e evitar alguns erros comuns.

Pré-requisitos

• Cadastre-se para obter um Account da API da Vonage

• Tente criar um agente; confira nossos tutoriais para começar

Como usar o testador integrado do AI Studio

O primeiro passo é abrir o tester dentro da tela do seu Agente. Clique no grande botão preto no canto superior direito da tela que diz “Tester”. Isso abrirá o Tester. Você pode escolher qual evento testar (se houver vários) e se deseja testar na tela do AI Studio ou diretamente no WhatsApp.

Observe que o chat de teste no WhatsApp é temporário e você ainda precisará adquirir um número e publicar um agente para que ele possa ser utilizado pelo público. 

A screenshot of the AI Studio built-in tester interface, allowing users to start a chat or test an agent directly in WhatsApp.Clique no botão “Iniciar bate-papo” e, desde que você tenha alguns nós de conversa conectados ao seu agente, poderá começar a interagir com ele imediatamente. Que legal!

Como usar os parâmetros de teste

A principal característica do Tester é a capacidade de utilizar parâmetros/variáveis de teste. Os parâmetros de teste nos ajudam a identificar se os erros do agente se devem à lógica de fluxo ou a entradas incorretas. Para acessar os parâmetros de teste, clique no ícone de engrenagem/configurações na parte superior da janela do Tester. Para fechar o painel, clique no ícone de engrenagem novamente.

AI Studio showing a chatbot flow and the tester being opened to start a test session.Os fluxos de agentes costumam depender de dados do usuário (como o número de telefone do usuário) para se integrarem a sistemas externos. Podemos adicionar parâmetros de teste para esses tipos de variáveis na seção “Parâmetros do sistema”. Além disso, as variáveis criadas especificamente para o seu agente aparecerão na seção “Parâmetros personalizados”. Definir valores para os parâmetros de teste é muito útil para depurar nós de integração, como o nó Webhook ou os nós do Salesforce.

Considere o seguinte nó Webhook, que conecta o agente a uma planilha do Google Sheets. A configuração da integração é um pouco avançada e pode resultar em diversos tipos de erros: o código nos Scripts do Google Apps, uma URL de solicitação malformada, um parâmetro de consulta incorreto ou qualquer outro problema. 

A screenshot of an AI Studio Webhook node configured to retrieve a price using a GET request with a query parameter.Você pode ver que temos o botão “Solicitação de teste” no nó Webhook. No entanto, se clicarmos em “Enviar”, receberemos o seguinte erro: "error": "Item not found."

Isso porque nossa solicitação era assim:

https://script.google.com/macros/s/AKfycbw5hzozzPWXB6-3f27iYA2-ug-rnJwl22ZdEXaBdemuPC4pds9NLzAC5mAQmDGMqfs/exec?item=

O campo estava em branco! Felizmente, podemos corrigir isso abrindo nossos parâmetros de teste clicando no ícone de engrenagem e atualizando-o para um valor que temos certeza de que existe em nossa planilha. E agora podemos ver que recebemos uma resposta correta!

A screenshot of AI Studio's test parameters panel and webhook test request, showing how setting an initial parameter affects the response.

Dica: Um problema comum com dados é passar strings quando se espera números e vice-versa. O uso de variáveis de teste pode ajudar a identificar isso rapidamente. 

Atualizando o Tester

Os usuários costumam fazer atualizações, como alterar parâmetros de teste, e não percebem nenhuma diferença no desempenho do agente durante o teste. Isso ocorre porque eles não atualizaram o testador para obter a versão mais recente. Se você tiver o testador aberto, será necessário clicar no ícone de atualização antes de executar um novo fluxo de teste.

AI Studio showing a chatbot test session where a user interacts with an agent to retrieve a price.

Como depurar comportamentos inesperados do usuário

Você pode encontrar erros assim que começar a executar seu fluxo de agente no testador. Isso é normal! Cada balão de bate-papo no testador possui dois ícones. O primeiro ícone, de link externo, ajustará a tela para mostrar o nó responsável por essa saída. O segundo ícone, de código, abrirá a janela de depuração, que exibe o código JSON da execução do fluxo.

No exemplo a seguir, você pode ver como a janela de depuração é útil. Nesse chat, digitamos “banana” e o webhook parece ser executado sem erros. No entanto, não aparece nenhum preço na tela.

A screenshot of an AI Studio chat session where a webhook executes successfully, but the agent fails to return the expected price.Nosso primeiro passo é verificar se o nó “Enviar mensagem” exibe nosso parâmetro corretamente. Então, vamos definir nosso parâmetro “price” como 100. E, como podemos ver, agora o preço é exibido como $100. Portanto, algo deve estar acontecendo no nó “Webhook”.

AI Studio's test parameters panel being used to define values for debugging a chatbot flow.

Desta vez, podemos abrir a janela de depuração clicando no ícone de código na mensagem do webhook. Isso abre o log em JSON de tudo o que foi executado até agora em nosso agente. Podemos pesquisar por “web” para localizar o nó em questão com mais facilidade. E aqui está o culpado!

Dica: pesquisar por “erro” facilita identificar o erro correto quando várias coisas dão errado.

AI Studio's tester showing a chatbot conversation where a webhook executes successfully, but the agent fails to return a price, requiring debugging.Embora o status do nó do webhook mostre “SUCCESS”, a mensagem que recebemos no campo “text” não contém um preço. Em vez disso, ela mostra:

{"error":"Item not found."}

E isso faz sentido porque banana não está na nossa planilha.  

Dica: Para localizar o erro mais rapidamente, use Ctrl+F ou Cmd+F 

Como fazer testes no WhatsApp

O testador integrado permite que você teste seu agente diretamente no WhatsApp! Essa também é a forma recomendada de teste, pois é a que mais se aproxima da realidade, já que algumas funcionalidades podem não estar disponíveis no testador do Studio.

Abra o Tester e, desta vez, clique em “Testar no WhatsApp”. Isso abrirá uma tela com um código QR e um link. Escaneie o código QR com seu celular ou clique no link. Isso abrirá um chat com uma versão de teste do seu agente.

Comece o bate-papo enviando a senha gerada. Depois disso, seu agente funcionará de acordo com o fluxo. Você pode até compartilhar o link do bate-papo para que outras pessoas testem o agente.

Observação: as conversas de teste expiram, com prazo máximo de 24 horas. Talvez seja necessário regenerar a conversa reabrindo o testador e escaneando novamente o código QR ou o link. No entanto, a conversa de teste não funcionará como um agente de produção; você precisará publicar seu agente para que ele funcione.

A screenshot of the AI Studio tester interface displaying a QR code for testing an agent in WhatsApp.

Conclusão

Agora que você já viu como usar e depurar com o Tester integrado ao AI Studio, nada mais o impede de criar chatbots incríveis para o WhatsApp. Temos uma ampla seleção de tutoriais do AI Studio ou crie sua própria integração e conte-nos sobre ela. Se você tiver alguma dúvida ou não conseguir descobrir como contornar um bug com o Tester, mande uma mensagem para mim na Slack da Comunidade Vonage. Temos até um canal dedicado ao AI Studio.