スロットタイプリファレンス



スロットタイプリファレンス

Alexa Skills Kitでは、スロット内データの認識と処理の方法を定義するスロットタイプがいくつかサポートされています。提供されているタイプは、以下の一般的なカテゴリーに分類されます。

利用可能状況

いくつかの標準スロットタイプには以下の利用可能状況が表示されます。

  • 利用可能: このスロットタイプは完全に利用可能で、プレビューとはみなされません。
  • 開発者プレビュー: このスロットタイプは開発者プレビューとして提供され、機能に関するフィードバックを受けて開発を続けるうちに改良が加えられ、変更されていく可能性があります。Alexa Skills Kitフォーラムにフィードバックをお送りください。

利用可能状況が表示されない場合は、そのスロットタイプは利用可能とみなされます。

数値、日付、時刻

ユーザーの発話を数値や日付などのデータタイプに変換するスロットタイプについて、次の表にまとめます。詳細と例については、表の後のセクションを参照してください。

特に記載がなければ、これらのスロットタイプはサポートされているすべてのロケールで利用可能です。

スロットタイプ 簡単な説明

AMAZON.DATE

日付(「今日」、「明日」、「7月」)を表す単語を日付形式(「2015-07-00T9」など)に変換します。

AMAZON.DURATION

期間(「5分」)を表す単語を数字で表した期間(「PT5M」)に変換します。

AMAZON.FOUR_DIGIT_NUMBER

4桁の数字を表す単語(「六〇四五」)を数列(「6045」)に変換します。

AMAZON.NUMBER

数字を表す単語(「五」)を数字(「5」など)に変換します。

AMAZON.PhoneNumber

(開発者プレビュー)

電話番号を表す数字や単語を、句読点のない文字列形式に変換します。サポートされているのは米国の電話番号のみですのでご注意ください。

このスロットタイプは、以下のロケールにあるスキルでのみ使用できます。

  • 英語(米国)

AMAZON.TIME

時間を示す単語(「朝の4時」、「2PM」)を時間の値(「04:00」、「14:00」)に変換します。

AMAZON.DATE

日付を表す語句を日付形式に変換します。

日付は、ISO-8601日付形式でサービスに提供されます。サービスがスロットで受け取る日付は、ユーザーの発話に含まれる特定のフレーズに応じて、以下のように異なることがある点にご注意ください。

  • 特定の日付に対応する発話(「今日」、「今」、「十一月二十五日」など)は、次のような完全な日付に変換されます。 2015-11-25。この変換では、現在の日付またはそれより後の日付がデフォルトであることにご注意ください(その他の例は、以下を参照)。
  • 特定の週に対応するだけの発話(「今週」、「来週」など)は、週番号を示す次のような日付に変換されます。 2015-W49
  • 特定の週の週末に対応する発話(「今週末」など)は、週番号と週末を示す次のような日付に変換されます。 2015-W49-WE
  • 月に対応し、特定の日には対応しない発話(「来月」、「十二月」など)は、次のような年と月のみの日付に変換されます。 2015-12
  • 年に対応する発話(「来年」など)は、年だけを含む次のような日付に変換されます。 2016
  • 10年単位の年に対応する発話は、10年単位の年を示す次のような日付に変換されます。 201X
  • 季節に対応する発話(「次の冬」など)は、次のような年と季節のインジケーターを含む日付に変換されます。冬: WISPSUFA
年の解決

ユーザーの発話で年が指定されていない場合、Alexaは、デフォルトで現在の日付の当日またはそれより後の日を想定します。たとえば、「二月一日」という発話は次の「2月1日」の日付を返すため、ユーザーがその発話をした日に応じて、年は次のように異なります。

今日が2017年1月31日であれば、スロットは2017-02-01を返します。
今日が2017年2月1日であれば、スロットは2017-02-01(今日の日付)を返します。
今日が2017年2月2日であれば、スロットは2018-02-01を返します(翌年の2月1日)。

例:

  • 「今日」: 2015-11-24
  • 「今」: 2015-11-24
  • 「明日」: 2015-11-25
  • 「十一月二十五日」: 2015-11-25
  • 「次の月曜日」: 2015-11-30
  • 「今週」: 2015-W48
  • 「来週」: 2015-W49
  • 「今週末」: 2015-W48-WE
  • 「今月」: 2015-11
  • 「来年」: 2016
  • 「この先の十年」: 201X
  • 「次の冬」: 2017-WI
  • 「たった今」: 2015-11-24

