實體

實體類型用於控管如何從使用者輸入內容擷取資料。

Dialogflow CX 提供預先定義的系統實體,可比對多種常見的資料類型。舉例來說,系統實體可用於比對日期、時間、顏色、電子郵件地址等。您也可以建立自己的自訂實體,用於比對自訂資料。舉例來說,您可以定義蔬菜實體,比對雜貨店代理可購買的蔬菜類型。

實體術語

本說明文件和 Dialogflow CX 控制台使用「實體」一詞,描述實體的一般概念。討論實體詳細資料時,請務必瞭解更具體的術語:

  • 實體類型:定義您想從使用者輸入內容中擷取的資訊類型。例如,vegetable 可以是實體類型的顯示名稱。在 Dialogflow CX 控制台的「Entity Types」(實體類型) 專區中,點選「Create」(建立) 即可建立實體類型。使用 API 時,「實體類型」一詞是指 EntityType 類型。

    選取 EntityType 參照的通訊協定和版本:

    通訊協定 V3 V3beta1
    REST EntityType 資源 EntityType 資源
    RPC EntityType 介面 EntityType 介面
    C++ EntityTypesClient 不適用
    C# EntityTypesClient 不適用
    Go EntityTypesClient 不適用
    Java EntityTypesClient EntityTypesClient
    Node.js EntityTypesClient EntityTypesClient
    PHP 不適用 不適用
    Python EntityTypesClient EntityTypesClient
    小茹 不適用 不適用

  • (選用) 說明:說明實體類型的用途,例如「當使用者提及蔬菜時,會觸發這個實體」。如果您打算使用 AI 生成功能自動生成參考值同義詞,模型會使用這個欄位產生更優質的結果。

  • 實體項目:每個實體類型可以有多個實體項目。每個實體項目都會提供一組視為等效的字詞或詞組,第一欄是「參考值」,第二欄則是該參考值的一或多個「同義詞」。舉例來說,如果蔬菜是實體類型,您可以定義下列實體項目:

    參考值 同義詞
    青蔥 蔥、青蔥
    甜椒 青椒、甜椒
    紅蘿蔔 紅蘿蔔
    馬鈴薯 馬鈴薯、塊莖

    建立新的實體項目時,您可以勾選「Auto-generate __ syonyms per entity」(自動為每個實體產生 __ 個同義詞) 核取方塊,而不必手動輸入實體項目和同義詞。預設值為 3 個同義詞。AI 會根據參考值和實體類型說明生成同義詞,並輸入至表格。請注意,同義詞清單也必須包含原始參考值,才能與該值相符。

    在 Dialogflow CX 控制台編輯實體類型時,畫面的每一列都是一個實體項目。在 API 中,「實體項目」一詞是指 Entity 類型 (在某些用戶端程式庫語言中為 EntityType.Entity 或 EntityType_Entity)。

  • 實體參照值和同義詞:部分實體項目有多個意義相同的字詞或詞組,例如前例中的青蔥。針對這些實體項目,您可以提供一個「參照值」和一或多個「同義詞」。