Tutorial: Erstellen Sie ein Alexa Skill-Projekt in AWS CodeStar

AWS CodeStarist ein cloudbasierter EntwicklungsserviceAWS, der die Tools bereitstellt, die Sie für die schnelle Entwicklung, Erstellung und Bereitstellung von Anwendungen benötigen. AWS Mit AWS CodeStar können Sie Ihre gesamte Continuous Delivery-Toolchain in wenigen Minuten einrichten und Ihren Code so schneller veröffentlichen. Mit den Alexa-Skill-Projektvorlagen AWS CodeStar auf dieser Website können Sie mit nur wenigen Klicks einen einfachen Hello World Alexa-Skill von Ihrem AWS Konto aus erstellen. Die Vorlagen erstellen auch eine grundlegende Bereitstellungspipeline, die Sie mit einem Workflow zur kontinuierlichen Bereitstellung (Continuous Integration, CI) für die Skill-Entwicklung vertraut macht.

Die Hauptvorteile der Erstellung von Alexa-Skills AWS CodeStar bestehen darin, dass Sie mit der Entwicklung von Fähigkeiten beginnen AWS und Ihr Amazon-Entwicklerkonto mit dem Projekt verbinden können, um Fähigkeiten direkt von dort aus für die Entwicklungsphase bereitzustellenAWS. Sie erhalten auch eine einsatzbereite Deployment (CI)-Pipeline mit einem Repository mit dem gesamten Quellcode für das Projekt. Sie können dieses Repository mit Ihrer bevorzugten IDE konfigurieren, um Skills mit Tools zu erstellen, die Sie kennen.

Voraussetzungen

• Erstellen Sie ein Amazon-Entwicklerkonto, indem Sie auf https://developer.amazon.com gehen. Die Anmeldung ist kostenlos. Dieses Konto besitzt Ihre Alexa-Skills.

• Wenn Sie kein AWS-Konto haben, führen Sie die folgenden Schritte zum Erstellen eines Kontos durch.

  So melden Sie sich bei AWS an

  1. Öffnen Sie https://aws.amazon.com/ und wählen Sie dann AWSKonto erstellen.

     Anmerkung

     Wenn Sie sich zuvor mit Root-Benutzer des AWS-Kontos-Anmeldeinformationen an der AWS Management Console angemeldet haben, wählen Sie Sign in to a different account (Mit einem anderen Konto anmelden). Wenn Sie sich zuvor mit IAM-Anmeldeinformationen bei der Konsole angemeldet haben, wählen Sie Mit Root-Benutzer des AWS-Kontos Anmeldeinformationen anmelden aus. Wählen Sie dann Neues AWS Konto erstellen aus.

  2. Folgen Sie den Online-Anweisungen.

Wichtig

Nachdem Sie das Alexa Skill-Projekt erstellt haben, nehmen Sie alle Änderungen nur noch im Projekt-Repository vor. Wir empfehlen, dieses Skill nicht direkt mit anderen Alexa Skills Kit-Tools wie der ASK CLI- oder ASK-Entwicklerkonsole zu bearbeiten. Diese Tools werden nicht in das Projekt-Repository integriert. Wenn Sie sie verwenden, hat dies zur Folge, dass der Skill und der Repository-Code nicht mehr synchron sind.

Schritt 1: Erstellen des Projekts und Verbinden Ihres Amazon-Entwicklerkontos

In diesem Tutorial erstellen Sie einen Skill mit Node.js, das auf AWS Lambda läuft. Die meisten Schritte sind für andere Sprachen gleich, obwohl der Name des Skills unterschiedlich ist. In der Datei README.md im Projektarchiv finden Sie Details zu der von Ihnen gewählten Projektvorlage.

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie dann die AWS CodeStar Konsole unter https://console.aws.amazon.com/codestar/.

2. Wählen Sie die AWS-Region, in der Sie das Projekt und seine Ressourcen erstellen möchten. Die Alexa Skill Runtime ist in den folgenden AWS Regionen verfügbar:

   • Asien-Pazifik (Tokio)

   • EU (Irland)

   • USA Ost (Nord-Virginia)

   • USA West (Oregon)

3. Wählen Sie Create project (Projekt erstellen) aus.

4. Auf der Seite Choose a project template (Auswählen einer Projektvorlage):

   1. Wählen Sie als Anwendungstyp Alexa Skill aus.

   2. Wählen Sie als Programmiersprache Node.js aus.

