Puedes crear entidades personalizadas para los datos de coincidencia específicos de tu agente.
Por ejemplo, podrías definir un tipo de entidad vegetable (verdura) que detecte coincidencias con los tipos de verduras que se pueden comprar mediante un agente de supermercado.
Crea entidades personalizadas
Para crear una entidad personalizada, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Tipos de entidades.
- Haz clic en Crear.
- Ingresa los datos de la entidad.
- Haz clic en Guardar.
API
Usa el método create de EntityType.
Selecciona un protocolo y una versión para la referencia de EntityType:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso EntityType | Recurso EntityType |
| RPC | Interfaz de EntityType | Interfaz de EntityType |
| C++ | EntityTypesClient | No disponible |
| C# | EntityTypesClient | No disponible |
| Go | EntityTypesClient | No disponible |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | No disponible | No disponible |
| Python | EntityTypesClient | EntityTypesClient |
| Rita | No disponible | No disponible |
Limitaciones
Se aplica la siguiente limitación:
- Los nombres visibles de los tipos de entidades personalizadas son únicos para cada agente.
Además, deben comenzar con una letra y pueden contener lo siguiente:
A-Z,a-z,0-9,_(guion bajo),-(guion). Los valores de referencia y sinónimo de entidad no tienen esa limitación.
Importa y exporta entidades personalizadas
Puedes importar y exportar entidades para compartir entre agentes.
Una de las opciones de formato de exportación es el paquete JSON, que es un archivo ZIP que contiene una jerarquía de directorios y archivos JSON. A continuación, se describe la estructura del directorio:
entityTypes: Este directorio contiene tus tipos de entidades.<entity type name>: Ya existen uno o más de estos directorios, y los nombres de directorios corresponden a los nombres visibles de los tipos de entidades.entities: Este directorio contiene archivos de entrada de entidades.<language tag>.json: Ya existen uno o más de estos archivos, y los nombres de los archivos corresponden a las etiquetas de idioma. Cada archivo contiene entradas de entidad específicas para cada idioma.
<excludedPhrases>: Este directorio contiene archivos de frases excluidas.<language tag>.json: Ya existen uno o más de estos archivos, y los nombres de los archivos corresponden a las etiquetas de idioma. Cada archivo contiene exclusiones de frases específicas para cada idioma.
<entity type name>.json: Este nombre de archivo corresponde al nombre visible de un tipo de entidad. El archivo contiene datos específicos del tipo de entidad que no se encuentran en otros archivos.
Por ejemplo:
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
Cuando importas tipos de entidades, puede haber conflictos de combinación cuando el nombre visible de un tipo de entidad en tu agente existente coincide con el de un tipo de entidad importado. Puedes controlar el comportamiento de combinación cuando los nombres visibles de los tipos de entidades coinciden seleccionando una de las siguientes opciones:
- Reemplazar los tipos de entidades existentes: Un tipo de entidad importado reemplaza cualquier tipo de entidad con el mismo nombre en tu agente existente.
- Combinar con tipos de entidades existentes: Las entradas de entidad de un tipo de entidad importado se agregan al tipo de entidad existente. Si existen las mismas entradas de entidad, no se duplicarán y se combinarán sus sinónimos.
- Importar y cambiar el nombre como tipos de entidades nuevos: Se agrega "_1" al nombre visible para el tipo de entidad importado.
- Omite los tipos de entidades: El tipo de entidad existente no se modifica y el tipo de entidad importado se ignora.
Para exportar tipos de entidades, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Tipos de entidades.
- Selecciona todos los tipos de entidades que deseas exportar.
- Haz clic en Exportar entidad seleccionada.
- Selecciona el formato y el destino.
- Haz clic en Enviar.
Para importar tipos de entidades, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Tipos de entidades.
- Haz clic en Importar.
- Selecciona el comportamiento de fuente y combinación.
- Haz clic en Enviar.
Importar entradas de entidad
Puedes importar entradas de entidad a un tipo de entidad existente.
El formato de archivo que se usa para importar entradas de entidades es el mismo que se usa para importar tipos de entidades. Sin embargo, el archivo de importación solo puede contener 1 tipo de entidad y todas las entradas que contenga se importarán al tipo de entidad seleccionado. Si existen las mismas entradas de entidad, no se duplicarán y se combinarán sus sinónimos.
Si deseas importar entradas de entidad para un tipo de entidad, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Tipos de entidades.
- Selecciona una entidad.
- Haz clic en Importar a la entidad.
- Selecciona un archivo.
- Haz clic en Enviar.