Share via

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

  • [アーティクル]

重要

Power Virtual Agents 機能は、生成 AI への多大な投資と Microsoft Copilot 全体の統合の強化により、現在 Microsoft Copilot Studio の一部となっています。

ドキュメントやトレーニング コンテンツが更新される間、一部の記事やスクリーンショットで Power Virtual Agents が参照される場合があります。

この記事では、会話言語理解 (CLU) エンティティを Microsoft Copilot Studio ボットに追加することについて説明します。 エンティティは、次のブール値、文字列、および数値のデータ型で構成されます。 詳細については、データ型を参照してください。 ほとんどの場合、プロジェクトで Power Virtual Agent 事前構築済みエンティティ を使用できますが、カスタム JSON 解決で CLU エンティティ タイプを使用するべき場合は、次のスキーマ例を参考として利用できます。

Microsoft Copilot Studio ボットに CLU エンティティをマップするための環境を設定するには、言語理解の概要 を参照してください。

CLU エンティティでは次のデータ型を使用できます。

  • BooleanDatatype: Choice.Boolean
  • StringDatatype: Geography.Location, Regex , List, General.Event, General.Organization, Phone Number, IpAddress, Person.Name, Phone Number, URL
  • NumberDatatype: Number

注意

複合エンティティ (複数のコンポーネントを持つエンティティ) は、StringDataype にマップされます。

スキーマ テーブル

ボットの作成者は、サンプルの JSON コードを使用してエンティティを登録できます。 エンティティは複雑なデータ型に解決されます。 関連するエンティティの次の JSON コード ブロックをコピーして貼り付けることで、CLU エンティティを Microsoft 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"
}