É 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 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 |
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 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: este 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 do idioma.
<excludedPhrases>: este diretório contém arquivos de frase excluída.<language tag>.json: um ou mais desses arquivos existem e os nomes dos arquivos correspondem a 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 que não sã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 corresponder 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 entidade 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 abaixo delas serão mesclados.
- Renomear e importar como novos tipos de entidade: o tipo de entidade importado é renomeado anexando "_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 a origem e o comportamento de mesclagem.
- Clique em Enviar.
Importar entradas de entidade
É possível importar entradas de entidade para um tipo de entidade.
O formato de 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 um tipo de entidade, e todas as entradas abaixo dele 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 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.