ここではスキル開発でよく遭遇するエラーメッセージと、それらの原因と解決方法をご紹介します。
1. Alexa: 「スキルからの応答に問題があります」
対話モデルとバックエンドサービスの作成が完了後、シミュレータや実機でスキルをテストする際に下記のエラーメッセージに遭遇することがあります。
- ユーザー：「アレクサ、<呼び出し名>を起動して」
- Alexa: 「スキルからの応答に問題があります」
このエラーは、スキルからのJSONレスポンスが不正な形で送信され、セッションが強制終了したことが原因です。また、スキルを起動するときのLaunchRequest以外のインテントをテストするときにも発生する場合があります。
解決方法：
JSONのレスポンスをデバッグするには、必ずJSONのレスポンスをログに出力して、サンプルのJSONレスポンスと比較してみてください。スキルのエンドポイントがAWS Lambdaの場合、テストイベントを使えばエンドポイント側で発生しているエラーを確認しながらデバッグが可能です。
2. Alexa: 「リクエストされたスキルから有効な応答がありませんでした」
- ユーザー：「アレクサ、<呼び出し名>を起動して」
- Alexa: 「リクエストされたスキルから有効な応答がありませんでした」
この問題は、AWS Lambdaを使用しているときに、Alexa Skills Kitのトリガーが追加されていない場合や、AWS Lambda以外のエンドポイントでSSLの設定に誤りがあるときに発生します。
解決方法：
AWS Lambdaを使用している場合はLambda側の設定でAlexa Skills Kitのトリガーが追加されていることをご確認ください。また、独自のエンドポイントを使用している場合、こちらのドキュメントのウェブサービスの要件を満たしていることをご確認ください。
3. Alexa: 「すみません、ちょっと難しいです」
スキルをシミュレータでテストするときは問題なく起動できても、実機でテストするときにこのエラーが発生するケースがあります。よくある原因としては、実機でログインしているアカウントが開発者とは別のアカウントであるため、スキルが見つからず起動できないといったケースがあります。また、スキルの呼び出し名を変更した後、新しい呼び出し名が反映されていないケースもあります。
解決方法：
アカウントが必ず同じリージョンで作成されていることをご確認ください。開発者アカウントは、Alexaアプリへログインするアカウントと同じメールアドレス・パスワードである必要があります。詳しくは 「Alexa 開発者アカウント作成時のハマりどころ」を参照してください。
また、呼び出し名の変更が反映されない場合は、スキルを一度無効にして、再び有効にしてください。開発者コンソールのシミュレータ上でテストしている場合、ステージを「開発中」から「非公開」にして、再び「開発中」にしてください。実機でテストしている場合は、Alexaアプリの履歴で認識された文字列が実際の呼び出し名と一致しているかをご確認ください。
4. Alexa: ＜音声のみの応答です＞またはイヤコン（Alexaの効果音）
スキルを開発者コンソールのシミュレータでテストするときに、下記のケースが発生するときがあります。
- ユーザー：「アレクサ、<発話>」
- Alexa: 「<エラー音>」
解決方法：
発話プロファイラーを使用して、正しくマッピングされていない発話をご確認ください。このツールによって、どの発話がより正確に認識されるか確認することができ、インテントに正しく入らない発話も明確になります。
5. Alexa: <応答なし>
スキルをシミュレータでテストするときに、応答がない、または発話がずっと読み込み中の状態から進まないケースがあります。ブラウザやパソコンの設定によりテストシミュレータが正しく動作していない可能性があるため、動作環境を確認してください。
また、開発者のアカウントのリージョンと開発しているスキルのリージョンが異なる場合、実機でスキルを起動しても応答が返ってこないケースもあります。例えば、en-USのスキルをen-UKのデバイスでテストしている場合、言語設定が異なるためスキルが起動できません。
解決方法：
- ブラウザ設定
- Chrome/Firefoxでテストする
- 拡張機能やプラグインを無効にする
- プライベートウィンドウでテストする
- ブラウザのキャッシュをクリアする
- 環境設定
- アンチウイルスソフトやファイアウォールを無効にする
- ネットワークの設定やポリシーを確認する
- アカウントの国・リージョン設定を確認する
- Alexaデバイスの言語設定を確認する
- スマートフォンからAlexaを起動する場合、スマートフォン本体の言語設定がスキルの言語と一致していることを確認する