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 Google Cloud proyecto.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Tipos de entidades.
- Haga clic en Crear.
- Ingresa los datos de la entidad.
- Haga clic en Save.
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 de EntityType | Recurso de EntityType |
| RPC | Interfaz EntityType | Interfaz 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 |
| Ruby | 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 compartirlas 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>: Existen uno o más de estos directorios, y los nombres de los directorios corresponden a los nombres visibles de los tipos de entidades.entities: Este directorio contiene archivos de entradas de entidades.<language tag>.json: 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 entidades específicas del idioma.
<excludedPhrases>: Este directorio contiene archivos de frases excluidas.<language tag>.json: 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 del idioma.
<entity type name>.json: Este nombre de archivo corresponde a un nombre visible de 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. Para controlar el comportamiento de combinación cuando coinciden los nombres visibles de los tipos de entidades, selecciona 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 los tipos de entidades existentes: Las entradas de entidad de un tipo de entidad importado se agregan al tipo de entidad existente existente. Si existen las mismas entradas de entidad, no se duplicarán y los sinónimos que se encuentren debajo se combinarán.
- Cambiar el nombre e importar como tipos de entidades nuevos: Se cambia el nombre del tipo de entidad importado agregando "_1" al nombre visible.
- Omitir los tipos de entidades: El tipo de entidad existente permanece sin cambios, y se ignora el tipo de entidad importado.
Para exportar tipos de entidades, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Elige tu Google Cloud proyecto.
- 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 Google Cloud proyecto.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Tipos de entidades.
- Haz clic en Importar.
- Selecciona la fuente y el comportamiento de combinación.
- Haz clic en Enviar.
Importa 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 entidad es el mismo que el 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 se encuentren debajo se importarán al tipo de entidad seleccionado. Si existen las mismas entradas de entidad, no se duplicarán y los sinónimos que se encuentren debajo se combinarán.
Para importar entradas de entidad para un tipo de entidad, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Elige tu Google Cloud proyecto.
- 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.