Entidades

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:

    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 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.