このスロットタイプは以下のサポートされているすべてのロケールにあるスキルで使用できます。

  • 英語(オーストラリア)
  • 英語(カナダ)
  • 英語(インド)
  • 英語(英国)
  • 英語(米国)
  • フランス語
  • ドイツ語
  • 日本語

(「数値、日付、時刻」に戻る)

AMAZON.DURATION

期間を表す語句を数字で表した期間に変換します。

期間は、ISO-8601期間形式に基づく形式でスキルに提供されます(PnYnMnDTnHnMnS)。Pは、これが期間であることを示します。nは数値で、nの後に続く大文字は特定の日付または時間の要素を示します。たとえば、P3Dは3日間を意味します。Tは、それ以後の値が日付の要素ではなく時間の要素であることを示すために使用します。

例:

  • 「十分間」: PT10M
  • 「五時間」: PT5H
  • 「三日間」: P3D
  • 「四十五秒間」: PT45S
  • 「八週間」: P8W
  • 「七年間」: P7Y
  • 「五時間十分」: PT5H10M
  • 「二年三時間十分」: P2YT3H10M

このスロットタイプは以下のサポートされているすべてのロケールにあるスキルで使用できます。

  • 英語(オーストラリア)
  • 英語(カナダ)
  • 英語(インド)
  • 英語(英国)
  • 英語(米国)
  • フランス語
  • ドイツ語
  • 日本語

(「数値、日付、時刻」に戻る)

AMAZON.FOUR_DIGIT_NUMBER

よく発話される4桁の数字を認識する特別な手段を提供します。これは、PINコード、検証コード、年など、1つまたは複数の数字グループとして発話されることの多い入力に役立ちます。ユーザーは、さまざまな言い方で数字を発話することができます。Alexaサービスによって、認識された数字がサービスに送信されます。

例:

  • 「六、〇、四、五」: 6045
  • 「六、零、四、五」: 6045
  • 「六、〇、四十五」: 6045
  • 「六十、四十五」: 6045
  • 「六千四十五」: 6045

このスロットタイプは以下のサポートされているすべてのロケールにあるスキルで使用できます。

  • 英語(オーストラリア)
  • 英語(カナダ)
  • 英語(インド)
  • 英語(英国)
  • 英語(米国)
  • フランス語
  • ドイツ語
  • 日本語

(「数値、日付、時刻」に戻る)

AMAZON.NUMBER

数字を表す単語を数字に変換します。

  • 「三」: 3
  • 「十」: 10
  • 「五十五」: 55
  • 「一、〇、四」: 104
  • 「百四」: 104
  • 「百と四」: 104
  • 「五千二百三十五」: 5235
  • 「九、八、零、三、四」: 98034

このスロットタイプは以下のサポートされているすべてのロケールにあるスキルで使用できます。

  • 英語(オーストラリア)
  • 英語(カナダ)
  • 英語(インド)
  • 英語(英国)
  • 英語(米国)
  • フランス語
  • ドイツ語
  • 日本語

(「数値、日付、時刻」に戻る)

AMAZON.PhoneNumber

(このスロットタイプは開発者プレビューです)

電話番号を表す数字や単語を、句読点のない文字列形式に変換します。以下の表の例を参照してください。

説明 発話入力 結果

+記号から始まる国際番号

+記号から始まる11桁の数字

「プラス、一、五、零、九、五、五、五、一、二、一、二」

+15095551212

+記号なしの国際番号

+記号なしの11桁の数字

「一、五、零、九、五、五、五、一、二、一、二」

15095551212

国内番号

国際コードなしの10桁の数字

「五、零、九、五、五、五、一、二、一、二」

5095551212

市内番号

国際コードまたは市外局番なしの7桁の電話番号

「五、五、五、一、二、一、二」

5551212

このスロットタイプは、以下のロケールにあるスキルでのみ使用できます。

  • 英語(米国)

(「数値、日付、時刻」に戻る)

AMAZON.TIME

時刻を表す語句を時刻値に変換します。

特定の時刻を表す値がISO-8601時刻形式でスキルに提供されます。真夜中は00:00で表現されます。

また、このスロットでは、「晩」などの時間帯に対応する、時刻に関連した発話もサポートされます。このタイプの発話は、ISO-8601形式の時刻ではなく、時間帯インジケーターを返します。たとえば、「晩」はEVという値を返します。次に挙げる時間帯インジケーターを返すことができます。夜: NI、午前: MO、午後: AF、晩: EV

