Entidades do sistema

O Dialogflow oferece muitas entidades do sistema para extrair tipos comuns de expressões do usuário final. Por exemplo, o tipo @sys.color pode ser usado para extrair valores como "vermelho" ou "azul". Você encontra a lista completa de entidades do sistema na referência de entidades do sistema.

Para a maioria dos aplicativos, os valores fornecidos pelas entidades do sistema funcionam bem. No entanto, talvez seja necessário incluir mais valores para entidades do sistema. Por exemplo, é possível adicionar "azul-verde" à lista de valores de @sys.color. É possível estender algumas entidades do sistema para essa finalidade. A referência de entidade do sistema lista as entidades do sistema que podem ser estendidas. Nas seções restantes deste documento, descrevemos como estender as entidades do sistema.

Onde encontrar esses dados

Ao criar um agente, o mais comum é usar o Console do Dialogflow. Acesse a documentação, abra o Console (em inglês). As instruções abaixo se concentram no uso do Console. Para acessar os dados de entidade do sistema do seu agente:

  1. Acesse o Console do Dialogflow (em inglês).
  2. Selecione um agente.
  3. Selecione Entities no menu da barra lateral à esquerda.
  4. Selecione a guia System de entidades do sistema.

Se você estiver usando a API em vez do Console para criar um agente, consulte a referência de EntityTypes. Os nomes de campo da API são semelhantes aos nomes de campo do Console. As instruções abaixo destacam as diferenças importantes entre o Console e a API.

Estender uma entidade do sistema pela página de entidades

Na página de entidades, você visualiza as entidades do sistema usadas por seu agente, podendo estendê-las seguindo estas etapas:

  1. Use a entidade do sistema em um dos seus parâmetros.
  2. Selecione Entities no menu da barra lateral à esquerda.
  3. Selecione a guia System de entidades do sistema.
  4. As entidades do sistema usadas atualmente pelo seu agente são listadas. Entidades mostradas em cor de fonte cinza não são extensíveis, e entidades mostradas em uma cor de fonte normal são extensíveis.
  5. É possível selecionar uma entidade extensível e atualizar os valores estendidos.
  6. Informe entradas de entidade usando os valores com que você quer estender a entidade.

Captura de tela da guia de entidades do sistema

Estender uma entidade do sistema com a API

Se você estiver usando a API para estender as entidades do sistema, crie extensões de entidade do sistema de forma semelhante ao modo de criar entidades personalizadas. Forneça o nome da entidade do sistema que você pretende estender e forneça os valores com os quais quer estendê-la. Se tentar estender uma entidade do sistema que não seja extensível, você receberá uma mensagem de erro.

Estender uma entidade do sistema ao anotar uma frase de treinamento

Na seção da frase de treinamento da página da intent, é possível estender uma entidade do sistema enquanto anota uma frase de treinamento. Se você anotar manualmente uma parte da frase de treinamento com uma entidade de sistema extensível que não inclui o valor selecionado, será necessário que você adicione esse valor à entidade do sistema.