Pode criar entidades personalizadas para fazer corresponder dados específicos do seu agente.
Por exemplo, pode definir um tipo de entidade vegetable que pode corresponder aos tipos de vegetais disponíveis para compra com um agente de mercearia.
Crie entidades personalizadas
Para criar uma entidade personalizada:
Consola
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud .
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Tipos de entidades.
- Clique em Criar.
- Introduza os dados da entidade.
- Clique em Guardar.
API
Use o método EntityType's create.
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 |
Limitações
Aplicam-se as seguintes limitações:
- Os nomes a apresentar dos tipos de entidades personalizadas são exclusivos para cada agente.
Os nomes a apresentar dos tipos de entidades devem começar por uma letra e podem conter o seguinte:
A-Z,a-z,0-9,_(sublinhado) e-(traço). Os valores de sinónimos e de referência de entidades não têm essa limitação.
Exporte e importe entidades personalizadas
Pode exportar e importar entidades para partilhar entre agentes.
Uma das opções de formato de exportação é o pacote JSON, que é um ficheiro ZIP que contém uma hierarquia de diretórios e ficheiros JSON. A seguir, é descrita a estrutura do diretório:
entityTypes: este diretório contém os seus tipos de entidades.<entity type name>: Um ou mais destes diretórios existem e os nomes dos diretórios correspondem aos nomes a apresentar dos tipos de entidades.entities: este diretório contém ficheiros de entrada de entidades.<language tag>.json: um ou mais destes ficheiros existem e os nomes dos ficheiros correspondem a etiquetas de idioma. Cada ficheiro contém entradas de entidades específicas do idioma.
<excludedPhrases>: este diretório contém ficheiros com a expressão excluída.<language tag>.json: um ou mais destes ficheiros existem e os nomes dos ficheiros correspondem a etiquetas de idioma. Cada ficheiro contém exclusões de expressões específicas do idioma.
<entity type name>.json: este nome de ficheiro corresponde ao nome a apresentar de um tipo de entidade. O ficheiro contém dados específicos do tipo de entidade que não foram encontrados noutros ficheiros.
Por 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
Quando importa tipos de entidades, podem ocorrer conflitos de união quando o nome a apresentar de um tipo de entidade no seu agente existente corresponde ao de um tipo de entidade importado. Pode controlar o comportamento da união quando os nomes a apresentar dos tipos de entidades correspondem selecionando uma das seguintes opções:
- Substituir tipos de entidades existentes: um tipo de entidade importado substitui qualquer tipo de entidade com o mesmo nome no seu agente existente.
- Unir com tipos de entidades existentes: As entradas de entidades de um tipo de entidade importado são adicionadas ao tipo de entidade existente. Se existirem as mesmas entradas de entidades, estas não são duplicadas e os sinónimos associados são unidos.
- Mudar o nome e importar como novos tipos de entidades: O nome do tipo de entidade importado é alterado adicionando "_1" ao nome a apresentar.
- Ignorar os tipos de entidades: o tipo de entidade existente permanece inalterado e o tipo de entidade importado é ignorado.
Para exportar tipos de entidades:
Consola
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud .
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Tipos de entidades.
- Selecione todos os tipos de entidades que quer exportar.
- Clique em Exportar entidade selecionada.
- Selecione o formato e o destino.
- Clique em Enviar.
Para importar tipos de entidades:
Consola
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud .
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Tipos de entidades.
- Clique em Importar.
- Selecione a origem e o comportamento de união.
- Clique em Enviar.
Importe entradas de entidades
Pode importar entradas de entidades para um tipo de entidade existente.
O formato de ficheiro usado para importar entradas de entidades é o mesmo que o formato usado para importar tipos de entidades. No entanto, o ficheiro de importação só pode conter 1 tipo de entidade, e todas as entradas abaixo deste são importadas para o tipo de entidade selecionado. Se existirem as mesmas entradas de entidades, estas não são duplicadas e os sinónimos associados são unidos.
Para importar entradas de entidades para um tipo de entidade:
Consola
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud .
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Tipos de entidades.
- Selecione uma entidade.
- Clique em Importar para entidade.
- Selecione um ficheiro.
- Clique em Enviar.