スキルのテスト



このドキュメントでは、作成中のスキルをテストする手順について説明します。

• Alexaスキルをテストする方法
• スキルの最小コンフィギュレーション
• スキルコードをデプロイする
• 開発者コンソールでスキルをテストする
• インテントのデバッグ
• 開発者アカウントを使用してAlexa搭載デバイスでテストする
• 関連トピック

Alexaスキルをテストする方法

開発中に新しいスキルをテストする方法はいくつかあります。

• カスタム対話モデルをテストするには、発話プロファイラーを使用します。サービスのコードを作成する前に、発話を入力し、インテントやスロットがどのように解決されるかを確認できます。
• 開発者コンソールのテストページにあるシミュレーターを使用します。シミュレーターでは、デバイスを使用しなくてもほぼすべてのAlexa Skills Kit機能にアクセスできます。Alexaとの対話には、音声またはテキストを使用できます。
• Alexa搭載デバイスを使用して音声でテストします。
• コマンドラインからASK CLIを使ってスキルをテストします。invoke-skillやsimulate-skillといったASK CLIコマンドを使ってスキルをテストできます。コマンドラインからスキルを管理する方法の詳細については、ASK CLIクイックスタートガイドを参照してください。
• スキル管理APIのスキルのテスト機能を使用します。
• Alexa搭載デバイスでテストします。

テストの方法にかかわらず、最小コンフィギュレーションのデータを指定して、スキルサービスをデプロイする必要があります。

スキルの最小コンフィギュレーション

スキルのテストを有効にするには、スキルに含まれる対話モデルに必要な最小コンフィギュレーション要件を満たす必要があります。これらの設定はすべて、ビルドページで設定できます。

カスタムモデルの最小コンフィギュレーション

正常にモデルを保存してビルドできたら、発話プロファイラーを使用してカスタム対話モデルをテストできます。このテスト用にエンドポイントを設定する必要はありません。

完全なエンドツーエンドのテストを行う場合は、以下に説明するようにコンフィギュレーションを設定します。

スキルやテストの必要な項目によっては、ビルドページの以下のセクションにも入力が必要になる場合があります。

• カスタム＞インターフェース： スキルがデバイスインターフェースを使用する場合、このページで有効にします。

• アカウントリンク： スキルがアカウントリンクを使用する場合、ここで設定します。

  認証を必要としないインテントのテストには、完全なアカウントリンクのコンフィギュレーションは必要ありません。ただし、LinkAccountCardを返すか、認証の必要なインテントをテストする場合は必要となります。

• アクセス権限： 権限（デバイスアドレスAPIの権限など）を使用するスキルの場合、ここで有効にします。

プリビルドモデルの最小コンフィギュレーション

スキルコードをデプロイする

スキルをテストするには、開発者コンソールでスキルに最低限必要なデータを設定し、クラウドベースのサービス用にコードをデプロイする必要があります。サービスをデプロイする方法は、スキルに使用する対話モデルによって異なります。

開発者コンソールでスキルをテストする

テストページにはシミュレーターがあり、デバイスなしでもスキルをテストすることができます。スキルをテストする準備ができたら、テストページに移動します。

このスキルでテストを有効にしていない場合、このスキルでは、テストは無効になっていますと表示されます。このとき、ドロップダウンリストは非公開に設定されています。このリストから、スキルのテストステージを選択します。開発中、公開中のいずれかです。

テストが有効な場合、スキルテストが有効になっているステージ：リストから、開発中、公開中、いずれかのテストステージを選択します。非公開を選択すると、テストは無効になります。

スキルのテストで一度に選択できるステージは1つだけです。たとえば、公開中のスキルでテストを有効にすると、開発中のスキルではテストが無効になります。また、公開中のスキルは、開発者アカウントでサインインした開発者コンソール、SMAPI、ASK CLI、デバイスで引き続き利用できます。開発者コンソールで公開中スキルのテストを有効にすると、公開中ステージのURLにリダイレクトされ、セッションとコンテキスト情報がすべてリセットされます。保持しておきたい情報がある場合は、保存してからテストを有効にします。また、新しいユーザーIDも生成されるため、初回起動時のユーザーエクスペリエンスをシミュレートできます。公開中のスキルをライブバージョンのLambdaを使って設定している場合、このバージョンがテストに使用されます。

テストページを使用して、スキルのほぼすべての機能（ダイアログ、プログレッシブ応答（制限あり）、エンティティ解決など）をテストできます。

ページの左側に、3種類のテスト用タブが表示されます。

カスタムスキルとスマートホームスキルに対してAlexaシミュレーターを使用する

シミュレーターとは、テキストまたは音声で対話できます。スキルセッションは、デバイスのようなタイムアウトをしないことに注意してください。これは、テスト中、応答の入力に時間をかけられるようにするためです。スキルのセッションが開いたままの場合、「アレクサ、止めて」と言って終了することができます。

スキルI/Oを有効にすると、会話のターンごとにスキルに送信されるJSONとAlexaに返されるJSONを確認できます。JSONは、カスタムスキルでのみ使用できます。吹き出しをクリックすると、そのターンに関連するJSONを確認できます。

デバイスの画面を有効にすると、スキルが画面付きのデバイスにおおよそでどう表示されるかを確認できます。詳細は、後で説明するさまざまな画面付きデバイスでのテストを参照してください。

