É possível criar entidades personalizadas para dados de correspondência específicos ao seu agente.
Por exemplo, defina um tipo de entidade vegetable que corresponda aos tipos de vegetais disponíveis para compra em um agente de mercearia.
Criar entidades personalizadas
Para criar uma entidade personalizada:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Tipos de entidade.
- Clique em Criar.
- Insira os dados da entidade.
- Clique em Save.
API
Use o método create do 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 | 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 |
Limitações
Considere as seguintes limitações:
- Os nomes de exibição dos tipos de entidade personalizados são exclusivos para cada agente.
Os nomes de exibição do tipo de entidade precisam começar com uma letra e podem conter o seguinte:
A-Z,a-z,0-9,_(sublinhado),-(traço). Os valores de referência de entidade e sinônimos não têm essa limitação.
Exportar e importar entidades personalizadas
É possível exportar e importar entidades para compartilhar entre agentes.
Uma das opções de formato de exportação é o pacote Json, que é um arquivo ZIP que contém uma hierarquia de diretórios e arquivos JSON. Veja a seguir a descrição da estrutura de diretórios:
entityTypes: esse diretório contém os tipos de entidade.<entity type name>: um ou mais desses diretórios existem, e os nomes deles correspondem aos nomes de exibição do tipo de entidade.entities: esse diretório contém arquivos de entrada de entidade.<language tag>.json: um ou mais desses arquivos existem, e os nomes dos arquivos correspondem às tags de idioma. Cada arquivo contém entradas de entidade específicas da linguagem.
<excludedPhrases>: esse diretório contém arquivos de frases excluídas.<language tag>.json: um ou mais desses arquivos existem, e os nomes dos arquivos correspondem às tags de idioma. Cada arquivo contém exclusões de frases específicas para o idioma.
<entity type name>.json: esse nome de arquivo corresponde a um nome de exibição de tipo de entidade. O arquivo contém dados específicos do tipo de entidade não encontrados em outros arquivos.
Exemplo:
entityTypes ⤷ Entity Type A ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type A.json ⤷ Entity Type B ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type B.json
Ao importar tipos de entidade, pode haver conflitos de mesclagem quando o nome de exibição de um tipo de entidade no agente atual corresponde ao de um tipo de entidade importado. É possível controlar o comportamento de mesclagem quando os nomes de exibição do tipo de entidade correspondem selecionando uma das seguintes opções:
- Substituir tipos de entidade existentes: um tipo de entidade importado substitui qualquer tipo de entidade com o mesmo nome no agente atual.
- Mesclar com tipos de entidade atuais: as entradas de um tipo de entidade importado são adicionadas ao tipo de entidade atual. Se as mesmas entradas de entidade existirem, elas não serão duplicadas, e os sinônimos nelas serão mesclados.
- Renomear e importar como novos tipos de entidade: o tipo de entidade importado é renomeado adicionando "_1" ao nome de exibição.
- Ignorar os tipos de entidade: o tipo de entidade atual permanece inalterado, e o tipo de entidade importado é ignorado.
Para exportar tipos de entidade:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Tipos de entidade.
- Selecione todos os tipos de entidade que você quer exportar.
- Clique em Exportar entidade selecionada.
- Selecione o formato e o destino.
- Clique em Enviar.
Para importar tipos de entidade:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Tipos de entidade.
- Clique em Importar.
- Selecione o comportamento de origem e mesclagem.
- Clique em Enviar.
Importar entradas de entidade
É possível importar entradas de entidade para um tipo de entidade atual.
O formato do arquivo usado para importar entradas de entidade é o mesmo usado para importar tipos de entidade. No entanto, o arquivo de importação pode conter apenas um tipo de entidade, e todas as entradas nele serão importadas para o tipo de entidade selecionado. Se as mesmas entradas de entidade existirem, elas não serão duplicadas, e os sinônimos nelas serão mesclados.
Para importar entradas de entidade para um tipo de entidade:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Tipos de entidade.
- Selecione uma entidade.
- Clique em Importar para entidade.
- Selecione um arquivo.
- Clique em Enviar.