Entità

I tipi di entità vengono utilizzati per controllare in che modo vengono estratti i dati dall'input utente finale.

Dialogflow CX fornisce entità di sistema predefinite che possono corrispondere a molti tipi di dati comuni. Ad esempio, esistono entità di sistema per la corrispondenza di date, orari, colori, indirizzi email e così via. Puoi anche creare entità personalizzate per la corrispondenza di dati personalizzati. Ad esempio, potresti definire un'entità di verdura che può corrispondere ai tipi di verdure disponibili per l'acquisto con un agente di un negozio di alimentari.

Terminologia delle entità

Il termine entità viene utilizzato in questa documentazione e nella console Dialogflow CX per descrivere il concetto generale di entità. Quando si parla dei dettagli delle entità, è importante comprendere termini più specifici:

  • Tipo di entità: Definisce il tipo di informazioni che vuoi estrarre dall'input utente. Ad esempio, verdura potrebbe essere il nome visualizzato di un tipo di entità. Se fai clic su Crea nella sezione Tipi di entità della console Dialogflow CX, viene creato un tipo di entità. Quando utilizzi l'API, il termine tipo di entità si riferisce al tipo EntityType.

    Seleziona un protocollo e una versione per il riferimento EntityType:

    Protocollo V3 V3beta1
    REST Risorsa EntityType Risorsa EntityType
    RPC Interfaccia EntityType Interfaccia EntityType
    C++ EntityTypesClient Non disponibile
    C# EntityTypesClient Non disponibile
    Vai EntityTypesClient Non disponibile
    Java EntityTypesClient EntityTypesClient
    Node.js EntityTypesClient EntityTypesClient
    PHP Non disponibile Non disponibile
    Python EntityTypesClient EntityTypesClient
    Ruby Non disponibile Non disponibile

  • (Facoltativo) Descrizione: descrive lo scopo del tipo di entità, ad esempio "Questa entità viene attivata quando l'utente menziona una verdura". Se intendi utilizzare la generazione AI per generare automaticamente i sinonimi dei valori di riferimento, questo campo verrà utilizzato dal modello per produrre risultati di qualità superiore.

  • Voce di entità: Per ogni tipo di entità possono esistere molte voci di entità. Ogni voce di entità fornisce un insieme di parole o frasi considerate equivalenti, un valore di riferimento nella prima colonna e uno o più sinonimi di quel valore di riferimento nella seconda colonna. Ad esempio, se verdura è un tipo di entità, potresti definire queste voci di entità:

    Valore di riferimento Sinonimi
    scallion scallion, green onion
    bell pepper bell pepper, sweet pepper
    carrot carrot
    potato potato, tater, tuber

    Invece di inserire manualmente le voci di entità e i sinonimi, puoi selezionare la casella di controllo Genera automaticamente __ sinonimi per entità quando crei una nuova voce di entità. Il valore predefinito è 3 sinonimi. L'AI genererà i sinonimi in base al valore di riferimento e alla descrizione del tipo di entità e li inserirà nella tabella. Tieni presente che l'elenco dei sinonimi deve includere anche il valore di riferimento originale per produrre una corrispondenza con quel valore.

    Quando modifichi un tipo di entità dalla console Dialogflow CX, ogni riga della visualizzazione è una voce di entità. Quando utilizzi l'API, il termine voce di entità si riferisce al tipo Entity (EntityType.Entity o EntityType_Entity per alcuni linguaggi della libreria client).

  • Valore di riferimento e sinonimi dell'entità: alcune voci di entità hanno più parole o frasi considerate equivalenti, come scallion nell'esempio precedente. Per queste voci di entità, fornisci un valore di riferimento e uno o più sinonimi.