En esta página, se describen las apps y los almacenes de datos de Agent Search.
Con Agent Search, creas una app de búsqueda o recomendaciones y la conectas a un almacén de datos. Un proyecto de Google Cloud puede contener múltiples apps.
Relación entre las apps y los almacenes de datos
La relación entre las apps y los almacenes de datos depende del tipo de app:
Las apps de búsqueda personalizada tienen una relación de varios a varios con los almacenes de datos. Cuando se conectan varios almacenes de datos a una sola app de búsqueda personalizada, esto se denomina búsqueda combinada. Para obtener información sobre las limitaciones de conectar una app de búsqueda a más de un almacén de datos, consulta Acerca de la búsqueda combinada.
Una app de recomendaciones personalizada tiene una conexión uno a uno con su almacén de datos.
Una app de medios tiene una relación de varios a uno con su almacén de datos. Una app solo puede conectarse a un almacén de datos, mientras que un almacén de datos puede conectarse a varias apps. Por ejemplo, una app de búsqueda de contenido multimedia y una app de recomendaciones de contenido multimedia pueden compartir un almacén de datos.
Una app de búsqueda de servicios de salud tiene una relación de varios a uno con su almacén de datos. Una app solo puede conectarse a un almacén de datos, mientras que un almacén de datos puede conectarse a varias apps. Por ejemplo, una app orientada al paciente y una app orientada al proveedor pueden conectarse al mismo almacén de datos.
Para una importación de datos por lotes de datos de atención médica, los datos se importan a un almacén de datos que se encuentra dentro de una app. Para la importación de datos de transmisión (versión preliminar) de datos de atención médica, los datos se importan a una entidad, que es un tipo de almacén de datos que se encuentra dentro de un conector de datos. Un conector de datos también es un tipo de almacén de datos que se encuentra dentro de una app.
Después de que un almacén de datos se conecta a una app, no se puede desconectar.
Método de creación de apps y transferencia de datos
La forma en que creas una app y transfieres datos depende del tipo de datos que tengas:
Para los datos del sitio web, puedes usar la consola de Google Cloud o la API. Para usar los datos de un sitio web creados con la API, debes adjuntarlos a una app con las funciones de Enterprise habilitadas en la consola de Google Cloud .
Para los datos estructurados o no estructurados, puedes usar la consola deGoogle Cloud o la API.
Para los datos de atención médica, puedes usar la consola de Google Cloud o la API.
Documentos
Cada almacén de datos tiene uno o más registros de datos, llamados documentos. Lo que un documento representa varía según el tipo de datos en el almacén de datos:
Sitio web. Un documento es una página web.
Datos estructurados. Un documento es una fila en una tabla o un registro JSON que sigue un esquema en particular. Puedes especificar este esquema o dejar que Agent Search lo defina a partir de los datos transferidos.
Datos estructurados para contenido multimedia. Un documento es una fila en una tabla o un registro JSON que sigue un esquema específico para el contenido multimedia. Los documentos son registros relacionados con el contenido multimedia, como videos, artículos de noticias, archivos de música y podcasts. Un documento contiene información que describe el elemento multimedia, como mínimo: título, URI de la ubicación del contenido, categorías, duración y fecha de disponibilidad.
Datos no estructurados. Un documento es un archivo en cualquiera de los siguientes formatos: TXT, PDF, HTML, DOCX, PPTX, XLSX y XLSM.
Datos de FHIR de atención médica. Un documento es un recurso FHIR R4 compatible. Para obtener una lista de los recursos de FHIR R4 que admite la búsqueda de agentes, consulta Referencia del esquema de datos de FHIR R4 de atención médica.
Operaciones CRUD en almacenes de datos
En el caso de los almacenes de datos estructurados y no estructurados, la Búsqueda de agentes admite operaciones de creación, lectura, actualización y eliminación (CRUD) en los datos de los documentos. No es necesario borrar ni volver a crear un almacén de datos completo para actualizar tu contenido. Puedes administrar registros individuales durante su ciclo de vida.
Puedes administrar documentos o registros individuales en un almacén de datos con la API:
- Crear: Agrega documentos individuales a una rama del almacén de datos con el
método
documents.create. - Lectura (obtención y lista): Recupera un documento específico por su ID con el
método
documents.geto enumera los documentos de una rama con el métododocuments.list. - Actualizar: Modifica los campos, el contenido o los metadatos de un documento existente con el método
documents.patch. También puedes realizar una actualización o inserción (insertar si no se encuentra) configurando el campoallowMissingcomotrue. - Borrado selectivo: Borra de forma selectiva registros individuales con el método
documents.delete, en lugar de borrar todo el almacén de datos.
Almacenes de datos y apps
En Agent Search, hay varios tipos de almacenes de datos. Un almacén de datos puede contener solo un tipo de datos.
- Datos del sitio web
- Datos estructurados
- Contenido estructurado (contenido multimedia)
- Datos no estructurados
- Datos de FHIR de atención médica
Datos de sitio web
Un almacén de datos con datos de sitios web usa datos indexados de sitios web públicos. Puedes proporcionar un conjunto de patrones de URL que quieras incluir en tu almacén de datos. Las páginas web que se ajustan a los patrones de URL se denominan páginas web incluidas. Luego, puedes configurar la búsqueda en los datos rastreados de las páginas web incluidas.
Por ejemplo, puedes proporcionar patrones de URL, como example.com/faq/*
y example.com/events/*, y habilitar la búsqueda en
los datos rastreados de estas páginas web que se ajustan al patrón. Estos datos incluyen
texto, imágenes etiquetadas con metadatos y otros datos estructurados, como etiquetas meta,
atributos de PageMap y datos de schema.org.
También puedes proporcionar patrones de URL para partes de sitios web que quieras
excluir, por ejemplo, example.com/events/members-only/* o
example.com/events/past-*. Las URLs excluidas tienen prioridad sobre las incluidas.
Existen dos tipos de almacenes de datos de sitios web:
Búsqueda básica en sitios web:
- Proporciona capacidades de búsqueda en el índice existente de la Búsqueda de Google para los sitios web incluidos.
- No requiere verificación de dominio.
Indexación avanzada de sitios web:
- Proporciona funciones de búsqueda avanzada en un índice que se genera en función de cualquiera de las siguientes opciones:
- Los propietarios de la app de Agent Search pueden controlar qué páginas web se indexan enviando mapas del sitio y manteniéndolos. Para obtener más información, consulta Indexa y actualiza páginas web con mapas del sitio. Este proceso mantiene el índice actualizado sin intervención manual.
- Los propietarios de la app de Agent Search pueden realizar una indexación inicial que refleje el índice de la Búsqueda de Google y, luego, expandir la cobertura del índice volviendo a rastrear los sitios web cuando sea necesario para mantenerlo actualizado. Para obtener más información, consulta Actualiza páginas web. Las funciones avanzadas de la indexación avanzada de sitios web se enumeran en Indexación avanzada de sitios web.
- Requiere que los propietarios de los almacenes de datos de Agent Search verifiquen los dominios a los que pertenecen los sitios web incluidos. Para obtener más información, consulta Cómo verificar dominios de sitios web.
- Proporciona la capacidad de agregar datos estructurados al esquema del almacén de datos.
Un sitio web contiene datos no estructurados, pero puedes agregar datos estructurados en forma de etiquetas
meta, atributos de PageMap y datos de schema.org a tus páginas web. Luego, puedes usar estos datos estructurados para editar el esquema del almacén de datos, como se explica en Usa datos estructurados para la indexación avanzada de sitios web.
- Proporciona funciones de búsqueda avanzada en un índice que se genera en función de cualquiera de las siguientes opciones:
¿Qué sigue?
Para la búsqueda en el sitio web, haz lo siguiente:
- Para comprender los requisitos previos de la indexación, consulta cómo preparar datos para la búsqueda en sitios web.
- Crea un almacén de datos con el contenido del sitio web.
- Crea una app de búsqueda.
Datos estructurados
Un almacén de datos con datos estructurados habilita la búsqueda semántica o las recomendaciones sobre datos estructurados. Puedes importar datos de BigQuery o Cloud Storage. También puedes subir datos JSON estructurados de forma manual a través de la API.
Por ejemplo, puedes habilitar la búsqueda o las recomendaciones en un catálogo de productos para tu experiencia de comercio electrónico o un directorio de médicos para la búsqueda o las recomendaciones de proveedores.
Agent Search detecta automáticamente el esquema de los datos que importas. De manera opcional, puedes proporcionar un esquema para tus datos. Por lo general, proporcionar un esquema para tus datos mejora la calidad de los resultados.
¿Qué sigue?
Para la búsqueda personalizada, haz lo siguiente:
- Prepara datos estructurados para la transferencia.
- Crea un almacén de datos de búsqueda con uno de estos métodos:
- Crea una app de búsqueda.
Para las recomendaciones personalizadas, haz lo siguiente:
- Crea un almacén de datos de recomendaciones personalizado.
- Crea una app de recomendaciones personalizada.
Datos estructurados para medios
Las apps de contenido multimedia solo se pueden conectar a almacenes de datos de contenido multimedia. Los almacenes de datos multimedia son almacenes de datos estructurados con un esquema definido por Google o con tu propio esquema personalizado que contiene un conjunto específico de cinco campos relacionados con el contenido multimedia. Para obtener más información sobre el esquema, consulta Acerca de los documentos multimedia y los almacenes de datos.
Por ejemplo, puedes habilitar las recomendaciones creando una app de recomendaciones de contenido multimedia para un catálogo de películas o un sitio de noticias, de modo que tus usuarios tengan sugerencias adecuadas y personalizadas para ellos.
Además de los documentos multimedia, los almacenes de datos multimedia también contienen la información de eventos de usuario que permite que Agent Search personalice las recomendaciones y la búsqueda para tus usuarios. Los eventos de usuario son obligatorios para las apps de contenido multimedia. Para obtener información sobre los eventos de usuario, consulta Registra eventos de usuario en tiempo real.
¿Qué sigue?
Datos no estructurados
Un almacén de datos no estructurados permite la búsqueda semántica en datos, como documentos e imágenes.
Los almacenes de datos no estructurados admiten documentos en los formatos TXT, PDF, HTML, DOCX, PPTX, XLSX y XLSM.
La búsqueda proporciona resultados en forma de 10 URLs y respuestas resumidas para las consultas en lenguaje natural. Los documentos se deben subir a un bucket de Cloud Storage con los permisos de acceso adecuados. Por ejemplo, una institución financiera puede habilitar la búsqueda en su corpus privado de publicaciones de investigación financiera, o una empresa de biotecnología puede habilitar la búsqueda o las recomendaciones en su repositorio privado de investigación médica.
¿Qué sigue?
Para la búsqueda:
- Prepara datos no estructurados para la transferencia.
- Crea un almacén de datos de búsqueda con uno de estos métodos:
- Crea un almacén de datos de búsqueda para tus datos no estructurados.
- Crea una app de búsqueda.
Datos de FHIR de servicios de salud
Una app de búsqueda de atención médica usa datos de FHIR R4 importados de un almacén de FHIR de la API de Cloud Healthcare. Para obtener una lista de los recursos de FHIR R4 que admite la búsqueda de agentes, consulta la referencia del esquema de datos de FHIR R4 de atención médica. Un almacén de datos de FHIR R4 debe cumplir con algunos requisitos antes de que pueda utilizarse como fuente de datos para el almacén de datos de Agent Search. Para obtener más información, consulta cómo preparar los datos de FHIR de atención médica para la transferencia.
¿Qué sigue?
- Prepara los datos de FHIR R4 para la transferencia.
- Crea un almacén de datos de búsqueda de atención médica.
- Crea una app de búsqueda de servicios de salud.
Acerca de la búsqueda combinada
Puedes crear una app de búsqueda combinada, en la que se pueden conectar varios almacenes de datos a una sola app de búsqueda personalizada. Esta función te permite usar una app para buscar en varias fuentes y tipos de datos.
Para crear una app de búsqueda combinada, selecciona varios almacenes de datos cuando crees una app de búsqueda personalizada nueva. Si no seleccionas varios almacenes de datos durante la creación, no podrás agregar almacenes de datos adicionales más adelante.
Cuando obtienes resultados de la búsqueda, puedes buscar en todos los almacenes de datos o filtrar los resultados de un solo almacén de datos.
Se aplica la siguiente limitación:
- Agrega y quita almacenes de datos:
- Para activar la búsqueda combinada en una app, debes conectarle al menos dos almacenes de datos durante su creación.
- Puedes agregar o quitar almacenes de datos de una app de búsqueda combinada, pero la app no puede tener menos de dos almacenes de datos conectados en ningún momento.
- Si conectas un solo almacén de datos a una app de búsqueda durante la creación de la app, no podrás agregar ni quitar ese almacén de datos.
- Los almacenes de datos de sitios web deben tener activada la indexación avanzada de sitios web para poder usarse en la búsqueda combinada. Para obtener más información, consulta Indexación avanzada de sitios web.
- No se admiten los almacenes de datos que contienen datos no estructurados importados con BigQuery.
- No se admite la búsqueda de imágenes (con el campo
paramsconsearchType: 1). - La búsqueda combinada permite los siguientes campos en las
solicitudes de búsqueda:
boostSpeccontentSearchSpecdataStoreSpecsfacetSpecsfilterlanguageCodeoffsetoneBoxPageSizeorderByquerypageSizepageTokenrelevanceScoreSpecrelevanceThresholdsessionsessionSpecspellCorrectionSpecuserInfouserPseudoId
- La búsqueda combinada permite los siguientes campos en
DataStoreSpec:dataStoreboostSpec: Si se especifican especificaciones de aumento paraSearchRequestydataStoreSpecs, ambas se aplican a los resultados de la búsqueda.filter: Si se especifican filtros paraSearchRequestydataStoreSpecs, ambos se aplican a los resultados de la búsqueda.
- Las operaciones de creación, lectura, actualización y eliminación (CRUD) en los parámetros de configuración de entrega son
compatibles con las apps combinadas. Solo se pueden agregar o actualizar los siguientes campos
en una configuración de entrega:
boostControlIdsdisplayNamefilterControlIdsgenericConfig:contentSearchSpec
namesolutionTypesynonymsControlIds
- Las operaciones CRUD en los siguientes controles son compatibles con las apps de búsqueda combinada:
boostActionsynonymActionfilterAction
- Hay un límite de 50 almacenes de datos por app de búsqueda.
- Si un almacén de datos usa una configuración de CMEK, todos los demás almacenes de datos también deben usar la misma configuración de CMEK.