Share via

對話語言理解整合的實體

  • 發行項

重要

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

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

本文說明如何將交談語言理解 (CLU) 實體新增至 Microsoft Copilot Studio 機器人。 實體是由下列布林值、字串和數字資料類型所組成。 如需更多資訊，請見 資料類型。 在大多數情況下，您可以對專案使用 Power Virtual Agent 預建實體，但若要將 CLU 實體類型與自訂 JSON 解析搭配使用，則會提供下列結構描述範例做為參考。

若要設定環境以將 CLU 實體對應至 Microsoft 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

注意

複合實體 (含多個元件的實體) 對應至 StringDataype。

結構描述資料表

機器人製作者可以使用範例 JSON 程式碼來註冊實體。 實體會解析為複雜資料類型。 您可以手動將 CLU 實體對應至 Microsoft 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"
}