スロットマッピング

説明

スロットは、Cognigy NLUによって検出され、input.slotsプロパティの下にInputオブジェクトに配置される特定のデータタイプまたはカスタムキーフレーズです。

スロットには2つのタイプがあります：

• システム定義スロット
• ユーザー定義スロット（Lexicons / keyphrases） – Lexiconsをご覧ください。

CognigyScript経由でのスロットへのアクセス

システムとユーザーが作成したスロットは、CognigyScriptより簡単にアクセスできます。

{{input.slots}}には検出されたすべてのスロット、タグ、キーフレーズがあります。

システム定義スロット

Cognigy.AIは以下のスロットを自動的に検出します。システム定義スロットタグはすべて大文字です。

"DATE": [
{
"start": {
"day": 2,
"month": 6,
"year": 2018,
"hour": 12,
"minute": 0,
"second": 0,
"millisecond": 0,
"text": "tomorrow",
"weekday": 6,
"dayOfWeek": "Saturday",
"ISODate": "2018-06-02T12:00:00Z"
},
"end": null
}
]

"DATE": [
{
"start": {
"year": 2021,
"month": 12,
"day": 13,
"hour": 0,
"minute": 0,
"second": 0,
"milliseconds": 0,
"weekday": 1,
"dayOfWeek": "Monday",
"ISODate": "2021-12-13T00:00:00+01:00",
"plain": "December 13, 2021",
"grain": "week"
},
"end": null,
"text": "next week"
}
]

"NUMBER": [
100,
143
]

"DURATION": {
"hour": null,
"minute": 10,
"second": 20
}

"TEMPERATURE": [
50
]

"AGE": [
32
]

"EMAIL": [
"info@cognigy.com"
]

"PERCENTAGE": [
5
]

"URL": [
"https://cognigy.com"
]

"MONEY": [
{
"value": 500,
"unit": "$"
}
]

"DISTANCE": [
{
"value": 12,
"unit": "kilometre"
}
]

データ形式

以下の表は、サポートされている入力パターンと形式の概要です。

日付スロットの解析は、Flowで設定されている言語に異なります。対応している国別の日付形式の概要については、こちらを参照してください。次の表に、スラッシュ形式の日付に関する言語固有の操作の概要を示します：

未来と過去の日付マッピング

日付スロットの検出は、当月の日付の入力、および当年内にまだ発生していない日付の入力には、当年を使用します。

日付スロットの検出は、入力の日付が当月でなく、当年にすでに発生しており、入力に年が指定されていない場合、次の年を使用します。

DATEスロットに過去の日付を割り当てるには、入力で年を指定する必要があります。

例

入力が当月の日付の場合：

• 今日の日付は2023 年 7 月 26 日です。
• 入力は7月21日
• DATEスロットの結果 ："year": 2023, "month": 7, "day": 21

入力された日付が当月ではなく、前の月であり、年が指定されていない場合：

• 今日の日付は2023 年 7 月 26 日です。
• 入力は3月30日
• DATEスロットの結果： "year": 2024, "month": 3, "day": 30

入力された日付が当月ではなく前の月であり、年が指定されている場合：

• 今日の日付は2023 年 7 月 26 日です。
• 入力は 2021 年 3 月 30 日
• DATEスロットの結果 ："year": 2021, "month": 3, "day": 30

ユーザー定義スロット（レキシコン）

Cognigyのユーザー定義スロットはキーフレーズと呼ばれ、Lexiconエディタで作成、管理されます。

Cognigy AIでは、Lexiconはタグを持つキーフレーズのリストです。Lexiconは任意の数のキーフレーズを持つことができ、そのキーフレーズは任意の数のタグと類義語を持つことができます。

LexiconがFlowに割り当てられると、Flowはすべてのキーフレーズについてユーザー入力を解析します。同じタグを持つキーフレーズが検出されると、スロットに割り当てられます。

キーフレーズへのアクセス

検出されたキーフレーズは、入力プロパティinput.slots.lexiconTagName.keyphraseで公開されます。（例：input.slots.product.keyphrase.shirt）

{
    "slots": {
        "tag1": [
            {
                "keyphrase": "found keyphrase",
                "lower": "found keyphrase in lower case",
                "synonym": "found synonym, otherwise keyphrase",
                "count": "how often the keyphrase was found"
            }
        ]
    }
}

キーフレーズと類義語は、単語数の多い順に検出され、最も長いキーフレーズが最初に検出されます。cakeとcheese cakeが定義されていて、テキストがI love cheese cakeの場合、cheese cakeのみが検出されます。

類義語が見つかった場合、返されるキーフレーズは類義語がマップされたキーフレーズであり、類義語自体は結果の特別なsynonymプロパティに記録されます。

{
    "food": [
        {
            "keyphrase": "pizza",
            "count": 1,
            "synonym": "pizza pie"
        }
    ]
}