1. はじめに
参考文献
今回のAlexaスキル開発チュートリアルは、以下のサイトを参考に、2018年3月時点の開発環境（Alexa Skills Kit SDK for Node.js(V6.10) Version 1）にまとめ直したものとなります。
Note
- 2018年10月16日現在、Alexa Blog（公式）に「Alexaスキル開発トレーニングシリーズ 第1回 初めてのスキル開発」が更新され、Alexa Skills Kit SDK for Node.js(V8.10) Version 2 として掲載されております。こちらも、あわせてご参照ください。
このスライドを見てできること
- Amazon開発者コンソールが理解できる。
- AWS Lambdaが理解できる。
- Alexaスキルのテストができるようになる。
- Alexaスキルが作成できるようになる。
今回作成するAlexaスキル
- スキル名：とっさの豆知識
トークシナリオ
ユーザー：「アレクサ、<とっさの豆知識>を開いて。」
アレクサ：「知ってましたか？
水星の一年はたった88日です。 」
2. 事前準備・開発環境
事前準備
- Amazon Developerアカウントの用意
- AWSアカウントの用意
- IAMロールの用意（Setting Up Your First Lambda Role を参照）
- ZIPファイルの入手（https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/fact/lambda.zip ）
必要なソフトウェア
- ブラウザ：Firefox（推奨）
- エディタ：Visual Studio Code（推奨）
必要な開発環境
- マイク＆スピーカが利用できるパソコン
- インターネット（Wi-Fi）
3. アカウントの用意
Amazon Developerアカウントの用意
- Amazon Developer Portal ログイン用の、アカウントを用意する必要があります。
- アカウントをお持ちでない方は、こちらのページ（失敗しないAlexa開発者アカウントの作り方）の手順を参考に、作成してください。
- Amazon.co.jpアカウントの使用をおすすめします。
AWSアカウントの用意
- https://aws.amazon.com/jp/register-flow/ にて、アカウントを作成する必要があります。
- アカウントをお持ちでない方は、こちらのページ（AWS アカウント作成の流れ）の手順を参考に、作成してください。
4. Alexaスキルの作成
Amazon開発者コンソール
- 「Amazon開発者コンソール」を開く。
- 「Developer Console」をクリックする。
Amazon開発者コンソール
- 「ログイン」する。
Amazon開発者コンソール
- 「ALEXA」をクリックする。
Amazon開発者コンソール
- 「Alexa Skills Kit」の「始める」ボタンをクリックする。
Amazon開発者コンソール
- 「スキルの作成（Create Skill）」ボタンをクリックする。
Amazon開発者コンソール
- 「スキル名（SkillName）」を入力する。
- 言語を「日本語（Japanese）」に変更する。
- 「次へ（Next）」ボタンをクリックする。
Amazon開発者コンソール
- 「カスタム（Custom）」スキルを選択する。
- 「スキル作成（Create Skill）」ボタンをクリックする。
Amazon開発者コンソール
- 「1. 呼び出し名（Invocation Name）」をクリックする。
Amazon開発者コンソール
- 「スキル呼び出し名（Skill Invocation Name）」を入力する。
- 「モデルを保存（Save Model）」ボタンをクリックする。
- 「ビルド（Build）」をクリックして戻る。
Amazon開発者コンソール
- 「2. インテント、サンプル、スロット（Intents, Samples, and Slot）」をクリックする。
Amazon開発者コンソール
- 「インテント名（GetNewFactIntent）」を入力する。
- 「カスタムインテントを作成（Creatte Custom Intent）」ボタンをクリックする。
Amazon開発者コンソール
- 「サンプル発話『豆知識を教えて』」を入力する。
- 「モデルを保存（Save Model）」ボタンをクリックする。
- 「ビルド（Build）」をクリックして戻る。
Amazon開発者コンソール
- 「3. モデルをビルド（Build Model）」をクリックする。
Amazon開発者コンソール
- 「ビルドの成功」を確認する。
5. Lambda関数の作成
AWS Lambda
- 「AWS」（https://console.aws.amazon.com/ ）サインイン画面を開く。
- 「12桁のアカウントID」または「Eメールアドレス」を入力する。
- 「次へ」ボタンをクリックする。
AWS Lambda
- 必須項目を入力する。
- 「サインイン」ボタンをクリックする。
AWS Lambda
- 「Lambda」を検索し、クリックする。
AWS Lambda
- リージョンが「東京」であることを確認する。
AWS Lambda
- 「関数の作成」ボタンをクリックする。
AWS Lambda
- 「設計図」を選択する。
- 検索キーワードに「alexa」を入力し、Enterキーを押下する。
AWS Lambda
- 「alexa-skill-sdk-facttskill」を選択する。
- 「設定」ボタンをクリックする。
AWS Lambda
- 「関数の名前（FactSkill）」を入力する。
- 「ロール」を設定する。
IAMロールが未設定の場合
- Lambda関数用のIAMロールが未設定の場合は、初めてLambda用ロールを作成する場合の手順を参考に作成してください。
- IAMロールには、Lambda と CloudWatch の権限を付与してください。
AWS Lambda
- 「関数の作成」ボタンをクリックする。
AWS Lambda
- トリガーの追加から「Alexa skills Kit」をクリックする。
AWS Lambda
- トリガーに「Alexa skills Kit」が設定されたことを確認する。
Amazon開発者コンソール
- 「あなたのAlexaコンソール」から、「スキル（新しいコンソール）」を選択する。
Amazon開発者コンソール
- 「View Skill ID」をクリックし、「Skill ID」をコピーする。
AWS Lambda
- スキルのID検証に、Amazon開発者コンソールでコピーした「Skill ID(アプリケーションID）」をペーストする。
- 「追加」ボタンをクリックする。
AWS Lambda
- 「保存」ボタンをクリックする。
日本語版 ZIPファイル
- ZIPファイル（https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/fact/lambda.zip ）を入手する。（ファイルサイズ：5.6MB）
- このZIPファイルは、「alexa-skill-sdk-facttskill」の日本語版となります。
日本語版 ZIPファイル
- ZIPファイルを解凍する。（所要時間：1分）
Visual Studio Code
- 解凍したファイルから index.js ファイルを開く。
- 推奨ソフト：Visual Studio Code
Visual Studio Code
- ソースの10行目の APP_ID を、作成したAlexaスキルの「アプリケーションID（Skill ID）」に書き替える。
index.js
var APP_ID = "amzn1.ask.skill.XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
- 保存してから、全選択コピーをする。
AWS Lambda
- 「プログラム（FactSkill）」を選択する。
AWS Lambda
- 画面中央のインラインエディアの「index.js」ファイルを全選択し、先ほどコピーしたローカルのindex.jsファイルの内容を、ペーストする。（日本語版に上書きする。）
AWS Lambda
- Lambdaプログラムが日本語版に上書きされたことを確認し、「保存」ボタンをクリックする。
AWS Lambda
- 画面最上部までスクロールし、ARN を選択し、コピーする。
6. Alexaスキルの仕上げ
Amazon開発者コンソール
- 作成したAlexaスキルの「編集（Edit）」ボタンをクリックする。
Amazon開発者コンソール
- 「4. エンドポイント（Endpoint）」をクリックする。
Amazon開発者コンソール
- 「AWS LambdaのARN」を選択する。
- 「デフォルトの地域（Default Region）」にARNをペーストする。
- 「エンドポイントの保存（Save Endpoints）」をクリックする。
Amazon開発者コンソール
- 「ビルド（Build）」をクリックし、最初の画面に戻り、4つ全て「オールグリーン」であることを確認する。
7. テスト
テストシミュレータ
- 「テスト（Test）」をクリックする。
テストシミュレータ
- マイク利用を「許可する」。
テストシミュレータ
- テストを「有効（enabled）」にする。
テストシミュレータ
- マイクアイコンを押下したまま、「とっさの豆知識を開いて」と話す。
テストシミュレータ
- Alexaスキルが正常に動作したことを確認する。
8. おわりに
おわりに
いかがでしたでしょうか？
うまくAlexaスキルは、動きましたか？
今回作成した FactSkill は、
Alexaスキルの基礎となります。
これを元に、いろいろ作り変えて、
新しい Alexaスキル 作ってみましょう！！
付録1. ソース解説
ソース解説：メイン処理部
index.js
// プログラムの開始位置
exports.handler = function(event, context, callback) {
// alexa-sdkの利用宣言
var alexa = Alexa.handler(event, context);
// アプリケーションIDの設定
alexa.APP_ID = APP_ID;
// ハンドラ部へジャンプ（状態遷移分岐）
alexa.registerHandlers(handlers);
// Alexa応答（プログラムの終了位置）
alexa.execute();
};
ソース解説：ハンドラ部
index.js
// ハンドラ部
var handlers = {
// ユーザ発話「アレクサ、スキル呼び出し名 を開いて。」
'LaunchRequest': function () {
// 'GetNewFactIntent'へジャンプ
this.emit('GetNewFactIntent');
},
// ユーザ発話「何か教えて。」
'GetNewFactIntent': function () {
// 変数宣言（ランダムに豆知識を1つ決定）
var factArr = data;
var factIndex = Math.floor(Math.random() * factArr.length);
var randomFact = factArr[factIndex];
// スピーチアウトプットの設定（Alexa応答設定）
var speechOutput = GET_FACT_MESSAGE + randomFact;
// tellWithCard（カード付きAlexa応答＆終了）
this.emit(':tellWithCard', speechOutput, SKILL_NAME, randomFact);
},
// ユーザ発話「ヘルプ。」
'AMAZON.HelpIntent': function () {
// スピーチアウトプットの設定（Alexa応答設定）
var speechOutput = HELP_MESSAGE;
// リプロンプトの設定（聞き直し設定）
var reprompt = HELP_REPROMPT;
// ask（Alexa応答＋たずねる）
this.emit(':ask', speechOutput, reprompt);
},
// ユーザ発話「キャンセル。」
'AMAZON.CancelIntent': function () {
// tell（Alexa応答＆終了）
this.emit(':tell', STOP_MESSAGE);
},
// ユーザ発話「止めて。」
'AMAZON.StopIntent': function () {
// tell（Alexa応答＆終了）
this.emit(':tell', STOP_MESSAGE);
}
};
ソース解説：メッセージ定義部
index.js
// メッセージ定義
var GET_FACT_MESSAGE = "知ってましたか？";
var HELP_MESSAGE = "豆知識を聞きたい時は「豆知識」と、終わりたい時は「おしまい」と言ってください。どうしますか？";
var HELP_REPROMPT = "どうしますか？";
var STOP_MESSAGE = "さようなら";
ソース解説：豆知識の定義部
index.js
// 豆知識の定義
var data = [
"水星の一年はたった88日です。",
"金星は水星と比べて太陽より遠くにありますが、気温は水星よりも高いです。",
"金星は反時計回りに自転しています。過去に起こった隕石の衝突が原因と言われています。",
"火星上から見ると、太陽の大きさは地球から見た場合の約半分に見えます。",
"木星の<sub alias='いちにち'>1日</sub>は全惑星の中で一番短いです。",
"天の川銀河は約50億年後にアンドロメダ星雲と衝突します。",
"太陽の質量は全太陽系の質量の99.86%を占めます。",
"太陽はほぼ完璧な円形です。",
"皆既日食は一年から二年に一度しか発生しない珍しい出来事です。",
"土星は自身が太陽から受けるエネルギーの2.5倍のエネルギーを宇宙に放出しています。",
"太陽の内部温度は摂氏1500万度にも達します。",
"月は毎年3.8cm地球から離れていっています。"
];
ソース解説：プログラム定義部
index.js
// 厳格モードの設定
'use strict';
// alexa-sdkモジュールを利用
var Alexa = require('alexa-sdk');
// アプリケーションIDの設定
var APP_ID = "amzn1.ask.skill.XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
// スキル名の設定
var SKILL_NAME = "豆知識";
付録2. 会話を続ける ask化
トークシナリオ：会話を続ける
- 会話が続くようにする。
トークシナリオ
ユーザー：「アレクサ、<とっさの豆知識>を開いて。」
アレクサ：「知ってましたか？水星の一年はたった88日です。
どうしますか？」
ユーザー：「何か教えて。」
アレクサ：「知ってましたか？太陽はほぼ完璧な円形です。
どうしますか？」
ユーザー：「止めて。」
アレクサ：「さようなら。」
ソース改良：会話を続ける ask化
- 'GetNewFactIntent'の中の tellWithCard を、 ask に書き替える。
index.js
// スピーチアウトプットの設定（Alexa応答設定）
var speechOutput = GET_FACT_MESSAGE + randomFact + HELP_REPROMPT;
// リプロンプトの設定（聞き直し設定）
var reprompt = HELP_REPROMPT;
// ask（Alexa応答＋たずねる）
this.emit(':ask', speechOutput, reprompt);
付録3. スキル名の変更
スキル名の変更
- スキル名の名称を変える。
index.js
// スキル名の設定
var SKILL_NAME = "とっさの豆知識";
付録4. スキル申請時の指摘にそなえる
予期せぬ終了に対するそなえ
- 'SessionEndedRequest'の処理を追記する。
index.js
// ユーザ発話「止めて。」
'AMAZON.StopIntent': function () {
this.emit(':tell', STOP_MESSAGE);
},
// 予期せぬ終了
'SessionEndedRequest': function () {
// 処理は書かなくてもOKらしいが、書いておく。
this.emit(':tell', STOP_MESSAGE);
}
予期せぬ発話に対するそなえ
- 'Unhandled'の処理を追記する。
- 今回は状態遷移（state）をしていないので、効力は発揮されないが、状態遷移（state）する時は必須処理となる。
index.js
// 予期せぬ終了
'SessionEndedRequest': function () {
// 処理は書かなくてもOKらしいが、書いておく。
this.emit(':tell', STOP_MESSAGE);
},
// 予期せぬ発話
'Unhandled': function () {
// スピーチアウトプットの設定（Alexa応答設定）
var speechOutput = HELP_MESSAGE;
// リプロンプトの設定（聞き直し設定）
var reprompt = HELP_REPROMPT;
// ask（Alexa応答＋たずねる）
this.emit(':ask', speechOutput, reprompt);
}
付録5. Alexa居酒屋っぽくする
カスタムスロットの追加
- 「スロット値」の「追加」をクリックする。
カスタムタイプ名前の設定
- スロットタイプの名前に「LIST_OF_DRINK」と入力し、「カスタムスロットタイプを作成」クリックする。
スロット値の登録
- スロット値に「アイスコーヒー（お好きな飲み物）」と入力し、「＋」印をクリックする。（たくさん登録しましょう。）
カスタムスロットの保存
- 「モデルを保存」ボタンをクリックする。
カスタムインテントの追加
- 「インテント」の「追加」をクリックする。
カスタムインテントの名前設定
- カスタムインテントの名前に「OrderIntent」と入力し、「カスタムインテントを作成」クリックする。
サンプル発話の登録
- サンプル発話に「{drink} を {number} ください」と入力し、「＋」印をクリックする。（フレーズ例をたくさん登録しましょう。）
スロットタイプの設定
- 「drink」スロットのスロットタイプに「LIST_OF_DRINK」を選択する。
- 「number」スロットのスロットタイプに「AMAZON.NUMBER」を選択する。
モデルの保存とビルド
- 「モデルを保存」ボタンをクリック後、「モデルをビルド」ボタンをクリックする。
参照ライブラリを増やす
- 'const util = require('util');'の処理を追記する。
index.js
// 厳格モードの設定
'use strict';
// ライブラリの参照
var Alexa = require('alexa-sdk');
const util = require('util');
メッセージ定義を修正＆増やす
- 'HELP_REPROMPT 'の文言を修正する。
- 'ORDER_DRINK 'の文言を追記する。
index.js
let HELP_REPROMPT = "お飲み物でもいかがですか？";
var STOP_MESSAGE = "さようなら";
let ORDER_DRINK = "%sを、%s杯ですね？ご注文をお受けいたしました。またのご利用、お待ちしております。";
OrderIntentの処理を追加する
- 'AMAZON.HelpIntent'の処理の前あたりに、'OrderIntent'の処理を追記する。
- コピー＆ペーストしてもらえればOKです。
- かならず、保存をクリックしましょう。
index.js
// ユーザ発話「{drink} を {number} ください。」
'OrderIntent': function () {
// スロット格納用変数
let drink = undefined;
let number = undefined;
// スロット値の取得
if ('drink' in this.event.request.intent.slots) {
drink = this.event.request.intent.slots.drink.value;
}
if ('number' in this.event.request.intent.slots) {
number = this.event.request.intent.slots.number.value;
}
// // セッション情報の保存
this.attributes['drink'] = drink;
this.attributes['number'] = number;
// スピーチアウトプットの設定（Alexa応答設定）
let speechOutput = util.format(ORDER_DRINK, drink, number);
// tell（Alexa応答＆終了）
this.emit(':tell', speechOutput);
},
Alexa居酒屋のプレオープンテスト
- お好きな飲み物を注文してみる。
付録6. スキル申請時の必須項目の登録
スキル申請時の必須項目の登録
Japanese Store Preview の設定。
- Amazon開発者コンソールの「Launch」をクリックする。
- 「Public Name」に、スキル名を設定する。
- 「One Sentence Description」に、短いスキル説明文を設定する。
- 「Detailed Description」に、長いスキル説明文を設定する。
- 「Example Phrases」に、スキル起動フレーズを設定する。（例：「アレクサ、とっさの豆知識を開いて」）
- 「Small Skill Icon」に、小さいアイコン（108x108 .jpg or .png）を設定する。
- 「Large Skill Icon」に、大きいアイコン（512x512 .jpg or .png）を設定する。
- 「Category」を設定する。
- 「Keywords」に、検索キーワードを設定する。
- 「Save and continue」ボタンをクリックする。
スキル申請時の必須項目の登録
Privacy & Compliance の設定。
- Amazon開発者コンソールの「Launch」をクリックする。
- 「Privacy & Compliance」をクリックする。
- 英語質問を和訳し、「Yes ／ No」に回答する。
- 「Export Compliance」を和訳し、必要に応じてチェックする。
- 「Testing Instructions」に、スキル申請をしてくださるアマゾンテスター向けコメントを明記する。
- 「Save and continue」ボタンをクリックする。
スキル申請時の必須項目の登録
Privacy & Compliance の設定。
- Amazon開発者コンソールの「Launch」をクリックする。
- 「Availability」をクリックする。
- 「Public」をチェックする。
- 「Selected countries and regions」をチェックし、「Japan」のみチェックする。
- 「Save and continue」ボタンをクリックする。
付録7. Alexa公式ドキュメント
Alexa公式ドキュメントの情報源
※画面下の「Language」を「English（英語）」に切り替えることで、日本未公開の絶対領域を参照できます。
付録8. alexa-sdkを極める
alexa-sdkの情報源
slotの値取得、stateによる状態遷移やcard表示の方法などが、学べます。
- 参考：本家alexa/alexa-skills-kit-sdk-for-nodejs
- 参考：和訳Alexa Skills Kit SDK for Node.js
- 参考：Alexa Skills Kit for Node.js はじめの一歩
- 参考：Alexa Skills Kit SDK for Node.js ざっくり訳
付録9. サンプルソースたち
サンプルソースの情報源
個人的には、alexa-cookbook が最強だと思ってます。
付録10. ダイアログモデルを極める
ダイアログモデルの情報源
slotの値取得制御の一部分を、Alexaスキル側（Amazon Developer Portal）で済ませる新技。
付録11. VUIのしんずいを極める
VUIの情報源
付録12. 奥義、Amazonに聞く
Amazonフォーラム
Amazonお問い合わせ
おわりに
2018/03/10 TAKAHIRO NISHIZONO