この記事では、Copilot Studio エージェントに会話言語理解 (CLU) エンティティを追加する方法について説明します。 ほとんどの場合、 Copilot Studio の事前構築済みエンティティ をプロジェクトに使用できます。 CLU エンティティを使用するには:
次のデータ型の CLU エンティティを、対応する事前構築済みエンティティに直接マップできます。
-
BooleanDatatype:Choice.Boolean -
StringDatatype:Geography.Location、Regex、List、General.Event、General.Organization、IP Address、Person.Name、Phone Number、URL -
NumberDatatype:Number
メモ
複合エンティティ (複数のコンポーネントを持つエンティティ) は
StringDatatypeにマップされます。-
カスタム JSON 解決を使用する CLU エンティティの場合は、サンプルの JSON コードを使用して 、これらの外部エンティティ をエージェントに登録できます。 これらのエンティティは、複雑なデータ型に変換されます。 この記事の JSON コード ブロックをコピーして関連エンティティに貼り付けることで、CLU エンティティを Copilot Studio のデータ型に手動でマップできます。
詳細については、Power Fx ドキュメントの データ型 と、Azure AI 言語のドキュメントで サポートされている事前構築済みエンティティ コンポーネント を参照してください。
年齢
{
"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
}
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"
}