Entidades

Os tipos de entidades são usados para controlar como os dados da entrada do utilizador final são extraídos.

Os agentes conversacionais (Dialogflow CX) fornecem entidades do sistema predefinidas que podem corresponder a muitos tipos de dados comuns. Por exemplo, existem entidades do sistema para fazer corresponder datas, horas, cores, endereços de email, etc. Também pode criar as suas próprias entidades personalizadas para fazer corresponder dados personalizados. Por exemplo, pode definir uma entidade de vegetais que pode corresponder aos tipos de vegetais disponíveis para compra com um agente de mercearia.

Terminologia de entidades

O termo entidade é usado nesta documentação e na consola Dialogflow CX para descrever o conceito geral de entidades. Quando discutir detalhes de entidades, é importante compreender termos mais específicos:

  • Tipo de entidade: Define o tipo de informações que quer extrair da entrada do utilizador. Por exemplo, vegetal pode ser o nome a apresentar de um tipo de entidade. Clicar em Criar na secção Tipos de entidades da consola Dialogflow CX cria um tipo de entidade. Quando 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 EntityType Interface EntityType
    C++ EntityTypesClient Não disponível
    C# EntityTypesClient Não disponível
    Go EntityTypesClient Não disponível
    Java EntityTypesClient EntityTypesClient
    Node.js EntityTypesClient EntityTypesClient
    PHP Não disponível Não disponível
    Python EntityTypesClient EntityTypesClient
    Ruby Não disponível Não disponível

  • (Opcional) Descrição: descreve a finalidade do tipo de entidade, por exemplo, "Esta entidade é acionada quando o utilizador menciona um vegetal". Se pretende usar a geração de IA para gerar automaticamente sinónimos de valores de referência, este campo vai ser usado pelo modelo para produzir resultados de maior qualidade.

  • Entrada de entidade: Para cada tipo de entidade, podem existir muitas entradas de entidades. Cada entrada de entidade fornece um conjunto de palavras ou expressões consideradas equivalentes, um valor de referência na primeira coluna e um ou mais sinónimos desse valor de referência na segunda coluna. Por exemplo, se vegetal for um tipo de entidade, pode definir estas entradas de entidades:

    Valor de referência Sinónimos
    cebolinho cebolinho, cebola verde
    pimento pimento, pimento doce
    cenoura cenoura
    batata batata, batata-doce, tubérculo

    Em vez de introduzir manualmente as entradas de entidades e os sinónimos, pode selecionar a caixa de verificação Gerar automaticamente __ sinónimos por entidade quando cria uma nova entrada de entidade. O valor predefinido é de 3 sinónimos. A IA gera sinónimos com base no valor de referência e na descrição do tipo de entidade e introduz os mesmos na tabela. Tenha em atenção que a lista de sinónimos também tem de incluir o valor de referência original para produzir uma correspondência com esse valor.

    Quando edita um tipo de entidade a partir da consola Dialogflow CX, cada linha do ecrã é uma entrada de entidade. Quando usar a API, o termo entrada de entidade refere-se ao tipo Entity (EntityType.Entity ou EntityType_Entity para alguns idiomas da biblioteca cliente).

  • Valor de referência da entidade e sinónimos: Algumas entradas de entidades têm várias palavras ou expressões que são consideradas equivalentes, como a cebolinha no exemplo anterior. Para estas entradas de entidades, fornece um valor de referência e um ou mais sinónimos.