例:

  • 「正午」: 12:00
  • 「真夜中」: 00:00
  • 「六時」: 06:00
  • 「午前四時二十三分」: 04:23
  • 「午前五時」: 05:00
  • 「午後一時三十分」: 13:30
  • 「PM二時十五分」: 14:15
  • 「夜中の十一時五十九分」: 23:59
  • 「今日の午前中」: MO
  • 「今」: 13:30

このスロットタイプは以下のサポートされているすべてのロケールにあるスキルで使用できます。

  • 英語(オーストラリア)
  • 英語(カナダ)
  • 英語(インド)
  • 英語(英国)
  • 英語(米国)
  • フランス語
  • ドイツ語
  • 日本語

(「数値、日付、時刻」に戻る)

フレーズ

フレーズスロットタイプを使用すると、ユーザーはフォーマットとコンテンツに関する制限を減らした入力ができます。スキルでは必ず1つのインテントに1つのフレーズスロットのみを使用してください。

以下のフレーズスロットタイプがサポートされています。

スロットタイプ 簡単な説明 サポートされる言語
AMAZON.SearchQuery 検索エンジンに入力するような検索クエリー。たとえば、データベースの検索など。 なぜ空は青いのか
メリーランド州の州都はどこか
近くのレストラン
英語(オーストラリア)
英語(カナダ)
英語(インド)
英語(英国)
英語(米国)
ドイツ語
日本語

一部のユーザーの入力を予測可能なパターンに従うようにしながら、その他のユーザーの入力をもっと自由なものにしておきたい場合、インテントでフレーズスロットを使用してより予測しにくい入力をキャプチャしながら、カスタムまたは標準のスロットを使用してより予測しやすい入力をキャプチャできます。

AMAZON.SearchQuery

ユーザーが質問しそうなことを考えるときは、標準またはカスタムのスロットタイプを使用してより予測しやすいユーザー入力をキャプチャし、AMAZON.SearchQueryスロットタイプを使用して検索クエリーを構成する、より予測しにくい入力をキャプチャすることを検討してください。

以下の例では、SearchIntentのインテントスキーマを示しています。これには、AMAZON.SearchQueryスロットタイプが使用され、AMAZON.US_CITYスロットタイプを使用するCityListスロットも含まれます。

スキルでは必ず1つのインテントに1つのAMAZON.SearchQueryスロットのみを使用してください。Amazon.SearchQueryスロットタイプは、サンプル発話内の別のインテントスロットと組み合わせることはできません。

また、各サンプル発話にはキャリアフレーズを含める必要があります。例外として、スロットサンプル内ではキャリアフレーズを省略できます。キャリアフレーズは発話の一部となる語句ですが、「検索する」または「見つける」などのスロットではありません。

{
  "intents": [
    {
      "name": "SearchIntent",
      "slots": [
        {
          "name": "Query",
          "type": "AMAZON.SearchQuery"
        },
        {
          "name": "CityList",
          "type": "AMAZON.US_CITY"
        }
      ],
      "samples": [
        "最寄りの{Query}を探して",
        "{Query}を見つけて",
        "{Query}を検索して",
        "{CityList}について詳しく教えて"
      ]
    }
  ]
}

開発者コンソールとSkill Management APIに互換性がある完全なインテントスキーマについては、対話モデルのスキーマを参照してください。

リストタイプ

ここで説明する各スロットタイプは、アイテムのリストを表しています。これらのスロットタイプは拡張して、発話を追加できます。そのためには、同じ名前でカスタムスロットタイプを定義し、カスタムスロットタイプ値として他の項目を追加します。発話とスロット値の例については、この後のセクションを参照してください。

リストスロットタイプ

スロットタイプ 簡単な説明 リストの値のサンプル 拡張 利用可能状況

AMAZON.Actor

俳優や女優の名前です。

  • 綾瀬はるか
  • 堺雅人
  • 柴咲コウ
  • 妻夫木聡
  • 福山雅治
  • 唐沢寿明
  • 大竹しのぶ
  • 黒木瞳
  • 菅田将暉
  • 渡辺謙
  • 阿部寛
  • 役所広司
  • 木村拓哉
  • 市川海老蔵
  • 高畑充希

開発者プレビュー

AMAZON.Animal

