É 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 compartilhamento 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. Confira a seguir a descrição da estrutura de diretórios:
entityTypes: este diretório contém os tipos de entidade.<entity type name>: existe um ou mais desses diretórios. e os nomes dos diretórios correspondem aos nomes de exibição dos tipos de entidade.entities: esse diretório contém arquivos de entrada de entidade.<language tag>.json: existem um ou mais destes arquivos, 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 frase excluída .<language tag>.json: existem um ou mais destes arquivos, e os nomes dos arquivos correspondem às tags de idioma. Cada arquivo contém exclusões de frases específicas do idioma.
<entity type name>.json: este 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 encontrado 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, poderá haver conflitos de mesclagem quando o nome de exibição de um tipo de entidade em seu agente existente corresponde ao de um tipo de entidade importado. Você pode 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 à entidade atual. não é válido. Se as mesmas entradas de entidade existirem, elas não serão duplicadas. e os sinônimos abaixo deles serão mesclados.
- Renomear e importar como novos tipos de entidade: O tipo de entidade importado é renomeado com a adição de "_1" ao nome de exibição.
- Ignore 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 é igual ao formato usada para importar tipos de entidade. No entanto, o arquivo de importação só pode conter 1 tipo de entidade, e todas as suas entradas serão importadas para a entidade selecionada não é válido. Se as mesmas entradas de entidade existirem, elas não serão duplicadas. e os sinônimos abaixo deles 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 Import to entity.
- Selecione um arquivo.
- Clique em Enviar.