デバイスのログを有効にすると、スキルの対話中にAlexaに送信されるイベントと、デバイスに送信されるディレクティブを確認できます。インテントのデバッグを参照してください。

Alexaスマートホーム（ベータ）を有効にすると、スキルがAlexaイベントゲートウェイに送信するChangeReportイベントを確認できます。このオプションは、スマートホームスキルでのみ利用できます。詳細については、スマートホームスキルのデバッグを参照してください。

シミュレーターを使用してカスタムスキルをテストする場合、context.System.device.supportedInterfacesプロパティにはカスタム＞インターフェースページで選択したインターフェースが反映されます。たとえば、AudioPlayerとAlexa Presentation Languageを選択した場合、シミュレーターからスキルに送信されるリクエストには次のcontextオブジェクトが含まれ、そのリクエストがこれらのインターフェースの両方をサポートするデバイスから受け取ったことがわかります（簡潔にするため、すべてのプロパティは記載していません）。

{
  "context": {
    "System": {
      "device": {
        "deviceId": "amzn1.ask.device.1",
        "supportedInterfaces": {
          "AudioPlayer": {},
          "Alexa.Presentation.APL": {
            "runtime": {
              "maxVersion": "1.1"
            }
          }
        }
      }
    }
  }
}

さまざまな画面付きデバイスでのテスト

スキルI/Oセクションのドロップダウンリストで、さまざまなタイプのデバイスを選択できます。選択されたデバイスが、スキルに送信されたリクエストのcontext.Viewportプロパティで提供されたデータを決定します。

使用できるデバイスは、Alexa Presentation Language（APL）ドキュメントで使用するviewportプロファイルパッケージで使用できるviewportプロファイルに対応します。

• 小型デバイス（円形）
• ハブ（横長）
• 中型デバイス
• 大型デバイス
• 超大型TV

viewportのプロパティについて詳しくは、Alexa Viewportプロファイルパッケージを参照してください。

テスト用にカスタムデバイスプロファイルを作成することもできます。他のタイプのデバイスで、スキルがどのように表示されるかをテストするのに便利です。ビデオ再生をサポートしていない画面付きデバイスで、スキルがどのように動作するかをテストするには、カスタムプロファイルを使用することもできます。

カスタムスロットタイプを作成するには、以下の手順に従います。

1. ドロップダウンリストをクリックして、標準viewportの一覧を開きます。
2. 一覧の一番下までスクロールし、カスタムデバイスを追加をクリックします。
3. 表示するviewportのプロパティを変更します。形状、ピクセル幅、ピクセル高さ、ピクセル密度を設定できます。ビデオ再生をサポートしていないデバイスを作成するには、デバイスがサポートしている特定のビデオコーデック、またはビデオを許可しない を選択することもできます。
4. 適用をクリックします。

カスタムデバイスは、現在のブラウザのセッション中は引き続き使用できます。ブラウザを閉じて、後でオーサリングツールを再度開くと、カスタムデバイスを再作成する必要があります。

Alexaシミュレーターの制限事項

以下の制限事項は、Alexaシミュレータータブでの音声およびテキストのテストに適用されます。

インテントのデバッグ

Alexaシミュレーターでは、デバイスのログにJSON応答で返されたconsideredIntentsが表示されるため、候補に挙がったが破棄されたインテントを確認できます。この情報を使用してインテントのデバッグを実行し、意図したインテントとスロットに発話を解決するようにモデルをトレーニングするために、追加のサンプルをどのように使用するか決めることができます。

開発者アカウントを使用してAlexa搭載デバイスでテストする

Alexa搭載デバイス（Amazon Echoなど）を使ってテストするには、Amazon開発者ポータルで開発者アカウントのサインアップに使用したのと同じメールアドレスでデバイスを登録すると、ウェイクワードと呼び出し名を使用してスキルを呼び出すことができます。 「アレクサ、＜呼び出し名＞を開いて」

開発者アカウント以外のアカウントでデバイスがセットアップされている場合は、デバイスをリセットしてから、開発者アカウントを使用して再登録します。詳細については、対象のデバイスのヘルプを参照してください。

• Echo端末をリセットする
• Amazon Echoサポート
• Amazonデバイスサポート

デバイスのユーザーとして開発者アカウント以外のアカウントを再度追加する場合、家族機能を使用して登録できます。（日本未対応）

関連トピック

カスタム：

• カスタムスキルのテストとデバッグ
• カスタムスキルをAWS Lambda関数としてホスティングする
• カスタムスキルをウェブサービスとしてホスティングする

フラッシュブリーフィング：

• フラッシュブリーフィングスキルを作成する際のヒント
• フラッシュブリーフィングスキルAPIフィードのリファレンス

スマートホーム：

• スマートホームスキルAPIのメッセージリファレンス
• スマートホームスキル公開のガイド
• スマートホームスキルのデバッグ

ビデオ：

• ビデオスキルのテストガイド

開発者コンソール：

• 開発者コンソールを使用したスキルの管理
• スキルの作成と対話モデルの選択
• スキルのビルド
• スキルストアの詳細と公開範囲を定義する
• スキルをテストして認定を申請する
• スキルの使用状況のレポート
• 支払いと収益を確認する