Puedes crear entidades personalizadas para que coincidan con datos específicos de tu agente.
Por ejemplo, puedes definir un vegetabletipo de entidad que pueda coincidir con los tipos de verduras que se pueden comprar con un agente de una tienda de comestibles.
Crear entidades personalizadas
Para crear una entidad personalizada, siga estos pasos:
Consola
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud .
- Selecciona tu agente.
- Selecciona la pestaña Gestionar.
- Haga clic en Tipos de entidad.
- Haz clic en Crear.
- Introduce 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 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 aplican las siguientes limitaciones:
- Los nombres visibles de los tipos de entidades personalizadas son únicos para cada agente.
Los nombres visibles de los tipos de entidad deben empezar por una letra y pueden contener los siguientes caracteres:
A-Z,a-z,0-9,_(guion bajo) y-(guion). Las referencias a entidades y los valores de sinónimos no tienen esta limitación.
Exportar e importar entidades personalizadas
Puede exportar e importar 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 entidad.<entity type name>: Uno o varios de estos directorios existen y los nombres de los directorios corresponden a los nombres visibles de los tipos de entidad.entities: este directorio contiene archivos de entrada de entidades.<language tag>.json: uno o varios de estos archivos existen y los nombres de los archivos corresponden a etiquetas de idioma. Cada archivo contiene entradas de entidades específicas de un idioma.
<excludedPhrases>: este directorio contiene archivos con la frase excluida.<language tag>.json: uno o varios de estos archivos existen y los nombres de los archivos corresponden a etiquetas de idioma. Cada archivo contiene exclusiones de frases específicas de un 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
Al importar tipos de entidades, pueden producirse conflictos de combinación si el nombre visible de un tipo de entidad de tu agente coincide con el de un tipo de entidad importado. Puede controlar el comportamiento de la combinación cuando los nombres visibles de los tipos de entidad coincidan seleccionando una de las siguientes opciones:
- Sustituir tipos de entidades: un tipo de entidad importado sobrescribe cualquier tipo de entidad con el mismo nombre en tu agente.
- Combinar con los tipos de entidad que ya existen: las entradas de entidad de un tipo de entidad importado se añaden al tipo de entidad que ya existe. Si existen las mismas entradas de entidad, no se duplicarán y los sinónimos que contengan se combinarán.
- Cambiar el nombre e importar como nuevos tipos de entidad: se cambia el nombre del tipo de entidad importado añadiendo "_1" al nombre visible.
- Omitir los tipos de entidad: El tipo de entidad actual no cambia y el tipo de entidad importado se ignora.
Para exportar tipos de entidades, sigue estos pasos:
Consola
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud .
- Selecciona tu agente.
- Selecciona la pestaña Gestionar.
- Haga clic en Tipos de entidad.
- Selecciona todos los tipos de entidad que quieras exportar.
- Haz clic en Exportar entidad seleccionada.
- Selecciona el formato y el destino.
- Haz clic en Enviar.
Para importar tipos de entidades, sigue estos pasos:
Consola
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud .
- Selecciona tu agente.
- Selecciona la pestaña Gestionar.
- Haga clic en Tipos de entidad.
- Haz clic en Importar.
- Selecciona la fuente y el comportamiento de combinación.
- Haz clic en Enviar.
Importar entradas de entidad
Puede importar entradas de entidad a un tipo de entidad que ya tenga.
El formato de archivo que se usa para importar entradas de entidades es el mismo que el que se usa para importar tipos de entidades. Sin embargo, el archivo de importación solo puede contener un tipo de entidad y todas las entradas que haya en él se importarán al tipo de entidad seleccionado. Si existen las mismas entradas de entidad, no se duplicarán y los sinónimos que contengan se combinarán.
Para importar entradas de entidad de un tipo de entidad, siga estos pasos:
Consola
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud .
- Selecciona tu agente.
- Selecciona la pestaña Gestionar.
- Haga clic en Tipos de entidad.
- Selecciona una entidad.
- Haz clic en Importar a entidad.
- Selecciona un archivo.
- Haz clic en Enviar.