カスタムスキルのビルド手順



カスタムスキルのビルド手順

このガイドでは、カスタムスキルを新規作成する手順を紹介します。

作成するスキルのモデルが、カスタム対話モデルで合っているかを確認するには、 スキルの種類についてをご覧ください。カスタム対話モデルと各プリビルドモデルの違いについて記載されています。

ステップ1: 音声ユーザーインターフェースのデザイン

コードを作成する前に、まずスキルに認識されやすい音声ユーザーインターフェースをデザインすることが不可欠です。音声インターフェースは、スキルとユーザーが対話するための第一の手段です。

  1. ユーザーとスキルの対話の流れを表すフローダイアグラムを作成します。このフローダイアグラムでは、ユーザーによるリクエストとそれに対する応答を表すようにします。このダイアグラムを元に、インターフェースの詳細をデザインします。

    画面用インターフェースに対応するようにデザインされていないスキルを画面付きのAlexaが使えるデバイスで起動した場合、音声対話は画面のないデバイスと同じものになり、Alexaアプリで表示されるものと同じカードが表示されます。

    画面を使った対話に特化したスキルを開発する場合は、画面とビジュアル、およびタッチ要素のフローもフローダイアグラムに含める必要があります。画面表示の開発の詳細については、画面付きのAlexaが使えるデバイス用のスキルの作成を参照してください。

  2. フローダイアグラムを元に、スキルが処理するユーザーリクエストを特定します。このリクエストがインテントになります。

  3. スキルに画像を含めるようデザインする場合、そのコンテンツを用意して、パブリックからアクセス可能なサイトに格納します。スキルアイコンはスキルに直接アップロードされるため、この画像はパブリックに格納する必要はありません。

リソース:

ステップ2: 開発者コンソールでのスキルのセットアップ

開発者コンソールを使用して、新しいスキルを作成します。モデルの選択画面で、カスタムモデルを選択します。

ステップ3: 音声デザインを使用した対話モデルの構築

対話モデルとは、インテント、サンプル発話、ダイアログモデルの集合体のことです。

  • インテント:スキルが処理できるリクエストのことです。
  • インテントでは、スロットと呼ばれる引数を任意で使用することもできます。
  • サンプル発話:ユーザーがスキルと対話するために使用する単語やフレーズに、インテントをマッピングします。
  • ダイアログモデル:スキルが必要とする情報と、Alexaがユーザーとの対話における情報を収集および確認するときに使用できるプロンプトを特定します。

これらのコンポーネントは、次の2つの方法で作成できます。

発話を作成するときは、サンプル発話のベストプラクティスも参照してください。

ステップ4: スキルのコードの作成とテスト

スキルのコーディングでは、主にAlexaサービスからリクエストを受け取り、それに対して応答するサービスを作成します。

  1. スキルのサービスをホストするAWS Lambda関数を作成するのがもっとも手軽です。AWS Lambda(アマゾンウェブサービスの提供サービスの1つ)は、サーバーを管理することなくクラウドでのコード実行を可能にするサービスです。

    関連トピック: スキルのAWS Lambda関数を作成する

    別の方法として、スキルのウェブサービスを構築して、任意のクラウドプロバイダーでホスティングすることもできます。カスタムスキルをウェブサービスとしてホスティングするを参照してください。

  2. スキルのコードを記述します。Lambdaを使用する場合は、Node.js、Java、Python、C#で作成できます。スキルをウェブサービスとしてホストする場合は、どのプログラム言語でも使用できます。

  3. 開発者コンソールにて、エンドポイントを設定してスキルを更新します(例:Lambda ARN)。

    スキルのビルド(カスタムモデル)を参照してください。

  4. テストページまたはAlexaが使えるデバイスでスキルをテストします。

    スキルのテストを参照してください。

  5. AlexaアプリのAlexaスキルストアに表示されるスキルのメタデータを更新します。

    スキルストアの詳細と公開範囲を定義するを参照してください。

ステップ5: スキルのベータテスト(任意)

スキルが完成したら、スキルのベータテストを任意でセットアップできます。ベータテストでは、一般にではなく、個人的に選択した限定的なテストグループにのみスキルを公開できます。

ステップ6: スキルの認定を申請する

スキルを公開する準備が整ったら、認定の申請をします。ベータテストを実施中のスキルでも、審査に進むことができます。

  1. 開発者コンソールの認定ページで検証と機能テストを実行します。これらのテストにより、スキルの認定を申請する前に修正する必要のある問題を特定できます。

  2. 申請チェックリストを確認します。このチェックリストには、Amazonの認定チームが行うテスト項目が含まれているため、これらのテストすべてに合格すれば、認定プロセスにかかる時間が短縮されます。

    関連トピック: カスタムスキルの認定要件

  3. スキルを公開する準備が整い、認定チェックリストでスキルが要件を満たしていることを確認できたらスキルの認定を申請します。

    スキルをテストして認定を申請するを参照してください。

スキル公開後の流れ

公開されたスキルはAlexaアプリに表示されるので、ユーザーはスキルを有効にして使用できます。

開発者は、公開後も機能を拡張したり、問題を修正したり、エンドユーザーのエクスペリエンスを改善したりして、スキルをアップデートすることができます。継続的なスキル開発とスキルの再申請が必要な場合の推奨事項については、スキルをテストして認定を申請する: 公開後にスキルの修正やアップデートを行うを参照してください。