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 de EntityType | Recurso de 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 |
| 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.
Cómo importar y exportar entidades personalizadas
Puedes 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 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 etiquetas de idioma. Cada archivo contiene entradas de entidades específicas para cada idioma.
<excludedPhrases>: Este directorio contiene archivos de frase excluida.<language tag>.json: Existen uno o más de estos archivos, y los nombres de los archivos corresponden a 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. Para controlar el comportamiento de combinación cuando los nombres visibles de los tipos de entidades coinciden, selecciona una de las siguientes opciones:
- Reemplaza 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 los sinónimos debajo de ellas.
- Cambiar el nombre y la importación como tipos de entidades nuevos: Para cambiar el nombre del tipo de entidad importada, agrega "_1" al nombre visible.
- Omitir los tipos de entidades: El tipo de entidad existente no se modifica y se ignora el tipo de entidad importada.
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 quieras 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.
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 entidades 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 de él se importarán al tipo de entidad seleccionado. Si existen las mismas entradas de entidad, no se duplicarán y se combinarán los sinónimos debajo de ellas.
Sigue estos pasos para 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.