共用方式為

對話語言理解整合的實體

  • 發行項

本文會討論如何將交談語言理解 (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 代碼為您建立的副手註冊實體。 實體會解析為複雜資料類型。 您可以手動將 CLU 實體對應至 Copilot Studio 資料類型，方法是複製並貼上相應實體的下列 JSON 程式碼區塊。

年齡

{
    "unit": "Year",
    "value": 10
}

貨幣

{
    "unit": "Egyptian pound",
    "ISO4217": "EGP",
    "value": 30
}

溫度

{
    "unit": "Fahrenheit",
    "value": 88
}

序數

{
    "offset": "3",
    "relativeTo": "Start",
    "value": "3"
}

維度

{
    "unit": "KilometersPerHour",
    "value": 24
}

CLU 日期時間實體類型

DateTime 是一種特殊實體類型，它根據收到的使用者輸入類型更改返回的解析度。

下列範例示範如何為不同類型的日期與時間表達設定實體。 您可以根據這些範例建立自己的對應，具體取決於您希望副手使用者提供的結果類型。

Date

範例輸入：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 (自從)

範例輸入： 自從八月起我就不在了

{
    "resolutionKind": "TemporalSpan",
    "timex": "XXXX-08",
    "begin": "2022-08-01",
    "modifier": "Since"
}

Time

範例輸入：現在是七點半

{
    "resolutionKind": "DateTime",
    "dateTimeSubKind": "Time",
    "timex": "T07:30",
    "value": "07:30:00"
}

相關內容