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:
Protocolo V3 V3beta1 REST Recurso EntityType Recurso EntityType RPC Interface de EntityType Interface de EntityType C++ EntityTypesClient Indisponível C# EntityTypesClient Indisponível Go EntityTypesClient Indisponível Java EntityTypesClient EntityTypesClient Node.js EntityTypesClient EntityTypesClient PHP Indisponível Indisponível Python EntityTypesClient EntityTypesClient Ruby Indisponível Indisponível 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 gerar 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
ouEntityType_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.