Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Os tipos de entidade
são usados para controlar como os dados da entrada do usuário final são extraídos.
Os agentes de conversação (Dialogflow CX) fornecem entidades predefinidas do sistema que podem corresponder a muitos tipos comuns de dados.
Por exemplo, há entidades do sistema que correspondem a datas, horários, cores, endereços de e-mail e assim por diante.
Também é possível criar suas próprias entidades personalizadas para corresponder a dados personalizados.
Por exemplo, defina uma entidade como "vegetal", que corresponda aos tipos de vegetais disponíveis para compra com um agente de mercearia.
Terminologia de entidade
O termo entidade é usado nesta documentação e no console do Dialogflow CX
para descrever o conceito geral de entidades.
Ao discutir os detalhes de entidade, é importante compreender termos mais específicos:
Tipo de entidade: define o tipo de informação que você quer extrair da entrada do usuário.
Por exemplo, vegetal pode ser o nome de exibição de um tipo de entidade.
Clique em Criar na seção Tipos de entidade do console do Dialogflow CX para criar um tipo de entidade.
Ao usar a API,
o termo tipo de entidade refere-se ao tipo EntityType.
Selecione um protocolo e uma versão para a referência EntityType:
Descrição(opcional): descreve a finalidade do tipo de entidade. Por exemplo, "Esta entidade é acionada quando o usuário menciona um vegetal". Se você pretende usar a geração de IA para gerar automaticamente sinônimos de valor de referência, esse campo será usado pelo modelo para produzir resultados de maior qualidade.
Entrada de entidade: para cada tipo de entidade, pode haver muitas entradas de entidade. Cada entrada de entidade
fornece um conjunto de palavras ou frases que são consideradas equivalentes, um
valor de referência na primeira coluna e um ou mais sinônimos para esse
valor de referência na segunda coluna. Por exemplo, se vegetal for um
tipo de entidade, será possível definir estas entradas:
Valor de referência
Sinônimos
cebolinha
cebolinha
pimentão
pimentão
carrot
carrot
batata
batata, batata-doce, tubérculo
Em vez de inserir entradas de entidade e sinônimos manualmente, marque a caixa de seleção Gerar automaticamente sinônimos por entidade ao criar uma nova entrada de entidade. O valor padrão é 3 sinônimos. A IA vai gerar sinônimos com base no valor de referência e na descrição do tipo de entidade e inseri-los na tabela. A lista de sinônimos também precisa incluir o valor de referência original para produzir uma correspondência com esse valor.
Ao editar um tipo de entidade no console do Dialogflow CX, cada linha da
exibição é uma entrada de entidade. O termo entrada de entidade durante o uso da API refere-se ao tipo Entity (EntityType.Entity ou EntityType_Entity para alguns idiomas da biblioteca de cliente).
Valor de referência de entidade e sinônimos:
algumas entradas de entidade têm várias palavras ou frases
que são consideradas equivalentes,
como o exemplo de cebolinha acima.
Para essas entradas de entidade, você fornece um valor de referência e um ou mais sinônimos.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eEntity types control the extraction of data from user input in Conversational Agents (Dialogflow CX).\u003c/p\u003e\n"],["\u003cp\u003eDialogflow CX offers predefined system entities for common data types like dates and times, and allows the creation of custom entities.\u003c/p\u003e\n"],["\u003cp\u003eAn entity type defines the kind of information to be extracted, such as "vegetable" as a display name for an entity type.\u003c/p\u003e\n"],["\u003cp\u003eEntity entries within an entity type contain a reference value and a set of synonyms that are treated as equivalent in user input.\u003c/p\u003e\n"],["\u003cp\u003eDialogflow CX allows for the automatic generation of synonyms for entity reference values using AI, to simplify the process of defining entity entries.\u003c/p\u003e\n"]]],[],null,["# Entities\n\n*Entity types* are used to control how data from end-user input is extracted.\n\n\u003cbr /\u003e\n\nConversational Agents (Dialogflow CX) provides predefined\n[system entities](/dialogflow/cx/docs/concept/entity-system)\nthat can match many common types of data.\nFor example, there are system entities for matching dates,\ntimes, colors, email addresses, and so on.\nYou can also create your own\n[custom entities](/dialogflow/cx/docs/concept/entity-custom)\nfor matching custom data.\nFor example,\nyou could define a vegetable entity\nthat can match the types of vegetables available\nfor purchase with a grocery store agent.\n\nEntity terminology\n------------------\n\nThe term *entity* is used in this documentation and in the Dialogflow CX console\nto describe the general concept of entities.\nWhen discussing entity details,\nit's important to understand more specific terms:\n\n- **Entity type** :\n Defines the type of information you want to extract from user input.\n For example, *vegetable* could be the display name of an entity type.\n Clicking **Create** from the **Entity Types** section\n of the Dialogflow CX console creates an *entity type* .\n When using the API,\n the term *entity type* refers to the `EntityType` type.\n\n\n Go to the EntityType API reference\n\n **Select a protocol and version for the EntityType reference:**\n\n Close\n\n \u003cbr /\u003e\n\n- **(Optional) Description**: Describes the purpose of the entity type, for\n example \"This entity is triggered when the user mentions a vegetable\". If\n you intend to use AI generation to auto-generate reference value synonyms,\n this field will be used by the model to produce higher-quality results.\n\n- **Entity entry** :\n For each entity type, there can be many *entity entries* . Each entity entry\n provides a set of words or phrases that are considered equivalent, a\n *reference value* in the first column and one or more *synonyms* to that\n reference value in the second column. For example, if *vegetable* is an\n entity type, you could define these entity entries:\n\n Instead of entering entity entries and synonyms manually, you can select\n the **Auto-generate __ syonyms per entity** checkbox when you create a new\n entity entry. The default value is 3 synonyms. The AI will generate synonyms\n based on the reference value and entity type description and enter them in\n the table. Please note that the synonyms list must also include the\n original reference value in order to produce a match to that value.\n\n When editing an entity type from the Dialogflow CX console, each row of the\n display is an *entity entry* . When using the API,\n the term *entity entry* refers to the\n `Entity` type (`EntityType.Entity` or `EntityType_Entity`\n for some client library languages).\n- **Entity reference value and synonyms** :\n Some entity entries have multiple words or phrases\n that are considered equivalent,\n like the *scallion* in previous example.\n For these entity entries, you provide one *reference value*\n and one or more *synonyms*."]]
