Verbinden eines Bots mit AlexaConnect a bot to Alexa

gilt für: SDK v4APPLIES TO: SDK v4

Sie können Ihren Bot so konfigurieren, dass er mit Benutzern mit Alexa-Geräten kommuniziert, die benutzerdefinierte Skills unterstützen.You can configure your bot to communicate with people using Alexa devices that support Custom Skills.

Wichtig

Der bot muss das bot Framework SDK , Version 4,8 oder höher, verwenden.Your bot must use the Bot Framework SDK version 4.8 or later. Wenn Sie einen neuen bot über das Azure-Portal erstellen, verwendet der bot die aktuelle Version, die zu diesem Zeitpunkt verfügbar ist.When you create a new bot via the Azure Portal, the bot will use the latest version available at that time. Wenn Sie über einen vorhandenen bot verfügen, müssen Sie möglicherweise Ihre SDK-Version aktualisieren.If you have an existing bot you may need to update your SDK version.

Erstellen eines Alexa-SkillsCreate an Alexa skill

  1. Melden Sie sich bei der Alexa Developer Console an, und klicken Sie dann auf die Schaltfläche „Create Skill“ (Skill erstellen).Log into the Alexa Developer Console and then click the 'Create Skill' button.

  2. Geben Sie auf dem nächsten Bildschirm einen Namen für Ihren neuen Skill ein.On the next screen enter a name for your new skill. Auf dieser Seite können Sie ein Modell auswählen, das Sie Ihrem Skill hinzufügen möchten (standardmäßig ist benutzerdefiniert ausgewählt), sowie eine Methode zum Hosten der Back-End-Ressourcen Ihres Skills (standardmäßig ist Provision your own (Eigene bereitstellen) ausgewählt).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). Lassen Sie die Standardoptionen ausgewählt, und klicken Sie auf die Schaltfläche Create Skill (Fähigkeiten erstellen).Leave the default options selected and click the Create Skill button.

    Bildschirm Abbildung: Auswählen eines Modells und Hosting

  3. Auf dem nächsten Bildschirm werden Sie aufgefordert, eine Vorlage auszuwählen.On the next screen you will be asked to Choose a template. Von Grund auf neu starten ist standardmäßig ausgewählt.Start from scratch will be selected by default. Lassen Sie Von Grund auf neu starten ausgewählt, und klicken Sie auf die Schaltfläche Auswählen.Leave Start from scratch selected and click the Choose button.

    Bildschirm Abbildung: Auswählen einer Vorlage

  4. Nun wird Ihr Skill-Dashboard angezeigt.You will now be presented with your skill dashboard. Navigieren Sie im Abschnitt Interaction Model (Interaktionsmodell) im linken Menü zu JSON-Editor.Navigate to JSON Editor within the Interaction Model section of the left hand menu.

  5. Fügen Sie den folgenden JSON-Code in den JSON-Editor ein, und ersetzen Sie dabei die folgenden Werte:Paste the JSON below into the JSON Editor, replacing the following values;

    • YOUR SKILL INVOCATION NAME: Dies ist der Name, mit dem Benutzer Ihren Skill bei Alexa aufrufen.YOUR SKILL INVOCATION NAME - This is the name that users will use to invoke your skill on Alexa. Wenn beispielsweise der Aufrufname Ihres Skills „Adapterhelfer“ lautet, würde ein Benutzer sagen: „Alexa, starte den Adapterhelfer“, um den Skill zu starten.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: Sie sollten drei Beispielphasen bereitstellen, über die Benutzer mit Ihrem Skill interagieren.EXAMPLE PHRASES - You should provide 3 example phases that users could use to interact with your skill. Wenn ein Benutzer beispielsweise sagt: „Alexa, der Adapterhelfer soll mir Details zum Alexa-Adapter geben“, lautet der Beispielausdruck „Details zum Alexa-Adapter geben“.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. Klicken Sie auf die Schaltfläche Save Model (Modell speichern) und dann auf Build Model (Modell erstellen), um die Konfiguration für Ihren Skill zu aktualisieren.Click the Save Model button and then click Build Model, which will update the configuration for your skill.

  7. Holen Sie sich Ihre Alexa-Fähigkeits-ID entweder über die URL im Alexa-Portal, oder navigieren Sie zur Alexa-Entwickler Konsole , und klicken Sie auf " anzeigen".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. Ihre Alexa-Fähigkeits-ID sollte ein Wert wie "amzn1. Ask. Skills. a GUID" sein.Your Alexa Skill ID should be a value like 'amzn1.ask.skill.A GUID'.

  8. Navigieren Sie im Bot Framework-Portal zur Seite für die Konfiguration des Alexa-Kanals, und fügen Sie Ihre Alexa-Skill-ID in das Feld Enter skill Id (Skill-ID eingeben) ein.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. Navigieren Sie im Alexa-Portal im linken Menü zum Abschnitt Endpoint (Endpunkt).In the Alexa Portal navigate to the Endpoint section on the left hand menu. Wählen Sie als Service Endpoint Type (Dienstendpunkttyp) die Option HTTPS aus, und legen Sie den Endpunkt der Default Region (Standardregion) auf den Wert des Alexa Service Endpoint URI (Alexa-Dienstendpunkt-URI) fest, den Sie auf der Konfigurationsseite von Bot Framework für Alexa kopiert haben.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. Sie müssen im Dropdownmenü unterhalb des Textfelds, in dem Sie den Endpunkt definiert haben, den Typ des verwendeten Zertifikats auswählen.In the drop down underneath the text box where you have defined your endpoint, you need to select the type of certificate being used. Wählen Sie My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority (Mein Entwicklungsendpunkt ist eine Unterdomäne einer Domäne mit einem Platzhalterzertifikat von einer Zertifizierungsstelle) aus.Choose My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority.

    Bildschirm Abbildung: Auswählen des Dienst Endpunkt Typs

  11. Klicken Sie im Alexa-Portal auf die Schaltfläche Save Endpoints (Endpunkte speichern).Click the Save Endpoints button in the Alexa Portal.

  12. Klicken Sie auf der Konfigurationsseite von Bot Framework für den Alexa-Kanal auf die Schaltfläche Speichern.Click the Save button in the Bot Framework Alexa Channel Configuration page.

Sie müssen Ihren Skill in Alexa veröffentlichen, damit andere Benutzer damit kommunizieren können.You will need to publish your Skill within Alexa before users other than yourself can communicate with it. Sie können Ihren Skill vor der Veröffentlichung in Alexa testen, indem Sie ein eigenes Alexa-Gerät oder die Registerkarte Test Ihres Skills verwenden.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. Um die Registerkarte Test anzuzeigen, navigieren Sie in der Alexa Developer Console zu Ihrem Skill.To get to the Test tab navigate to your Skill from the Alexa Developer Console.