この記事で書いてあること

先日CEKの一般公開を期に、CEK + Lambda + API Gatewayを実践してみました。
この記事を一通りやると、簡単なClovaスキルが作成できるようになります。

No	タイトル
1	[入門]Clovaスキル(CEK)は作りながら覚えて行く（前提知識編）
2	[入門]Clovaスキル(CEK)は作りながら覚えて行く（インテント、スロットなど登録編）
3	[入門]Clovaスキル(CEK)は作りながら覚えて行く（Lambda使ってコード実装変）<<今ここ
4	[入門]Clovaスキル(CEK)は作りながら覚えて行く（signature検証編）
番外編	公式SDKを使ってLambdaで開発した記事を書いてみました

Clova専用のSDKを作ったので、それを元にエンドポイント（今回はLambdaを使用）の実装について説明していく。
インテントやスロットはすでにCEKで定義している前提。

公式SDKを使ったLambdaでの開発方法も書きました。
Clovaの公式SDKがLambdaで使えるようになっていたので試してみた。

注意

今回は簡単化のために「RSA公開鍵を用いてリクエストメッセージを検証する」をしていません。
しなくても、動作はするのですがLINEさん公式では署名を検証することを推薦しています。
なので、この記事を拡張して一般公開用のスキルを作成する場合は検証機能を追加することをお勧めします。
詳しくはこちら
(次回の記事で自分の方でも検証のやり方の記事を書こうかなと思います。)
書きました。
[入門]Clovaスキル(CEK)は作りながら覚えて行く（signature検証編）

また、今回使用しているSDKはあくまで個人で開発したものであり、出来て間もないためバグなどがある可能性があります。ご了承ください。今後も修正を重ねて行く予定です。
なお、ask-sdkに似た様な書き方でかける様にしているのでおなじみの方にはやりやすいかと思います。

環境

npm入ってる >> (npmなにそれ、って人向けにzipファイル用意しましたので必須ではないです。)
node.js(8.10以上) >> (node.jsなにそれ、って人向けにzipファイル用意しましたので必須ではないです。)
AWSのアカウント持ってる >> これは必須です。

まずは、簡単にスキルの説明

今回は、星座で占いをしてくれる「ほげほげ占い」を作っていく。

会話例

ユーザー: 「Clova、ほげほげ占いを開いて」
Clova: 「あなたの星座を教えてください」
ユーザー: 「私の星座は魚座です。」
Clova: 「魚座ですね。魚座の今日の運勢は○○です。」（スキル終了）

Slots

スロット名: constellation

値:

ふたご座
蟹座
魚座
乙女座
etc

インテント

インテント名: DivinationIntent

発話例:

私の星座は魚座です
私の星座は蟹座だ
私の星座はふたご座よ

開発の流れ

ローカル（自分のパソコン)にてNode.jsでコードを書いちゃう。
Lambdaにzipファイルとしてアップロードする。
Lambdaのテスト画面で試してみる。
実機で試してみる。

ローカルでの開発

npmまたはNode.jsなんて知らないよ、という方にZIPファイル用意しました。ここからダウンロードしてください。
そして、「AWSのコンソール画面で」まですっ飛ばして大丈夫です。

初期設定

ディレクトリ作成

$ mkdir fortune-func
$ cd fortune-func
$ npm init #なんか色々聞かれるが全部エンター押していく

インストール

$ npm install --save love-clova

ファイル作成

$ vi index.js

好きなエディタをご利用ください。

コードのコピペ

index.jsに以下のコードをコピペする。
とりあえずの自作SDKなのでご了承を。

var clova = require("love-clova");

const LaunchRequestHandler = {
  canHandle: function(handlerInput){
    return handlerInput.requestEnvelope.isMatch('LaunchRequest');
  },
  handle: function(handlerInput){
    var msg = "あなたの星座を教えてください";
    return handlerInput.responseBuilder.speak(msg).reprompt(msg).getResponse();
  }
}

const SessionEndedRequestHandler = {
  canHandle: function(handlerInput){
    return handlerInput.requestEnvelope.isMatch('SessionEndedRequest');
  },
  handle: function(handlerInput){
    var msg = "";
    return handlerInput.responseBuilder.speak(msg).reprompt(msg).getResponse();
  }
}

