次の方法で共有


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

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