動物の名前一覧です。

  • パンダ
  • うさぎ
  • ハムスター
  • ぞう
  • タヌキ
  • トラ
  • イルカ
  • キツネ
  • リス
  • レッサーパンダ
  • クマ
  • カピバラ

開発者プレビュー

AMAZON.Artist

アーティストのフルネームです。

  • 葛飾北斎
  • 村上隆
  • 俵屋宗達
  • 尾形光琳
  • 伊藤若冲
  • 写楽(東洲斎写楽)
  • 広重(歌川広重)
  • 運慶
  • 岡本太郎
  • 福山雅治
  • 宇多田ヒカル
  • 安室奈美恵
  • 浜崎あゆみ
  • 坂本龍一
  • 松任谷由実

開発者プレビュー

AMAZON.Author

作家のフルネームです。

  • 夏目漱石
  • 太宰治
  • 村上春樹
  • 東野圭吾
  • 宮沢賢治
  • 司馬遼太郎
  • 佐伯泰英
  • 宮部みゆき
  • 鎌池和馬
  • 湊かなえ
  • 有川浩
  • 芥川龍之介
  • 川端康成
  • 三島由紀夫
  • 谷崎潤一郎

開発者プレビュー

AMAZON.Book

書籍名です。

  • 人間失格
  • 吾輩は猫である
  • 坊ちゃん
  • ノルウェーの森
  • 窓ぎわのトットちゃん
  • バカの壁
  • サラダ記念日
  • ハリー・ポッターと賢者の石
  • ハリー・ポッターと秘密の部屋
  • 道をひらく
  • 五体不満足
  • 世界の中心で、愛をさけぶ
  • 女性の品格
  • 日本沈没
  • チーズはどこへ消えた?

開発者プレビュー

AMAZON.City

日本語を話すユーザーが一般的に使用する日本や世界各地の都市の名前を認識します。

このスロットタイプは都市名の一般的なバリエーションを認識します。サービスに送信される都市名は、ユーザーが話した値と一致します。つまり、Alexaサービスは、都市名のバリエーションを正式な都市名に変換しません。

  • ニューヨーク
  • 福岡市
  • 中央区
  • 東伏見
  • 日本橋本町

開発者プレビュー

AMAZON.Color

色の名前です。

  • 黄色
  • ピンク
  • 水色
  • オレンジ色
  • 茶色
  • 黄緑
  • ベージュ
  • 金色

開発者プレビュー

AMAZON.Corporation

企業の正式名称です。

  • トヨタ
  • ソニー
  • パナソニック
  • 楽天
  • サントリー
  • ソフトバンク
  • 日産
  • キャノン
  • ホンダ
  • 日立
  • 任天堂
  • 日清食品
  • 全日空
  • ブリジストン

開発者プレビュー

AMAZON.Country

世界の国の名前です。

  • アメリカ
  • 米国
  • 中国
  • 韓国
  • イギリス
  • フランス
  • ドイツ
  • ロシア
  • ブラジル
  • タイ
  • イタリア
  • 台湾
  • 北朝鮮
  • シンガポール
  • オーストラリア

開発者プレビュー

AMAZON.FirstName

日本語を話すユーザーが一般的に使用する、よくある名前です。このスロットタイプは、正式な名前とニックネームの両方を認識します。サービスに送信される名前は、ユーザーが話した値と一致します。つまり、Alexaサービスは、ニックネームを正式な名前に変換しません。

読み仮名が同じで漢字が異なる名前については、通常、Alexaサービスはサービスに1つの共通形式を送信します。

  • ユウト(湧人)
  • ソウタ(壮太)
  • アオイ(葵)
  • ハルカ(遥河)
  • カナ(佳奈)

開発者プレビュー

AMAZON.Food

食品の名前です。

  • 寿司
  • すし
  • 餃子
  • ラーメン
  • カレーライス
  • 焼肉
  • 天ぷら
  • 刺身
  • 焼き魚
  • すき焼き
  • 焼きそば
  • うどん
  • そば
  • おにぎり
  • 味噌汁

開発者プレビュー

AMAZON.Language

スペイン語、タミル語、ヒンディー語、英語などの自然言語です。

  • アラビア語
  • スワヒリ語
  • カヌリ語
  • ネパール語
  • パンジャーブ語

開発者プレビュー

AMAZON.Movie