5. Wählen Sie das Feld mit den von Ihnen gewählten Optionen.

6. Geben Sie für Project name (Projektname) einen Namen für Ihr Projekt ein (z. B.: My Alexa Skill). Wenn Sie einen anderen Namen verwenden, achten Sie darauf, ihn in diesem Tutorial zu verwenden. AWS CodeStarwählt für die Projekt-ID eine zugehörige Kennung für dieses Projekt aus (z. B. my-alexa-skill). Wenn Sie eine andere Projekt-ID sehen, müssen Sie diese im gesamten Tutorial verwenden.

7. Wählen Sie in diesem Tutorial AWS als Repository aus und ändern Sie den Wert CodeCommit für den Repository-Namen nicht.

8. Wählen Sie Connect Amazon developer account (Amazon-Entwicklerkonto verbinden) aus, um auf Ihr Amazon-Entwicklerkonto für das Hosting des Skills zu verlinken. Wenn Sie kein Amazon-Entwicklerkonto haben, erstellen Sie ein Konto und schließen Sie die Registrierung zunächst bei Amazon Developers ab.

9. Melden Sie sich mit Ihren Amazon-Entwickleranmeldeinformationen an. Wählen Sie Zulassen und dann Bestätigen, um die Verbindung herzustellen.

10. Wenn Sie mehrere Anbieter-IDs mit Ihrem Amazon-Entwicklerkonto verknüpft haben, wählen Sie diejenige aus, die Sie für dieses Projekt verwenden möchten. Stellen Sie sicher, dass Sie ein Konto mit der zugewiesenen Rolle Administrator oder Entwickler verwenden.

11. Wählen Sie Weiter aus.

12. (Optional) Wenn Sie es zum ersten Mal AWS CodeStar in dieser AWS Region verwenden, geben Sie den Anzeigenamen und die E-Mail-Adresse ein, die Sie für Ihren IAM-Benutzer verwenden AWS CodeStar möchten. Wählen Sie Weiter aus.

13. Warten Sie, bis AWS CodeStar das Projekt erstellt hat. Dies kann einige Minuten dauern. Fahren Sie erst fort, wenn Sie das Banner „Project provisioned“ sehen.

Schritt 2: Testen des Skills im Alexa Simulator

Im ersten Schritt hat AWS CodeStar einen Skill für Sie erstellt und in der Alexa Skill-Entwicklungsphase bereitgestellt. Als Nächstes testen Sie das Skill im Alexa-Simulator.

1. Wählen Sie in Ihrem Projekt in der AWS CodeStar Konsole die Option Anwendung anzeigen aus. Eine neue Registerkarte öffnet sich mit dem Alexa Simulator.

2. Melden Sie sich mit Ihren Amazon-Entwickleranmeldeinformationen für das Konto an, das Sie in Schritt 1 mit Ihrem Projekt verbunden haben.

3. Wählen Sie bei Test Development (Entwicklung) aus, um die Testfunktion zu aktivieren.

4. Geben Sie ask hello node hello ein. Der Standardname für den Aufruf Ihres Skills lautet hello node.

5. Ihr Skill sollte mit Hello World! antworten.

Wenn der Skill im Alexa-Simulator aktiviert ist, können Sie ihn auch auf einem Alexa-fähigen Gerät aufrufen, das in Ihrem Amazon-Entwicklerkonto registriert ist. Um Ihren Skill auf einem Gerät zu testen, sagen Sie Alexa, sage Hello Node, sage Hallo.

Weitere Informationen über den Alexa-Simulator finden Sie unter Testen Ihrer Skills in der Entwicklerkonsole.

Schritt 3: Entdecken der Projekt-Ressourcen

Im Rahmen der Projekterstellung wurden AWS CodeStar auch AWS Ressourcen in Ihrem Namen erstellt. Zu diesen Ressourcen gehören ein Projekt-Repository CodeCommit, das eine Bereitstellungspipeline verwendet, CodePipeline und eine AWS Lambda Funktion. Sie können über die Navigationsleiste auf diese Ressourcen zugreifen. Wenn Sie beispielsweise Repository auswählen, werden Details zum CodeCommit Repository angezeigt. Sie können den Status der Pipeline-Bereitstellung auf der Seite Pipeline einsehen. Sie können eine vollständige Liste der AWS Ressourcen anzeigen, die im Rahmen Ihres Projekts erstellt wurden, indem Sie in der Navigationsleiste „Übersicht“ wählen. Diese Liste enthält Links zu den einzelnen Ressourcen.

