共用方式為

對話語言理解整合的實體

  • 發行項

重要

在對生成式 AI 進行大量投資並增強 Microsoft Copilot 的整合後，Power Virtual Agents 的功能和特性現已成為 Microsoft Copilot Studio 的一部分。

當我們更新文件和培訓內容時，某些文章和螢幕擷取畫面可能會參考 Power Virtual Agents。

本文會討論如何將交談語言理解 (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 日期時間實體類型

日期時間是特殊的實體類型，可根據收到的使用者輸入類型變更傳回的解析。

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

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"
}

相關內容