Clovaで「日本酒診断」のスキルを作ってみる（２）

19200 ワード
Clova TypeScript Express Line Express テキストリンク

はじめに

前回の続きです。一応完成しました。本当に思いつきで作ったのであまりボリュームのないコンテンツになってしまいました。

今回やったこと

前回示した会話モデルの実装を行いました。一応再掲します。

このモデルを実装するためには前回セッションのスロットを記憶しておく必要があります。そのためにsetSessionAttributes()とgetSessionAttributes()が必要になります。これはあるセッションで用いた値などを次のセッションに持ち越すことができるメソッドです。Attributesの受け渡しにはobjectを用います。詳しい説明はこちらの記事を参照するといいと思います。

会話のモデルの実装

実装の参考として公式のチュートリアルのサンプルコードを拝借しました。以下にコードを示します。

functions/index.ts
import * as functions from 'firebase-functions';
import Express from 'express';
import * as Clova from '@line/clova-cek-sdk-nodejs';

const extensionId : string = functions.config().clova.extension.id;

const clovaSkillHandler = Clova.Client
    .configureSkill()

    //起動時に喋る
    .onLaunchRequest((responseHelper: { setSimpleSpeech: (arg0: { lang: string; type: string; value: string; }) => Clova.Context; }) => {
        responseHelper.setSimpleSpeech(Clova.SpeechBuilder.createSpeechText(`日本酒診断をします。２つの質問に答えてください。飲み方はヒヤか、熱燗、どちらがいいですか？`))
        .setSessionAttributes({}); //Attributesの初期化
    })

    //ユーザーからの発話が来たら反応する箇所
    .onIntentRequest(async (responseHelper: { 
        getIntentName: () => string; 
        getSlot: (slotName: string) => string; 
        getSessionAttributes: () => {drinkType?: string; tasteType?: string};
        setSimpleSpeech: { (arg0: { lang: string; type: string; value: string; }): Clova.Context;
        (arg0: Clova.Clova.SpeechInfoText, arg1: boolean): void; }; }) => {
        const intent = responseHelper.getIntentName();
        const drinkType = responseHelper.getSlot('drinkType') ? responseHelper.getSlot('drinkType') : responseHelper.getSessionAttributes().drinkType;
        const tasteType = responseHelper.getSlot('tasteType') ? responseHelper.getSlot('tasteType') : responseHelper.getSessionAttributes().tasteType;

        switch (intent) {
            case 'howDrinkIntent':
                if (drinkType && tasteType) {
                    responseHelper.setSimpleSpeech(Clova.SpeechBuilder.createSpeechText(`${drinkType}で飲む${tasteType}のタニガワダケをオススメします。`))
                    .endSession();
                }
                else {
                    responseHelper.setSimpleSpeech(Clova.SpeechBuilder.createSpeechText(`甘口か、辛口、どちらがいいですか？`))
                    .setSessionAttributes({drinkType: drinkType});
                }
                break;

            case 'howTasteIntent':
                if (drinkType && tasteType) {
                    responseHelper.setSimpleSpeech(Clova.SpeechBuilder.createSpeechText(`${drinkType}で飲む${tasteType}のタニガワダケをオススメします。`))
                    .endSession();
                }
                else {
                    responseHelper.setSimpleSpeech(Clova.SpeechBuilder.createSpeechText(`飲み方は冷か、燗、どちらがいいですか？`))
                    .setSessionAttributes({tasteType: tasteType});
                }
                break;

            default:
                responseHelper.setSimpleSpeech(Clova.SpeechBuilder.createSpeechText(`もう一度お願いします`));
                break;
        }
    })

    //終了時
    .onSessionEndedRequest((responseHelper: { getSessionId: () => void; }) => {
        //const sessionId = responseHelper.getSessionId();
    })
    .handle();

const app = Express();

const clovaMiddleware = Clova.Middleware({applicationId: extensionId});
app.use( function (req, res, next) {
    req.body = JSON.stringify(req.body)
    next()
})
app.post('/clova', clovaMiddleware, <Express.RequestHandler>clovaSkillHandler);

exports.clova = functions.https.onRequest(app);

AttributesもしくはIntentのどちらかのスロットを持ってきたい場合には

const drinkType = responseHelper.getSlot('drinkType') ? responseHelper.getSlot('drinkType') : responseHelper.getSessionAttributes().drinkType;
const tasteType = responseHelper.getSlot('tasteType') ? responseHelper.getSlot('tasteType') : responseHelper.getSessionAttributes().tasteType;

のようにするとスッキリと書けます。こうして全部のスロットを最初に受け取っておけば、後はif文などでスロットがすべてそろっているかの判断をすればいいわけです。今回はスロットがすべてそろったと判断したときに、

Clova.SpeechBuilder.createSpeechText(`${drinkType}で飲む${tasteType}のタニガワダケをオススメします。`)

のようにして回答します。揃ってない場合はetSessionAttributes(object)を呼び出して次のセッションへとつなげます。drinkTypeには「ヒヤ・熱燗」、tasteTypeには「甘口・辛口」を登録しています。特に技術的な苦労はありませんでしたが、「ヒヤ」は「冷」と表記すると「レイ」とClovaが読んでしまうのでカタカナ表記にしました。同じ理由で「谷川岳」も「タニガワダケ」と表記しています（谷川タケシと読まれた）。
またこのAttributesを場合の注意点として、一番最初のセッション、つまりはonLaunchRequestのときにobjectの値を初期化する必要があります。どうやらセッションを終了しても値が残り続けるみたいです。

動画

動画

動画は1パターンのみですが、まあ会話モデルを見てくれたら他の結果も特に聞く意味はないと分かってくれるかと思います。

さいごに

今回のスキル開発はAttributesをつかうこととTypeScriptで実装することが目的だったので、一旦終わりにしてスキル公開の申請をしようかと思います。次はLINE botとの連携をやってみたいです。