Consejos para Crear Frases de Ejemplo Certificables en tu Skill Alexa
En nuestra entrada de blog anterior te comentabamos que la mayoría de las skills de Alexa enviadas para certificación se topan con una serie de problemas comunes. Las frases de ejemplo incorrectas son la razón más frecuente por la que las Skills de Alexa fallan el proceso de certificación. Para ayudarte a evitar este problema vamos a hacer un repaso de los requisitos que tienen las frases de ejemplo y compartiremos algunas de las mejores prácticas.
¿Qué son las Frases de Ejemplo?
Para poder enviarnos tu Skill y comenzar el proceso de certificación tienes que proveer al menos una frase de ejemplo en la pestaña Distribution de la consola de desarrollo de Skills Alexa.
Los usuarios pueden ver estas frases de ejemplo en la entrada descriptiva de la Skill una vez que la descubren. Nos gusta pensar en este conjunto de frases como una guía que le muestra a los usuarios como comenzar a usar fácilmente la Skill en sus dispositivos con Alexa. También es una buena oportunidad para mostrar las funcionalidades clave de tu Skill.
La estructura básica que usan las frases de ejemplo para abrir Skills se describe en nuestra documentación, y lo resumimos a continuación:
[Palabra de Activación], [Palabra de Lanzamiento] [Nombre de Apertura] [Conector] [Enunciado]
Palabra de activación (wake word): Se utiliza “Alexa” por defecto en dispositivos Alexa, pero los clientes pueden cambiarla en sus preferencias. Debes usar “Alexa” como palabra de activación en tus frases de ejemplo. No olvides comenzar tu primera frase de ejemplo con "Alexa" y pon una coma luego de la palabra de activación.
Palabra de lanzamiento (launch word): Como lo especificamos en la documentación, esto incluye varias frases de lanzamiento como "abre," "pregúntale," "empieza," "lanza," "comienza," ,"corre," "jugar," "dile," "dame," “pide,” y más. Cuando estas frases combinan bien con tu nombre de apertura (ver abajo) le resultará más fácil al usuario recordar como abrir tu Skill.
Nombre de apertura (invocation name): Este es el nombre de apertura que le has asignado a tu Skill al crearla en developer.amazon.com/alexa. Puedes consultar nuestra documentación para ver los requisitos. Además, si utilizas un nombre propio asegurate que tienes derrecho a utilizarlo (cuidado con las marcas registradas).
Conector (connecting word): Estas son palabras que se usan para conectar la palabra de lanzamiento con los enunciados e incluyen a "y," "de," "desde,” “usando,” "que," "sobre," "por," "si," y más. Para una lista completa echa un vistazo a nuestra documentación. A pesar de que este componente puede ser omitido, el incluirlo hará que los usuarios entiendan y digan mejor la frase.
Enunciado (utterance): son obligatorios y deben aparecer en las frases de ejemplo de tu modelo de interacción (es decir los enunciados de tus frases de ejemplo deben estar en tu modelo de interacción y ser idénticos).
En la frase de ejemplo "Alexa, abre cookpad y busca una receta de tortilla de patatas" , "Alexa" es la palabra de activación, "abre" es la palabra de lanzamiento, "cookpad" es el nombre de apertura, "y" es el conector y "busca una receta de tortilla de patatas" es el enunciado.
Y aquí tienes un ejemplo válido que no utiliza conector: "Alexa, pregúntale a cookpad como hacer tortitas", donde "Alexa" es la palabra de activación, "pregúntale a" es la palabra de lanzamiento (en este caso una frase), "cookpad" es el nombre de apertura y "como hacer tortitas" es el enunciado.
Problemas Comunes con Frases de Ejemplo
A continuación te ofrecemos una lista con los contratiempos más comunes que vemos en las frases de ejemplo y sus requisitos:
- Faltan componentes: En muchos casos las frases de ejemplo no tienen el nombre de apertura o la palabra de lanzamiento correctas. Por ejemplo: "Alexa, pide revisar mi balance". Sin el nombre de apertura especificado luego de un "pide a" y antes del enunciado que comienza con "revisar" Alexa no va a responder de forma apropiada. A veces también vemos aquí nombres de Intenciones reemplazando al nombre de apertura (esto también es incorrecto).
Aquí tienes otro ejemplo que también vemos en las Skills que nos envían: "Alexa, Voz Social los tópicos más importantes". En esta caso Alexa podría no responder adecuandamente porque falta la palabra de lanzamiento - No basarse en enunciados de muestra: Cada frase de ejemplo debe ser creada en base a los enunciados de muestra presentes en tu modelo de interacción. Por ejemplo "Alexa, pregúntale a Registro de Mareas cuando hay marea alta en Barcelona" debe tener un enunciado idéntico para proveer una respuesta válida:
"samples": [
"cuando hay marea alta en {ciudad}",
"..."
]Si el enunciado no existe, Alexa no podrá mapear la frase de ejemplo a la Intención correcta. La Skill no sabrá como responder y la experiencia de usuario será pobre. Además, como puedes ver en el ejemplo de arriba, si la frase que utilizas tiene Slots debes asegurarte que el valor de Slot que utilizas (e.g. Barcelona) es un valor válido para el tipo de Slot utilizado (y si es un Custom Slot el valor debe coincidir con alguno de los valores que has asignado al tipo). Vemos este problema en un gran porcentaje de las Skills que nos envian.
3. Respuestas erróneas: Asegúrate de que cuando el usuario utilice una frase de ejemplo obtendrá una respuesta relevante. En muchas de las Skills que se envian para certificación vemos problemas con respuestas potencialmente confusas:
User: "Alexa, préguntale a busca recetas como hacer tortitas."
Skill: "Bienvenido a Busca Recetas. Puedes hacerme preguntas como, cual es la receta para tortitas. ¿Cómo te puedo ayudar?"
Esperamos que estos consejos te hayan sido de utilidad para crear y certificar tus Skills. Si tus frases completas están estructuradas correctamente, se basan en enunciados de muestra y proveen respuestas relevantes, tendrás más posibilidades de pasar rápidamente el proceso de certificación. Echa un vistazo a nuestra entrega anterior para mas consejos sobre la certificación.
Envíanos tus Comentarios
Como de costumbre nos interesa saber sobre tu experiencia con la certificación para poder mejorar el proceso. Por favor envianos tus comentarios en este formulario.
Recursos Relacionados
Para acceder a más recursos sobre Distribución y Certificación de tu Skill mira los siguientes enlaces: