Conexión de un bot a AlexaConnect a bot to Alexa

se aplica a: SDK V4APPLIES TO: SDK v4

Puede configurar el bot para comunicarse con personas que usan dispositivos Alexa que admiten aptitudes personalizadas.You can configure your bot to communicate with people using Alexa devices that support Custom Skills.

Importante

El bot debe utilizar el SDK de bot Framework versión 4,8 o posterior.Your bot must use the Bot Framework SDK version 4.8 or later. Al crear un nuevo bot a través de Azure portal, el bot usará la versión más reciente disponible en ese momento.When you create a new bot via the Azure Portal, the bot will use the latest version available at that time. Si tiene un bot existente, es posible que tenga que actualizar la versión del SDK.If you have an existing bot you may need to update your SDK version.

Creación de una aptitud de AlexaCreate an Alexa skill

  1. Inicie sesión en la consola para desarrolladores de Alexa y, a continuación, haga clic en el botón "Create Skill" (Crear aptitud).Log into the Alexa Developer Console and then click the 'Create Skill' button.

  2. En la siguiente pantalla, escriba un nombre para la nueva aptitud.On the next screen enter a name for your new skill. En esta página puede elegir un modelo para agregarlo a su aptitud [la opción predeterminada es Custom (Predeterminado)] y elegir un método para hospedar los recursos de back-end de la aptitud [la opción predeterminada es Provision your own (Aprovisionar el suyo propio)].On this page you can Choose a model to add to your skill (Custom selected by default) and Choose a method to host your skill's backend resources (Provision your own selected by default). Deje seleccionadas las opciones predeterminadas y haga clic en el botón Create Skill (Crear aptitud).Leave the default options selected and click the Create Skill button.

    Captura de pantalla: elija un modelo y hospedaje

  3. En la siguiente pantalla se le pedirá que elija una plantilla.On the next screen you will be asked to Choose a template. La opción predeterminada es Start from scratch (Empezar desde cero).Start from scratch will be selected by default. Deje la opción Start from scratch (Empezar desde cero) seleccionada y haga clic en el botón Choose (Elegir).Leave Start from scratch selected and click the Choose button.

    Captura de pantalla: elegir una plantilla

  4. Ahora se le presentará el panel de aptitudes.You will now be presented with your skill dashboard. Vaya al editor de JSON en la sección Interaction Model (Modelo de interacción) del menú izquierdo.Navigate to JSON Editor within the Interaction Model section of the left hand menu.

  5. Pegue el código JSON siguiente en el editor de JSON, reemplazando los valores siguientes:Paste the JSON below into the JSON Editor, replacing the following values;

    • YOUR SKILL INVOCATION NAME: este es el nombre que usarán los usuarios para invocar la aptitud en Alexa.YOUR SKILL INVOCATION NAME - This is the name that users will use to invoke your skill on Alexa. Por ejemplo, si el nombre de invocación de la aptitud era "Asistente del adaptador", un usuario podría decir "Alexa, inicia el asistente del adaptador" para iniciar la aptitud.For example, if your skill invocation name was 'adapter helper', then a user would could say "Alexa, launch adapter helper" to launch the skill.

    • EXAMPLE PHRASES: debe proporcionar tres frases de ejemplo que los usuarios puedan usar para interactuar con la aptitud.EXAMPLE PHRASES - You should provide 3 example phases that users could use to interact with your skill. Por ejemplo, si un usuario puede decir "Alexa, pídele al asistente del adaptador que me dé más información sobre el adaptador de Alexa", la frase de ejemplo podría ser "dame detalles del adaptador de Alexa".For example, if a user might say "Alexa, ask adapter helper to give me details of the alexa adapter", your example phrase would be "give me details of the alexa adapter".

    {
        "interactionModel": {
            "languageModel": {
                "invocationName": "<YOUR SKILL INVOCATION NAME>",
                "intents": [
                    {
                        "name": "GetUserIntent",
                        "slots": [
                            {
                                "name": "phrase",
                                "type": "phrase"
                            }
                        ],
                        "samples": [
                            "{phrase}"
                        ]
                    },
                    {
                        "name": "AMAZON.StopIntent",
                        "samples": []
                    }
                ],
                "types": [
                    {
                        "name": "phrase",
                        "values": [
                            {
                                "name": {
                                    "value": "<EXAMPLE PHRASE>"
                                }
                            },
                            {
                                "name": {
                                    "value": "<EXAMPLE PHRASE>"
                                }
                            },
                            {
                                "name": {
                                    "value": "<EXAMPLE PHRASE>"
                                }
                            }
                        ]
                    }
                ]
            }
        }
    }
    
  6. Haga clic en el botón Save Model (Guardar modelo) y, a continuación, haga clic en Build Model (Compilar modelo), que actualizará la configuración de la aptitud.Click the Save Model button and then click Build Model, which will update the configuration for your skill.

  7. Obtenga el identificador de habilidad de Alexa desde la dirección URL en el portal de Alexa o vaya a la consola del desarrollador de Alexa y haga clic en Ver ID. de habilidad.Get your Alexa Skill Id either from the URL in the Alexa Portal or by going to the Alexa Developer Console and clicking View Skill ID. El identificador de habilidad de Alexa debe ser un valor como "amzn1. Ask. skill. A GUID".Your Alexa Skill ID should be a value like 'amzn1.ask.skill.A GUID'.

  8. En el portal de Bot Framework, vaya a la página de configuración del canal de Alexa y pegue el identificador de aptitud de Alexa en el campo Enter skill Id (Especificar identificador de aptitud).In the Bot Framework Portal navigate to the Alexa Channel Configuration page and paste your Alexa Skill Id into the Enter skill Id field.

  9. En el portal de Alexa, vaya a la sección Endpoint (Punto de conexión) en el menú de la izquierda.In the Alexa Portal navigate to the Endpoint section on the left hand menu. Seleccione HTTPS como el tipo de punto de conexión de servicio y establezca el punto de conexión de la región predeterminada en el URI del punto de conexión de servicio de Alexa que copió de la página de configuración de Alexa en Bot Framework.Select HTTPS as the Service Endpoint Type and set the Default Region endpoint to the Alexa Service Endpoint URI value copied from the Bot Framework Alexa Configuration page.

  10. En el menú desplegable situado debajo del cuadro de texto en el que ha definido el punto de conexión, debe seleccionar el tipo de certificado que se va a usar.In the drop down underneath the text box where you have defined your endpoint, you need to select the type of certificate being used. Elija My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority (Mi punto de conexión de desarrollo es un subdominio de un dominio que tiene un certificado comodín procedente de una entidad de certificación).Choose My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority.

    Captura de pantalla: elegir tipo de punto de conexión de servicio

  11. Haga clic en el botón Save Endpoints (Guardar puntos de conexión) en el portal de Alexa.Click the Save Endpoints button in the Alexa Portal.

  12. Haga clic en el botón Guardar en la página de configuración del canal de Alexa en Bot Framework.Click the Save button in the Bot Framework Alexa Channel Configuration page.

Tendrá que publicar la aptitud en Alexa para que otros usuarios puedan comunicarse con ella.You will need to publish your Skill within Alexa before users other than yourself can communicate with it. Puede probar su aptitud, antes de publicarla, en Alexa con un dispositivo Alexa de su propiedad o desde la pestaña Probar de la aptitud.You can test your skill, prior to publishing it, within Alexa using an Alexa device you own or from the Test tab for your skill. Para ir a la pestaña Probar, vaya a su aptitud en la consola para desarrolladores de Alexa.To get to the Test tab navigate to your Skill from the Alexa Developer Console.