const ClovaGuideIntentHandler = {
  canHandle: function(handlerInput){
    return handlerInput.requestEnvelope.isMatch('Clova.GuideIntent');
  },
  handle: function(handlerInput){
    var msg = "このスキルは今日のあなたの運勢を占います。あなたの星座を教えてください。";
    return handlerInput.responseBuilder.speak(msg).reprompt(msg).getResponse();
  }
}

const DivinationIntentHandler = {
  canHandle: function(handlerInput){
    return handlerInput.requestEnvelope.isMatch('DivinationIntent');
  },
  handle: function(handlerInput){
    // 運勢を配列で。
    var fortunes = ["良い", "普通", "悪い"];
    // fortunesの中からランダムで
    var fortune = fortunes[Math.floor(Math.random() * fortunes.length)];

    // slotsを取得
    var constellation = handlerInput.requestEnvelope.request.intent.slots.constellation.value;

    // clovaに話す内容を作成。
    var msg = `${constellation}ですね。${constellation}の今日の運勢は${fortune}です。`;

    return handlerInput.responseBuilder.speak(msg).getResponse();
  }
}

const errorHandler = {
  canHandle: function(handlerInput){
    return true;
  },
  handle: function(handlerInput){
    var msg = "エラー発生";
    return handlerInput.responseBuilder.speak(msg).reprompt(msg).getResponse();
  }
}

exports.handler = clova.extensionBuilders
  .addRequestHandlers(LaunchRequestHandler,SessionEndedRequestHandler,ClovaGuideIntentHandler,DivinationIntentHandler)
  .addErrorHandlers(errorHandler)
  .lambda()

zipファイル化

lambdaにコードをあげる方法はいくつかあるが、簡単なZIPファイルにしてあげる方法にする。
fortune-funcディレクトリ配下でとりあえず、存在しているファイルを確認。

$ ls 
index.js    package-lock.json    node_modules       package.json

全部を圧縮する

$ zip -r upload.zip *

再度、存在しているファイルを確認

$ ls 
index.js    package-lock.json    node_modules       package.json    upload.zip

upload.zipというファイルが作成されているのが確認できる。

AWSのコンソール画面で

Lambdaで関数作成

AWSのLambdaの画面に移動し、右上の「関数の作成」ボタンを押す。

「一から作成」を選択肢、名前、ランタイム、ロールを以下のように設定する

名前: FortuneFunc
ランタイム: Node.js 8.10
ロール: カスタムロールの作成(すでにある場合は既存のロールを選択する）

カスタムロールの作成を選ぶと新規画面が勝手に出てくるので、右下の許可をクリック。

すると、先ほどの関数の作成画面に戻るはず。
右下の関数の作成をクリック。
おそらく、以下のような画面になるはず。

ご指摘いただいたのですが、人によってはLambdaの出力(画面右の方）がCloudWatchだけだったりしますが今回は動作上問題ありません。

次に、画面少し下行くと関数コードという項目があるので、その中のコードエントリタイプをzip ファイルをアップロードを選択する
そんで、その下のアップロードボタンを押して先ほど作成下upload.zipを選択して、右上の保存ボタンで保存する。

とりあえず、テストしてみる。

まだ、ClovaとLambdaを連携させてないので実機でのテストはできないがLambda上でテストする方法がある。
Lambda画面右上の「テストイベントの設定」ボタンをクリックするとテストイベントの設定画面が出てくるので以下の様に入力してあげる。

イベント名

LaunchRequest

イベント名の下のJSONを入力するところ。

{
  "version": "0.1.0",
  "session": {
    "new": true,
    "sessionAttributes": {},
    "sessionId": "sample",
    "user": {
      "userId": "V0qe",
      "accessToken": "sample"
    }
  },
  "context": {
    "System": {
      "application": {
        "applicationId": "sample"
      },
      "user": {
        "userId": "V0qe",
        "accessToken": "sample"
      },
      "device": {
        "deviceId": "sample",
        "display": {
          "size": "l100",
          "orientation": "landscape",
          "dpi": 96,
          "contentLayer": {
            "width": 640,
            "height": 360
          }
        }
      }
    }
  },
  "request": {
    "type": "LaunchRequest"
  }
}