Compartir:
){kind=small}
Benjamin Aronov es desarrollador de Vonage. Es un constructor de comunidades con experiencia en Ruby on Rails. Benjamin disfruta de las playas de Tel Aviv, a la que llama hogar. Su base en Tel Aviv le permite conocer y aprender de algunos de los mejores fundadores de startups del mundo. Fuera de la tecnología, a Benjamin le encanta viajar por el mundo en busca del perfecto pain au chocolat.
Prueba los agentes de WhatsApp con el comprobador integrado de AI Studio
Tiempo de lectura: 5 minutos
Una de las prácticas de codificación más arriesgadas es escribir grandes cantidades de código sin realizar pruebas periódicas para asegurarse de que todo funciona según lo previsto. El mismo principio se aplica al no-código/bajo-código. Afortunadamente, AI Studio tiene un comprobador incorporado para asegurar que tu código funciona en cada paso.
Este artículo le mostrará cómo empezar a utilizar el probador de AI Studio para agentes de WhatsApp y evitar algunos errores comunes.
Regístrate para obtener una cuenta API de Vonage
Pruebe a crear un agente; consulte nuestros tutoriales para empezar
To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.
El primer paso es abrir el probador dentro del Canvas de su Agente. Haga clic en el botón negro grande en la parte superior derecha del lienzo que dice Probador. Esto abrirá el Probador. Puede elegir qué evento probar (si tiene varios) y si desea probarlo en el lienzo de AI Studio o directamente en WhatsApp.
Tenga en cuenta que el chat de prueba en WhatsApp es temporal y que aún tendrá que comprar un número y publicar un agente para el uso público de su agente.
A screenshot of the AI Studio built-in tester interface, allowing users to start a chat or test an agent directly in WhatsApp.Haz clic en el botón "Iniciar chat" y, siempre que tengas algún nodo de conversación conectado a tu agente, podrás empezar a interactuar inmediatamente con él. ¡Qué guay!
La característica más importante del comprobador es la posibilidad de utilizar parámetros/variables de prueba. Los parámetros de prueba nos ayudan a identificar si los errores del agente se deben a la lógica de flujo o a entradas erróneas. Para acceder a los parámetros de prueba, haga clic en el icono de engranaje/ajustes situado en la parte superior de la ventana del comprobador. Para cerrar el panel, vuelva a hacer clic en el icono de engranaje.
AI Studio showing a chatbot flow and the tester being opened to start a test session.Los flujos de agentes a menudo se basan en datos de usuario (como el número de teléfono del usuario) para integrarse con sistemas externos. Podemos añadir parámetros de prueba para este tipo de variables bajo Parámetros del sistema. Además, las variables creadas específicamente para su agente aparecerán bajo Parámetros personalizados Establecer valores para parámetros de prueba es muy útil para depurar nodos de integración como el nodo Webhook o los nodos Salesforce.
Considere el siguiente nodo Webhook, que conecta el agente a una hoja de Google. La configuración de la integración es un poco avanzada y puede dar lugar a muchos tipos diferentes de errores; el código en los scripts de Google Apps, una URL de solicitud malformada, un parámetro de consulta incorrecto, o algo más.
A screenshot of an AI Studio Webhook node configured to retrieve a price using a GET request with a query parameter.Puedes ver que tenemos el botón "Test request" en el nodo Webhook. Sin embargo, si pulsamos enviar, obtendremos el siguiente error: "error": "Item not found."
Eso es porque nuestra petición tenía este aspecto:
https://script.google.com/macros/s/AKfycbw5hzozzPWXB6-3f27iYA2-ug-rnJwl22ZdEXaBdemuPC4pds9NLzAC5mAQmDGMqfs/exec?item=
El elemento estaba en blanco. Afortunadamente, podemos corregirlo abriendo nuestros parámetros de prueba haciendo clic en el icono del engranaje y actualizándolos con un valor que estemos seguros de que existe en nuestra hoja de cálculo. Y ahora podemos ver que hemos recibido una buena respuesta.
A screenshot of AI Studio's test parameters panel and webhook test request, showing how setting an initial parameter affects the response.
Consejo: Un problema común con los datos es pasar cadenas cuando se esperan números y viceversa. El uso de variables de prueba puede ayudar a identificarlo rápidamente.
A menudo, los usuarios realizan actualizaciones, como cambiar los parámetros de prueba, y no ven ninguna diferencia en el rendimiento de la prueba del agente. Esto se debe a que no han actualizado el comprobador para obtener la última versión. Si tiene abierto el comprobador, deberá hacer clic en el icono de actualización antes de ejecutar un nuevo flujo de prueba.
AI Studio showing a chatbot test session where a user interacts with an agent to retrieve a price.
Es posible que se encuentre con errores una vez que haya empezado a ejecutar su flujo de agentes en el comprobador. Es normal. Cada burbuja de chat en el probador tiene dos iconos. El primer icono de enlace externo ajustará el lienzo para mostrarle el nodo responsable de esa salida. El segundo icono de código abrirá la ventana Debug que muestra el código JSON de la ejecución del flujo.
En el siguiente ejemplo, puedes ver lo útil que es la ventana Debug. En este chat, introducimos la entrada "banana" y el webhook parece ejecutarse sin errores. Sin embargo, no obtenemos un precio para la pantalla.
A screenshot of an AI Studio chat session where a webhook executes successfully, but the agent fails to return the expected price.Nuestro primer paso es asegurarnos de que el nodo Enviar Mensaje muestra nuestro parámetro correctamente. Así que establezcamos nuestro parámetro precio a 100. Y como podemos ver, ahora el precio se muestra como $100. Así que algo debe estar sucediendo en el nodo Webhook.
AI Studio's test parameters panel being used to define values for debugging a chatbot flow.
Esta vez, podemos abrir la ventana Debug pulsando sobre el icono de código en el mensaje webhook. Esto abre el registro JSON de todo lo que se ha ejecutado hasta ahora en nuestro agente. Podemos buscar "web" para encontrar más fácilmente el nodo en cuestión. ¡Y aquí encontramos al culpable!
Consejo: la búsqueda de "error" facilita la localización del error correcto cuando varias cosas van mal.
AI Studio's tester showing a chatbot conversation where a webhook executes successfully, but the agent fails to return a price, requiring debugging.Aunque el estado del nodo webhook muestra "SUCCESS", el mensaje que recibimos en el campo "text" no contiene un precio. En su lugar, muestra:
{"error":"Item not found."}
Y eso tiene sentido porque plátano no está en nuestra hoja de cálculo.
Consejo: Para encontrar el error más rápidamente, utilice ctrl+f o cmd+f
El probador integrado te permite probar tu agente directamente en WhatsApp. También es la forma recomendada de probar porque es la más cercana a la realidad, ya que algunas funcionalidades pueden faltar en el probador de Studio.
Abre el Probador y esta vez haz clic en "Probar en Whatsapp". Se abrirá una pantalla con un código QR y un enlace. Escanee el código QR con su teléfono o haga clic en el enlace. Se abrirá un chat con una versión de prueba de tu agente.
Inicie el chat enviando la frase de contraseña generada. Después, tu agente se ejecutará según el flujo. Incluso puedes compartir el enlace al chat para que otros prueben el agente.
Nota: Los chats de prueba caducan, con un máximo de 24 horas. Puede que necesite regenerar el chat reabriendo el probador y volviendo a escanear el código QR/enlace. Sin embargo el chat de prueba no funcionará como agente de producción, necesitará publicar su agente para que funcione.
A screenshot of the AI Studio tester interface displaying a QR code for testing an agent in WhatsApp.
Ahora que ya has visto cómo utilizar y depurar con el comprobador integrado en AI Studio, no hay nada que te impida crear increíbles chatbots de WhatsApp. Tenemos una amplia selección de tutoriales de AI Studio o crea tu propia integración y cuéntanosla. Si te quedas atascado o no sabes cómo solucionar un error con el comprobador, envíame un mensaje al canal de Slack de la comunidad de Vonage. Incluso tenemos un canal dedicado a AI Studio.
Compartir:
Benjamin Aronov es desarrollador de Vonage. Es un constructor de comunidades con experiencia en Ruby on Rails. Benjamin disfruta de las playas de Tel Aviv, a la que llama hogar. Su base en Tel Aviv le permite conocer y aprender de algunos de los mejores fundadores de startups del mundo. Fuera de la tecnología, a Benjamin le encanta viajar por el mundo en busca del perfecto pain au chocolat.