Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Skill Connections やってみた / Introduction to Alexa...

Skill Connections やってみた / Introduction to Alexa Skill Connections

【AAJUG大阪】VoiceConJapan2020直前企画!Alexaスキル開発ごった煮トーク でお話したSkill ConnectionsのLT資料です。某所でLTしたものと同じですが、少しブラッシュアップしました。サンプルコードあります。

https://aajug.connpass.com/event/161436/

Kuniaki Shimizu

February 09, 2020
Tweet

More Decks by Kuniaki Shimizu

Other Decks in Technology

Transcript

  1. Kuniaki Shimizu (@kun432) - シナジーマーケティング株式会社 - インフラエンジニア - Twitter/Facebook/Github/Hatena/Alexa -

    ポートフォリオ: https:/ /kun432.github.io/ - AWS認定Alexaスキルビルダー - Voiceflow Global Ambassador - Voiceflow Growth Award 2019 3 Hello!
  2. My Skills & Actions 4 - Alexa (JP): 12 -

    Google: 1 - Clova: 1 #スキル開発100チャレンジ - Alexa (US): 1
  3. 8

  4. Skill Connectionsおさらい 10 • 単純にいうと、スキル間連携 • スキルAから、スキルBの機能を呼び出す • スキルBの処理が終わるとスキルAに戻る •

    用語 ◦ リクエスタ(上で言うA) ▪ 他のスキルの機能を呼び出す ◦ プロバイダ(上で言うB) ▪ 他のスキルへ機能を提供する
  5. 11 連携 開始 連携中 連携後 印刷インテントトリガー ディレクティブ送信 (StartConnection) 印刷インテントハンドラ レスポンスハンドラ

    (SessionResumedRequest) 処理を続ける • リクエスタはconnectionエンドポイントに要求を投げる • プロバイダはAlexaが決めて、要求を受け渡す • プロバイダの実行結果をAlexaから受け取って処理を継続 Skill Connectionsの仕組み セッション切断 A B A 処理結果
  6. 13

  7. 14 リクエスタの実装 const continueIntentHandler = { ・・・ handle(handlerInput) { const

    speakOutput = 'それではプリンタスキルを呼び出して印刷します。'; return handlerInput.responseBuilder .speak(speakOutput) .addDirective({ 'type': 'Connections.StartConnection', 'uri': 'connection://AMAZON.PrintPDF/1', 'input': { '@type': 'PrintPDFRequest', '@version': '1', 'title': 'サンプルのPDF', 'description': 'スキルコネクションズのサンプルのPDFです。', 'url': 'https://******.s3-ap-northeast-1.amazonaws.com/sample1.pdf' }, 'token': 'none' }) .getResponse();
  8. 15 const ConnectionsResponseHandler = { canHandle(handlerInput) { const request =

    handlerInput.requestEnvelope.request; return request.type === 'SessionResumedRequest'; }, handle(handlerInput) { const statusCode = handlerInput.requestEnvelope.request.cause.status.code; const statusMessage = handlerInput.requestEnvelope.request.cause.status.message; console.log(`SessionResumedRequest: code: ${statusCode}, msg: ${statusMessage}`; let speechText;  switch (statusCode) { case “200”: // 購入した speechText = "印刷が終わりました。ご利用ありがとうございました。"; break; case “204”: // ユーザキャンセル speechText = "またご利用くださいね。"; Break; ・・・ Default: // その他エラー speechText = "ごめんなさい、うまく行かなかったようです。"; break;  } return handlerInput.responseBuilder.speak(speechText).getResponse(); }, };
  9. 17 課金 処理前 課金 処理中 課金 処理後 購入インテントトリガー ディレクティブ送信 (type=Connections.SendRequest)

    購入インテントハンドラ レスポンスハンドラ (type=Connections.Response) getResponseで会話フロー をつなげる 商品・料金説明、 同意確認 認証コード確認 課金処理 • スキル側でやるのは購入処理の手前と後だけ • 購入処理も一連のやり取りもAlexa⇔ユーザでやってくれる スキル内課金のやりとり セッション切断
  10. 18 MonetizationServiceClient • 購入をMonetizationServiceClientにリクエスト const BuyEnglishPackIntentHandler = { ・・・ handle(handlerInput)

    { const locale = handlerInput.requestEnvelope.request.locale; const ms = handlerInput.serviceClientFactory.getMonetizationServiceClient(); return ms.getInSkillProduct(locale, ENGLISH_PACK_ID).then(function (product) { if (product.entitled === "ENTITLED") { const speechText = `既に${product.name} を購入しています。続けますか?`; const repromptText = `続けますか?`; return handlerInput.responseBuilder .speak(speechText) .reprompt(repromptText) .getResponse(); } else { return handlerInput.responseBuilder .addDirective({ type: 'Connections.SendRequest', name: 'Buy', payload: { InSkillProduct: { productId: ENGLISH_PACK_ID } }, token: 'correlationToken' }) .getResponse(); } }); } };
  11. 19 .getResponse(); } else { return handlerInput.responseBuilder .addDirective({ type: 'Connections.SendRequest',

    name: 'Buy', payload: { InSkillProduct: { productId: ENGLISH_PACK_ID } }, token: 'correlationToken' }) .getResponse(); } });
  12. 20 MonetizationServiceClient • 購入処理結果を受けるハンドラ const BuyResponseHandler = { canHandle(handlerInput) {

    return handlerInput.requestEnvelope.request.type === 'Connections.Response' && ・・・ }, handle(handlerInput) { const locale = handlerInput.requestEnvelope.request.locale; const ms = handlerInput.serviceClientFactory.getMonetizationServiceClient(); return ms.getInSkillProduct(locale, ENGLISH_PACK_ID).then(function (product) { if (handlerInput.requestEnvelope.request.status.code === '200') { let speechText = product.summary; const repromptText = '続けますか?'; switch (handlerInput.requestEnvelope.request.payload.purchaseResult) { case 'ACCEPTED': // 購入した speechText = product.summary + repromptText; break; case 'DECLINED': // 購入しなかった speechText = repromptText; break; case 'ALREADY_PURCHASED': // 既に購入済 speechText = product.summary + repromptText; break; Default: // その他のERROR speechText = `うまく行かなかったようです。${repromptText}`; break; } ・・・続く・・・
  13. Skill Connections: Pros 22 • ISPやってれば実装そんなに難しくない。 ◦ プロバイダ側への受け渡し部分とプロバイダ側 処理は勝手にやってくれる ◦

    リクエスタは所定のフォーマットで投げて、 結果に応じて続けるだけ。 • 自分で実装しなくて良いのはやっぱり楽 ▪ ハードウェア連携は特に ▪ プロバイダが増えれば機能を増やせる ▪ プロバイダもAlexaがよしなに選んでくれる
  14. Skill Connections: Cons① 23 • ISPと同じで会話の流れがつかみにくい ◦ リクエスタとプロバイダが両方しゃべる。 ◦ 受け渡し時のAlexa側の発話もある。

    ◦ テスト用のタスク(AMAZON.TestStatusCode) を使って確認 ◦ プロバイダ側独自のステータスコードも。 ◦ 実際にテストしながら発話の自然さをチェック。 • 連携時は、セッション切れるので要対応 ◦ Persistent Attribute 良くも悪くもISPと同じ
  15. Skill Connections: Cons② 26 少なすぎる・・・ • 現在対応しているタスク ◦ 印刷系 ▪

    AMAZON.PrintImage ▪ AMAZON.PrintPDF ▪ AMAZON.PrintWebPage ◦ 予約系 ▪ AMAZON.ScheduleTaxiReservation ▪ AMAZON.ScheduleFoodEstablishmentRes ervation
  16. 30 その他つまづいたところ • 利用開始までのプロセスが長い(プリンタの場合) ◦ プリンタのWiFi接続設定 ◦ プリンタ側のアカウント登録 ◦ アカウントリンク

    ◦ スキル有効化までのハードルが高い、ここでくじける人 が一定数いるはず • 情報がない・・・ ◦ DevSummit以来、特に話がない ◦ ドキュメントが少なすぎるし、サンプルも微妙 ◦ Githubのサンプルコード欲しい
  17. 34 Custom Tasks & Direct Connections • Custom Tasks ◦

    プロバイダのタスクを自由に定義できるようになる? ◦ “ask api search-task/get-task” でタスクを探して使う • Direct Connections ◦ Skill Connectionsでは、Amazon定義のプロバイダが 自動的に選択される ◦ Direct Connectionsでは、リクエスタがプロバイダを 選択可能に? プロバイダの数・種類の増加に期待 さらにプロバイダ開発も
  18. 41 まとめ • Skill Connectionsの実装はISPと似てる。ISP やってれば難しくない • 現状は限定的なユースケースのみ • 今後、Custom

    Tasks & Direct Connectionsが出て きたら可能性が広がるかも • AlexaConversation含めて、ユーザ「以外」から起動され る・他のスキルから連携されやすい、単機能を きちんとこなすスキル企画・開発へ? スキル開発の別の形になるかも?ど