会話の言語理解統合に対するエンティティ登録

この記事では、会話言語理解 (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

スキーマ テーブル

サンプルの 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"
}

関連するコンテンツ

• 会話言語理解の統合を始める