Schritt 4: Ändern der Antwort Ihres Skills

In diesem Schritt nehmen Sie eine kleine Änderung an der Reaktion Ihres Skills vor, um den Iterationszyklus zu verstehen.

1. Wählen Sie in der Navigationsleiste Repository aus. Wählen Sie den Link unter Repository-Name und das Repository Ihres Projekts wird in einem neuen Tab oder Fenster geöffnet. Dieses Repository enthält die Build-Spezifikation (buildspec.yml), den AWS CloudFormation-Anwendungsstapel (template.yml), die Readme-Datei und den Quellcode Ihres Skills im Skill-Paketformat (Projektstruktur).

2. Navigieren Sie zur Datei lambda > custom > index.js (bei Node.js). Diese Datei enthält den Code für die Bearbeitung Ihrer Anfrage, der das ASK SDK verwendet.

3. Wählen Sie Edit (Bearbeiten) aus.

4. Ersetzen Sie die Zeichenkette Hello World! in Zeile 24 durch die Zeichenkette Hello. How are you?.

5. Scrollen Sie nach unten zum Ende der Datei. Geben Sie Autorenname und E-Mail-Adresse und eine optionale Commit-Nachricht ein.

6. Wählen Sie Commit changes (Commit für Änderungen durchführen) aus, um die Änderungen in das Repository zu übertragen.

7. Kehren Sie zum Projekt in zurück AWS CodeStar und überprüfen Sie die Pipeline-Seite. Sie sollten nun sehen, wie die Pipeline bereitgestellt wird.

8. Wenn die Pipeline die Bereitstellung beendet hat, testen Sie Ihren Skill erneut im Alexa-Simulator. Ihr Skill sollte nun mit Hello. How are you? antworten.

Schritt 5: Einrichten der lokalen Arbeitsstation, um eine Verbindung zu Ihrem Projekt-Repository herzustellen

Zuvor haben Sie direkt von der CodeCommit Konsole aus eine kleine Änderung am Quellcode vorgenommen. In diesem Schritt konfigurieren Sie das Projekt-Repository mit Ihrer lokalen Arbeitsstation, sodass Sie Code von der Befehlszeile oder Ihrer bevorzugten IDE aus bearbeiten und verwalten können. In den folgenden Schritten wird erläutert, wie Sie Befehlszeilen-Tools einrichten.

1. Navigieren Sie bei Bedarf zum Projekt-Dashboard in AWS CodeStar.

2. Wählen Sie in der Navigationsleiste IDE aus.

3. Klicken Sie unter Zugriff auf Ihren Projektcode auf Anweisungen unter der Befehlszeilenschnittstelle.

4. Folgen Sie den Anweisungen, um die folgenden Aufgaben auszuführen:

   1. Installieren Sie Git auf Ihrem lokalen Arbeitsplatzrechner von einer Website wie z. B. Git Downloads.

   2. Installieren Sie die AWS-CLI. Informationen hierzu finden Sie unter Installieren der AWS-Befehlszeilenschnittstelle.

   3. Konfigurieren Sie die AWS CLI mit Ihrem IAM-Benutzerzugriffsschlüssel und Ihrem geheimen Schlüssel. Informationen finden Sie unter Konfiguration der AWS CLI.

   4. Klonen Sie das CodeCommit Projekt-Repository auf Ihre lokale Workstation. Weitere Informationen finden Sie unter Connect zu einem CodeCommit Repository herstellen.

Nächste Schritte

Dieses Tutorial zeigte Ihnen, wie Sie mit einem grundlegenden Skill beginnen können. Um Ihren Weg zur Entwicklung von Skills fortzusetzen, lesen Sie die folgenden Ressourcen.

• Erfahren Sie mehr über die Grundlagen eines Skills, indem Sie sich How Alexa Skills Work und andere Videos auf dem Alexa YouTube Developers-Kanal ansehen.

• Verstehen Sie die verschiedenen Komponenten Ihres Skills, indem Sie die Dokumentation für das Skill-Paketformat, die Skill-Manifestschemas und die Interaktionsmodell-Schemas lesen.

• Setzen Sie Ihre Idee für einen Skill um, indem Sie die Dokumentation für das Alexa Skills Kit und die ASK SDKs lesen.