SwaggerでLambdaのデバッグ環境を作る(5)：Clovaをデバッグする

SwaggerでLambdaのデバッグ環境を作る(5)：Clovaをデバッグする:

第1回投稿で、SwaggerでLambdaのデバッグ環境を作りました。

　SwaggerでLambdaのデバッグ環境を作る(1)

GoogleHome、Alexaと続いて、とうとうClovaのスキルをデバッグします。

Clovaスキルを作る

早速、Clovaスキルを作成しましょう。

Clova Developer Center β

　https://clova-developers.line.biz/

スキル設定、または、スキルを開発する ボタンを押下します。

それでは、「LINE Developersでスキルチャネルを新規作成」を押下しましょう。

まずは、プロバイダを選択します。まだ作っていなければ、これを機に作りましょう。

チャネル名は適当に「テストスキル」にしました。

さあ、スキル開発を始めましょう。

手始めに、いくつか入力しなければいけないのですが、適当で大丈夫です。スキル名や呼び出し名は「テストスキル」にしました。

それでは、発話を設定していきます。

まずは、カスタムインテントを作りましょう。毎度の通り、インテント名を「Thanks」とします。

「ありがとう」というと「どういたしまして」、と返すためです。

サンプル発話に「ありがとう」と入力します。

そして、ビルドボタンでビルドを開始しておきます。

完了まで数分かかります。

ローカルのデバッグ環境に転送する。

それでは、受け付けた発話をローカルのデバッグ環境に転送する設定をします。

左側のナビゲータから開発設定を選択します。

ここで表示される「ExtensionサーバーのURL」に、これから立ち上げるRESTfulサーバのURLを指定します。

そして、保存ボタンを押下しておきます。

ローカルのデバッグ環境を立ち上げる。

それでは、転送を引き受けるデバッグ環境を設定していきます。

Swagger定義ファイルは以下の感じです。

swagger.yaml

/test-clova: 
    post: 
      x-swagger-router-controller: routing 
      operationId: test-clova 
      parameters: 
        - in: body 
          name: body 
          schema: 
            $ref: "#/definitions/CommonRequest" 
      responses: 
        200: 
          description: Success 
          schema: 
            $ref: "#/definitions/CommonResponse" 

実装の場所をrouting.jsに指定するのですが、これまたちょっと違う場所に指定します。Alexaの時と同じところです。

routing.js

const alexa_table = { 
//  "test-alexa" : require('./test_alexa').handler, 
//  "test-clova": require('./test-clova').handler, 
"test-clova": require('./test-clova').handler, 
}; 

実装には、以下のnpmモジュールを利用しますので、ローカル環境にインストールしておきます。

npm install --save @line/clova-cek-sdk-nodejs

実装はapi/controllers/test-clova/index.jsに置きます。

index.js

const clova = require('@line/clova-cek-sdk-nodejs'); 
 
const HELPER_BASE = process.env.HELPER_BASE || '../../helpers/'; 
const ClovaUtils = require( HELPER_BASE + 'clova-utils'); 
const app = new ClovaUtils(clova); 
 
app.intent('LaunchRequest', async (responseHelper) =>{ 
    responseHelper.setSimpleSpeech({ 
        lang: 'ja', 
        type: 'PlainText', 
        value: 'こんにちは', 
    }); 
}); 
 
app.intent('Thanks', async (responseHelper) =>{ 
    responseHelper.setSimpleSpeech({ 
        lang: 'ja', 
        type: 'PlainText', 
        value: 'どういたしまして。', 
    }); 
}); 
 
exports.handler = app.lambda(); 

Dialogflowと同じような書き方ができるように、ヘルパを使っています。

api/helpers/clova-utils.jsに置きます。

clova-utils.js

'use strict'; 
 
class ClovaUtils{ 
    constructor(clova){ 
        this.clova = clova; 
        this.clovaSkillHandler = clova.Client.configureSkill(); 
        this.launchHandle = null; 
        this.eventHandle = null; 
        this.sessionEndedHandle = null; 
        this.intentHandles = new Map(); 
 
        this.clovaSkillHandler 
        .onLaunchRequest(async responseHelper => { 
            if( this.launchHandle ){ 
                console.log('handle: LaunchRequest called'); 
                return await this.launchHandle(responseHelper); 
            } 
        }) 
        .onIntentRequest(async responseHelper => { 
            const intent = responseHelper.getIntentName(); 
 
            var handle = this.intentHandles.get(intent); 
            if( handle ){ 
                console.log('handle: ' + intent + ' called'); 
                return await handle(responseHelper); 
            } 
        }) 
        .onSessionEndedRequest(async responseHelper => { 
            if( this.sessionEndedHandle ){ 
                console.log('handle: SessionEndedRequest called'); 
                return await this.sessionEndedHandle(responseHelper); 
            } 
        }) 
        .onEventRequest(async responseHelper => { 
            if( this.eventHandle ){ 
                console.log('handle: EventRequest called'); 
                return await this.eventdHandle(responseHelper); 
            } 
        }); 
    } 
 
    intent( matcher, handle ){ 
        if( matcher == 'LaunchRequest') 
            this.launchHandle = handle; 
        else if( matcher == 'SessionEndedRequest') 
            this.sessionEndedHandle = handle; 
        else if( matcher == 'EventRequest') 
            this.eventHandle = handle; 
        else 
            this.intentHandles.set(matcher, handle); 
    } 
 
    getAttributes( responseHelper ){ 
        return responseHelper.getSessionAttributes(); 
    } 
 
    setAttributes( responseHelper, attributes){ 
        responseHelper.setSessionAttributes(attributes); 
    } 
 
    getSlots( responseHelper ){ 
        return responseHelper.getSlots(); 
    } 
 
    handle(){ 
        return this.clovaSkillHandler.handle(); 
    } 
 
    lambda(){ 
        return this.clovaSkillHandler.lambda(); 
    } 
}; 
 
module.exports = ClovaUtils; 

さあ、起動させましょう。

Clova Developer Centerで接続確認ができます。

テストタブを選択します。「ユーザのサンプル発話をテスト」のところに、「ありがとう」と入力して、「テスト」ボタンを押してみましょう。

「どういたしまして」が返ってきましたでしょうか？

Clovaでも試してみます。

Clovaに対して、以下を話してみましょう。

→「Clova、テストスキルを開いて」

← 　「こんにちは」

→「ありがとう」

←　「どういたしまして」

この通りになりましたでしょうか？

Lambdaに配置する

以下を参考に、アップロードします。

　SwaggerでLambdaのデバッグ環境を作る(1)

　SwaggerでLambdaのデバッグ環境を作る(3)：Dialogflowをデバッグする

SwaggerでLambdaのデバッグ環境を作る(1)の「AWS LambdaにヘルパライブラリのLayerを追加」のあたりからです。

注意点として、clova-utils.jsというヘルパーライブラリを追加していますので、レイヤは更新が必要です。

また、Clova用にnpmモジュールを追加していますので、Lambdaに上げるときに一緒にアップしてください。それについては、SwaggerでLambdaのデバッグ環境を作る(3)の「Lambdaにアップロードする」 のあたりを参考にしてください。

API Gatewayのエンドポイントを作る際に、注意点があります。

「Lambda プロキシ統合の使用」のチェックボックスはOnにしないでください。

以上です。