實體

實體類型可用於控制從使用者輸入內容中擷取資料的方式。

Conversational Agents (Dialogflow CX) 提供預先定義的系統實體,可以比對許多常見的資料類型。舉例來說,您可以使用系統實體來比對日期、時間、顏色、電子郵件地址等。您也可以自行建立自訂實體,用於比對自訂資料。舉例來說,您可以定義蔬菜實體,以便比對可在日用品商店代理程式中購買的蔬菜種類。

實體術語

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

  • 實體類型:定義您想從使用者輸入內容中擷取的資訊類型。舉例來說,「蔬菜」可以是實體類型的顯示名稱。在 Dialogflow CX 主控台的「實體類型」部分,按一下「建立」即可建立「實體類型」。在 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
    Ruby 不適用 不適用

  • (選用) 說明:說明實體類型的用途,例如「使用者提到蔬菜時會觸發這個實體」。如果您想使用 AI 產生功能自動產生參照值同義字,模型會使用這個欄位產生更高品質的結果。

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

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

    建立新實體項目時,您可以勾選「自動產生每個實體的 __ 同義詞」核取方塊,而非手動輸入實體項目和同義詞。預設值為 3 個同義字。AI 會根據參照值和實體類型說明產生同義詞,並將這些同義詞輸入表格。請注意,同義詞清單也必須包含原始參照值,才能產生與該值相符的結果。

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

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