会話の言語理解統合に対するエンティティ登録
この記事では、会話言語理解 (CLU) エンティティを Copilot Studio のコパイロットに追加する方法について説明します。 エンティティは、次のブール値、文字列、および数値のデータ型で構成されます。 詳細については、データ型を参照してください。 ほとんどの場合、プロジェクトに 事前構築されたエンティティ を使用できます。 CLU エンティティ タイプをカスタムの JSON 解決で使用する場合は、次のスキーマ例を参照してください。
CLU エンティティを Copilot Studio のコパイロットにマッピングする環境を設定するには、会話型言語理解の統合を始める を参照してください。
CLU エンティティのマッピングには、以下のデータタイプが使用できます:
- BooleanDatatype:
Choice.Boolean
- StringDatatype:
Geography.Location, Regex , List, General.Event, General.Organization, Phone Number, IpAddress, Person.Name, Phone Number, URL
- NumberDatatype:
Number
注意
複合エンティティ (複数のコンポーネントを持つエンティティ) は StringDatatype
にマップされます。
スキーマ テーブル
サンプルの JSON コードを使用して、作成したコパイロットのエンティティを登録できます。 エンティティは複雑なデータ型に解決されます。 関連するエンティティの次の JSON コード ブロックをコピーして貼り付けることで、CLU エンティティを Copilot Studio データ型に手動でマッピングできます。
年齢
{
"unit": "Year",
"value": 10
}
通貨型
{
"unit": "Egyptian pound",
"ISO4217": "EGP",
"value": 30
}
温度
{
"unit": "Fahrenheit",
"value": 88
}
Ordinal
{
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
ディメンション
{
"unit": "KilometersPerHour",
"value": 24
}
CLU dateTime エンティティ タイプ
DateTime は特別なエンティティ タイプであり、受け取ったユーザー入力の種類に基づいて、返される解決を変更します。
次の例は、さまざまな種類の日時の発話に対して、エンティティを構成する方法を示しています。 コパイロットのユーザーに求める結果のタイプに応じて、これらの例を基に独自のマッピングを作成できます。
日
入力例: 1995 年 1 月 1 日
{
"dateTimeSubKind": "Date",
"timex": "1995-01-01",
"value": "1995-01-01"
}
DateTime (年)
入力例: 4 月 12 日に戻ります
{
"dateTimeSubKind": "Date",
"timex": "XXXX-04-12",
"value": "2022-04-12"
}
DatetimeRange (期間)
入力例: 9 月 3 日から 12 日まで外出します。
{
"resolutionKind": "TemporalSpan",
"timex": "(XXXX-09-03,XXXX-09-12,P9D)",
"duration": "P9D",
"begin": "2022-09-03",
"end": "2022-09-12"
}
DatetimeRange (セット)
入力例: 毎週火曜日
{
"resolutionKind": "DateTime",
"dateTimeSubKind": "Set",
"timex": "XXXX-WXX-2",
"value": "not resolved"
}
Datetime (開始時点)
入力例: 8 月から外出しています
{
"resolutionKind": "TemporalSpan",
"timex": "XXXX-08",
"begin": "2022-08-01",
"modifier": "Since"
}
時間
入力例 : 7 時半です
{
"resolutionKind": "DateTime",
"dateTimeSubKind": "Time",
"timex": "T07:30",
"value": "07:30:00"
}