Delen via

Verbinding maken een bot naar Alexa

  • Artikel

VAN TOEPASSING OP: SDK v4

U kunt uw bot configureren om te communiceren met mensen via een aangepaste Alexa-vaardigheid. In dit artikel wordt beschreven hoe u een Alexa-vaardigheid maakt met behulp van de Alexa Developer Console, uw bot verbindt met uw Alexa-vaardigheid in Azure en uw bot test in Alexa.

Vereisten

  • Een Azure-abonnement. Als u nog geen account hebt, maakt u een gratis account voordat u begint.
  • Een bot gepubliceerd naar Azure die u wilt verbinden met Alexa.
  • Een Amazon-account.

Belangrijk

Uw bot moet de Bot Framework SDK versie 4.8 of hoger gebruiken. Als u een bestaande bot hebt, moet u mogelijk uw SDK-versie bijwerken en uw bot opnieuw publiceren.

Een Alexa-vaardigheid maken

  1. Meld u aan bij de Alexa Developer Console en selecteer Vaardigheid maken.

  2. Op de volgende pagina:

    1. Voer een naam in voor uw nieuwe vaardigheid.
    2. Zorg ervoor dat Een model kiezen dat u aan uw vaardigheid wilt toevoegen, is ingesteld op Aangepast.
    3. Zorg ervoor dat Kies een methode voor het hosten van de back-endbronnen van uw vaardigheid is ingesteld op Uw eigen inrichten.
    4. Selecteer Vaardigheid maken.

    Choose model and hosting

  3. Op de volgende pagina:

    1. Zorg ervoor dat Een sjabloon kiezen is ingesteld op Helemaal opnieuw starten
    2. Selecteer Kiezen.

    Choose a template

  4. Selecteer JSON-editor op uw vaardigheidsdashboard onder Interactiemodel.

  5. In de JSON-editor:

    1. Vervang de bestaande inhoud door de volgende JSON.

      {
    "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>"
                            }
                        }
                    ]
                }
            ]
        }
    }
}

    2. Voor invocationName, wijzig <je-skill-invocation-name> in de naam die gebruikers zullen gebruiken om je vaardigheid op Alexa aan te roepen. Als de naam van je vaardigheidsaanroep bijvoorbeeld 'adapter helper' was, kan een gebruiker 'Alexa, launch adapter helper' zeggen om de vaardigheid te starten.

    3. Vervang in de matrix onder types, values de drie exemplaren van <example-phrase> door zinnen die gebruikers kunnen zeggen om uw vaardigheid te activeren. Als een gebruiker bijvoorbeeld "Alexa, vraag adapter helper om me details van de Alexa-adapter te geven", kan een voorbeeldzin zijn "geef me details van de Alexa-adapter".

  6. Selecteer Model opslaan en selecteer Vervolgens Build Model. Hiermee wordt de configuratie van je vaardigheid op Alexa bijgewerkt.

Uw bot configureren in Azure

Om deze stap te voltooien, hebt u uw Alexa Skill ID nodig. Haal de id op uit de URL in de Alexa-portal of ga naar de Alexa Developer Console en selecteer Id van kopieervaardigheid. Je Alexa Skill ID moet een waarde zijn zoals "amzn1.ask.skill.<some-guid>".

  1. Open de Azure Portal.
  2. Open de azure-botresourceblade voor uw bot.
  3. Open Kanalen en selecteer Alexa.
  4. Voer in Alexa Channel Configuration de informatie in die u in de vorige stap hebt gekopieerd.
    1. Voer in Enter skill Id de Alexa-vaardigheids-id in die u hebt gekopieerd uit de Alexa Developer Console.
    2. Selecteer Toepassen.
    3. Kopieer de door Azure gegenereerde Alexa-service-eindpunt-URI.

Uw Alexa-botregistratie bijwerken

  1. Meld u aan bij de Alexa Developer Console.

  2. Zoek en open de configuratiepagina van uw vaardigheid.

  3. Selecteer Eindpunt.

  4. Selecteer HTTPS voor service-eindpunttype.

  5. Voor standaardregio:

    1. Voer de URI van het Alexa-service-eindpunt in die u hebt gekopieerd uit Azure Portal.
    2. Selecteer Mijn ontwikkelingseindpunt in de vervolgkeuzelijst een subdomein van een domein met een jokertekencertificaat van een certificeringsinstantie.

    Set service endpoint and endpoint type

  6. Selecteer Eindpunten opslaan.

Uw vaardigheid testen en publiceren

Als je eigenaar bent van een Alexa-apparaat, kun je je vaardigheid testen voordat je het publiceert.

Zie de ontwikkelaarsdocumentatie van Alexa Skills Kit voor vaardigheden voor aangepaste spraakmodellen voor informatie over het testen en publiceren van uw vaardigheid op hun platform.

Aanvullende informatie

Zie de Documentatie voor Amazon-ontwikkelaars voor meer informatie over Alexa-vaardigheden:

Gebruikersverificatie in Alexa

Gebruikersverificatie in Alexa wordt gedaan door Account Linking in te stellen en te gebruiken op de Alexa-vaardigheid. Zie Understand Account Linking for Alexa Skills voor meer informatie. U kunt accountkoppeling vereisen wanneer de gebruiker de vaardigheid inschakelt of u kunt dit vereisen als onderdeel van een gespreksstroom.

Als u gebruikersverificatie toevoegt als onderdeel van het gesprek:

  1. Voeg een aanmeldingskaart toe aan de uitgaande activiteit. Dit wordt geconverteerd naar een Alexa LinkAccount-kaart die de gebruiker vraagt zich aan te melden met behulp van de Alexa-app.

  2. Als de gebruiker zijn of haar account aan de app koppelt, is er een token beschikbaar voor volgende aanvragen in de kanaalgegevens.

Volgende stappen