映画のタイトルです。

  • 千と千尋の神隠し
  • タイタニック
  • 君の名は。
  • キングコング対ゴジラ
  • ハリー・ポッターと賢者の石
  • ハリー・ポッターとアズカバンの囚人
  • ハウルの動く城
  • もののけ姫
  • ラストサムライ
  • おくりびと
  • 踊る大捜査線 THE MOVIE 2 レインボーブリッジを封鎖せよ!
  • 崖の上のポニョ
  • 七人の侍
  • アナと雪の女王
  • E.T.

開発者プレビュー

AMAZON.Person

実在の人物と架空の人物のフルネームです。

  • 安倍総理大臣
  • 安倍総理
  • 安倍首相
  • 安倍晋三
  • イチロー
  • 明石家さんま
  • タモリ
  • ビートたけし
  • 和田アキ子
  • マツコ・デラックス
  • 黒柳徹子
  • 笑福亭鶴瓶
  • アントニオ猪木
  • 中居正広
  • 松本人志

開発者プレビュー

AMAZON.Region

日本語を話すユーザーが一般的に使用する都道府県や地域を認識します。

  • 東京都
  • 北海道
  • 京都府
  • 福岡県
  • 南魚沼郡

開発者プレビュー

AMAZON.Room

家やその他の建物で一般的な部屋の名前です。

  • キッチン
  • 台所
  • リビング
  • リビングルーム
  • ダイニング
  • ダイニングルーム
  • 茶の間
  • 座敷
  • 寝室
  • 玄関
  • バスルーム
  • トイレ
  • 風呂
  • 洗面所
  • 和室

開発者プレビュー

(「リストスロットタイプ」に戻る)

カスタム値による標準スロットタイプの拡張

標準リストスロットタイプのサブセットにユーザー定義のカスタム値を追加できます。つまり、指定した値をAmazonが定義した標準値に追加できるということです。たとえば、AMAZON.Cityは、日本にいる話者が一般的に使用する都市を認識できるようにします。含まれていない可能性がある小さな町など、追加の都市を収集する必要がある場合、タイプを拡張してリストに追加できます。その後、スロットは、元の値のセットと追加したカスタム値を認識します。

標準スロットタイプに追加する値の同義語とIDを定義することもできます。詳細については、標準スロットタイプのエンティティ解決を参照してください。

標準スロットタイプの拡張は、特定のスキルにのみ適用されます。たとえば、あるスキルで追加の都市を指定してAMAZON.Cityを拡張しても、それらの変更はAMAZON.Cityを使用する他のスキルには適用されません。

スロットタイプの拡張

標準タイプを拡張する前に、スキルにスロットタイプを追加する必要があります。左側のナビゲーションで、スロットタイプのタイプを確認します。拡張するスロットタイプが含まれていなければ、スキルに追加します。

  1. 左側のナビゲーションから、スロットタイプの隣にある追加をクリックします。
  2. Alexaのビルトインライブラリから既存のスロットタイプを使用オプションを選択します。
  3. 追加する標準スロットタイプを検索します。スロットタイプは名前で絞り込むことができます。
  4. スロットタイプを追加をクリックして標準スロットタイプを追加します。
  5. 変更したら必ず保存するようにしてください。

標準スロットタイプを拡張するには、カスタムタイプと同様に値を追加します。左側のナビゲーションで、スロットタイプの中から編集するスロットタイプを選択します。それぞれの値を入力して、+記号をクリックするかEnterを押します。

開発者コンソールでスロットタイプを作成、編集する方法の詳細については、カスタムスロットタイプの作成および編集を参照してください。

拡張できるスロットタイプ

ほとんどのリストスロットタイプは拡張して値を追加することができます。拡張できるスロットタイプかどうかを確認するには、上記の「リストスロットタイプ」の表にある拡張列を参照してください。

ビルトインインテントライブラリのドキュメント

すべてのビルトインインテントは、ビルトインインテントライブラリで参照できます。

ビルトインインテントライブラリの使用方法については、以下を参照してください。

音声インターフェースの構築については、以下を参照してください。

ビルトインインテントライブラリでは、クリエイティブコモンズの表示 - 継承ライセンス(バージョン3.0)(以下「ライセンス」)のライセンス許諾のもとに、Schema.orgが採用されています。ライセンスに準拠することなくこのファイルを使用することはできません。ライセンスのコピーは、http://creativecommons.org/licenses/by-sa/3.0/で入手できます。不明な点については、alexa-ontology-support@amazon.comにお問い合わせください。