エンティティ解決

Note: Sign in to the developer console to build or publish your skill.

エンティティ解決

Alexaは、エンティティ解決を使ってユーザー発話のスロット値を1つの既知のエンティティに解決します。エンティティは、実在の個人、場所、物を表します。エンティティにはコードで使用できる識別子を持つことができます。同義語は、Alexaがユーザー発話を1つのエンティティに解決するのに役立ちます。

たとえば、国名を収集するスロットに対してユーザーが「ネーデルラント」と言ったとします。エンティティ解決を使って、Alexaは「ネーデルラント」を「オランダ」に解決します。

注：このドキュメントは、インテント、スロット、サンプル発話などのAlexa Skills Kitの概念を読者が理解していることを前提としています。これらのトピックの詳細については、以下を参照してください：インテント、スロット、ダイアログについて

スロットタイプとエンティティ解決

スロットタイプによってエンティティ解決がそのスロットに対してどう機能するかが決まります。

カスタムスロットタイプの場合、エンティティのセット、その識別子、エンティティに解決する同義語を定義します。これらの要素の定義については、カスタムスロットタイプのエンティティ解決を参照してください。

ビルトインスロットタイプの場合、エンティティ解決はビルトインスロットタイプによって変わります。

一部のビルトインスロットタイプはエンティティ解決とAlexa Entitiesを完全にサポートします。これらのタイプの場合、Alexaはエンティティと識別子をAlexaナレッジグラフに定義します。スキルで使用するこれらのエンティティに関する情報を取得するには、Linked Data APIを使用できます。AlexaナレッジグラフとAlexa Entitiesをサポートするビルトインスロットタイプの詳細については、Alexa Entitiesリファレンスを参照してください。
ビルトインスロットタイプを独自の値で拡張する場合、エンティティ解決はカスタム値を使ってエンティティ、識別子、同義語を定義します。ビルトインスロットタイプの拡張については、ビルトインスロットタイプをカスタム値で拡張するを参照してください。
ビルトインスロットタイプがエンティティ解決をサポートしておらず、独自の値で拡張していない場合、エンティティ解決は行われません。Alexaはユーザーが言った値を返し、エンティティ解決の結果を返すことはありません。

ビルトインスロットタイプでのエンティティ解決については、ビルトインスロットタイプのエンティティ解決を参照してください。

スキルリクエスト内のエンティティ解決結果

ユーザーがスキルにリクエストを出すと、Alexaは発話内のスロット値をスロットタイプに定義された既知のエンティティに解決しようとします。エンティティ解決が成功すると、スキルはIntentRequestに以下の情報を取得します。

ユーザーが言った実際の値。スロット値のslotValue.valueプロパティにあるこの値にアクセスします。
考えられる既知のエンティティの配列を含むオブジェクト。各エンティティには名前とIDが含まれます。結果を含むオブジェクトは、スロット値のslotValue.resolutionsプロパティから取得できます。

既に述べたように、考えられるエンティティと識別子のソースはスロットタイプによって異なります。

エンティティ解決が行われない場合、resolutionsプロパティはリクエストに含まれません。

以下は、カスタムスロットタイプListOfActivitiesを使用するスロットのエンティティ解決結果の例です。ユーザーはスロット値に対して「ハイキング」と言いました。Alexaはこの発話を考えられる2つのエンティティに解決しました。1つは「ハイキング」、もう1つは「スノーシューイング」です。それぞれにカスタムIDがあります。簡潔に説明するため、この例ではIntentRequestのintentプロパティを示しています。

{
  "intent": {
    "name": "PlanMyTripIntent",
    "confirmationStatus": "NONE",
    "slots": {
      "activity": {
        "name": "activity",
        "value": "ハイキング",
        "resolutions": {
          "resolutionsPerAuthority": [
            {
              "authority": "amzn1.er-authority.echo-sdk.amzn1.ask.skill.1.ListOfActivities",
              "status": {
                "code": "ER_SUCCESS_MATCH"
              },
              "values": [
                {
                  "value": {
                    "name": "ハイキング",
                    "id": "HIKE"
                  }
                },
                {
                  "value": {
                    "name": "スノーシューイング",
                    "id": "SNOWSHOE"
                  }
                }
              ]
            }
          ]
        },
        "confirmationStatus": "NONE",
        "source": "USER",
        "slotValue": {
          "type": "Simple",
          "value": "ハイキング",
          "resolutions": {
            "resolutionsPerAuthority": [
              {
                "authority": "amzn1.er-authority.echo-sdk.amzn1.ask.skill.1.ListOfActivities",
                "status": {
                  "code": "ER_SUCCESS_MATCH"
                },
                "values": [
                  {
                    "value": {
                      "name": "ハイキング",
                      "id": "HIKE"
                    }
                  },
                  {
                    "value": {
                      "name": "スノーシューイング",
                      "id": "SNOWSHOE"
                    }
                  }
                ]
              }
            ]
          }
        }
      },
      "toCity": {
        "name": "toCity",
        "confirmationStatus": "NONE",
        "source": "USER"
      }
    }
  }
}

ヒント： 後方互換性を維持するため、valueプロパティとresolutionsプロパティはスロットオブジェクトに直接提供されています。リクエストでスロット値にアクセスするには、slotValueプロパティを使用することをお勧めします。このプロパティは、1つの値を収集するスロットと複数の値を収集するスロットで使用できます。

リクエストで利用できるプロパティに関するすべてのリファレンスについては、IntentRequestを参照してください。