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.
- 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 EntityType | Recurso 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 los 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 entrada 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 entidad específicas para cada lenguaje.
<excludedPhrases>: Este directorio contiene frase excluida archivos.<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 de 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 no se encuentra 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 importes tipos de entidades, puede haber conflictos de combinación cuando el nombre visible de un de entidad en tu agente existente coincide con el de un tipo de entidad importado. Puedes controlar el comportamiento de combinación cuando coinciden los nombres visibles de los tipos de entidades. seleccionando una de las siguientes opciones:
- Reemplazar tipos de entidades existentes: Un tipo de entidad importado reemplaza cualquier con el mismo nombre en tu agente existente.
- Combina con tipos de entidades existentes: Las entradas de entidad de un tipo de entidad importado se agregan a la entidad existente. el tipo de letra. Si existen las mismas entradas de entidad, no se duplicarán, y los sinónimos debajo de ellos se combinarán.
- Cambia el nombre y, luego, impórtalo como tipos de entidades nuevos: Se cambia el nombre del tipo de entidad importado agregando "_1". al nombre visible.
- Omite los tipos de entidades: El tipo de entidad existente no se modifica y se ignora el tipo de entidad importado.
Para exportar tipos de entidades, sigue estos pasos:
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.
Sigue estos pasos para importar tipos de entidades:
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.
- Haga clic en Import.
- Selecciona la fuente y el comportamiento de 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 utilizado para importar entradas de entidad es el mismo que el formato usarse para importar tipos de entidades. Sin embargo, el archivo de importación solo puede contener 1 el tipo de entidad y todas sus entradas se importarán a la entidad seleccionada el tipo de letra. Si existen las mismas entradas de entidad, no se duplicarán, y los sinónimos debajo de ellos se combinarán.
Sigue estos pasos a fin de importar entradas de entidad para un tipo de entidad:
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.