Si es la primera vez que usas Agent Search, te recomendamos que sigas el tutorial Comienza a usar la búsqueda personalizada para crear una app de ejemplo.
Configura un Google Cloud proyecto, activa Agent Search y configura el control de acceso para tu proyecto. Puedes usar un proyecto existente Google Cloud si ya tienes uno.
Acciones
- Revisa Antes de comenzar y confirma que completaste los pasos.
Determina qué tipo de datos estará disponible en tu app de búsqueda y prepáralos para importarlos a Agent Search.
Puedes basar tu almacén de datos en los siguientes tipos de datos:
- Datos no estructurados: Documentos (como archivos PDF, HTML y TXT) que se almacenan en Cloud Storage. De manera opcional, puedes proporcionar metadatos en un archivo JSON o en una tabla de BigQuery.
- Datos estructurados: Datos proporcionados con un esquema específico. Por ejemplo, puedes proporcionar datos en una tabla de BigQuery, como archivos JSON en Cloud Storage o desde conectores de terceros, como Jira.
Acciones
Revisa la información sobre los datos admitidos y la relación entre las apps y los almacenes de datos en Acerca de las apps y los datos almacenes.
Prepara tus datos según los requisitos que se indican en Prepara los datos para la transferencia.
Si necesitas configurar el control de acceso para limitar los datos que los usuarios pueden ver en los resultados de la app de búsqueda, revisa los requisitos previos y sigue las instrucciones para tu tipo de proveedor de identidad y fuente de datos en Usa el control de acceso a la fuente de datos.
Crea un almacén de datos y, luego, importa tus datos a él, o configura un conector de terceros como tu fuente de datos sincronizada.
La forma en que importas tus datos depende de dónde los importes. Por ejemplo, si tus datos están en Cloud Storage, puedes importarlos con la consola o la API proporcionando la ubicación del bucket de tus datos.
Acciones
- Sigue las instrucciones para tu fuente de datos en Crea un almacén de datos de búsqueda.
Crea tu app de búsqueda personalizada y conéctala a tu nuevo almacén de datos.
Acciones
Agent Search para la búsqueda personalizada admite dos modelos de precios:
- General: Un modelo basado en el consumo de pago por uso.
- Configurable: Un modelo de precios mixtos que te permite desagregar capacidades y crear un paquete de suscripción que se alinee más con tus casos de uso específicos. Este modelo de precios te permite pagar solo por las funciones que necesitas y aprovechar sus potentes capacidades. Ofrece dos suscripciones y complementos opcionales. Después de habilitar este modelo de precios a nivel del proyecto, puedes seleccionar precios configurables para tus apps y almacenes de datos.
Acciones
De forma predeterminada, un proyecto se establece en el modelo de pago por uso. Sin embargo, para cambiar a los precios configurables, haz lo siguiente:
- Sigue las instrucciones para configurar los precios configurables para la búsqueda personalizada.
Agent Search proporciona muchas opciones de configuración. Algunas opciones dependen de si planeas implementar un widget de búsqueda.
Acciones
Según tu caso de uso y si planeas implementar el widget de búsqueda listo para usar o integrar llamadas a la API de búsqueda en tu propio código, Agent Search proporciona varias opciones de configuración.
Puedes incorporar un widget de búsqueda en tu sitio web. El widget proporciona automáticamente una barra de búsqueda y una interfaz de búsqueda expandible. Si planeas implementar el widget de búsqueda, configura lo siguiente:
Resultados del widget de la Búsqueda. Consulta Cómo configurar los resultados para el widget de búsqueda.
Facetas del widget de la Búsqueda (versión preliminar). Consulta Cómo configurar las facetas para el widget de búsqueda.
Si planeas integrar llamadas a la API de búsqueda en tu servidor o aplicación en lugar de usar el widget, puedes configurar los parámetros de búsqueda con las siguientes opciones:
Configuración de campos. Para datos estructurados o datos no estructurados con metadatos, actualiza la configuración de campos para definir mejor cómo Agent Search usa los metadatos para la búsqueda. Consulta Cómo configurar campos para la búsqueda.
Autocompletar. Según tus datos, configura sugerencias de autocompletar basadas en el contenido del documento, los campos, el historial de búsqueda o los eventos de usuario. Consulta Cómo configurar la función de autocompletar.
Controles de entrega. Controla cuándo se promocionan, se ocultan, se filtran o se redireccionan los resultados de la búsqueda, o si ciertas consultas están asociadas con otras. Consulta Cómo configurar los controles de entrega.
Ajustes de la búsqueda (versión preliminar). Ajusta el modelo de búsqueda con tus propios datos de entrenamiento. Consulta Cómo mejorar los resultados de la búsqueda con ajustes de la búsqueda.
Embeddings personalizados (versión preliminar). Si creaste tus propios embeddings, es posible que prefieras usarlos en lugar de los generados por Agent Search para enriquecer tus búsquedas con contexto adicional. Esta función está disponible para almacenes de datos con datos estructurados o datos no estructurados con metadatos. Consulta Cómo usar embeddings.
Si planeas implementar tu app integrando llamadas a la API de búsqueda en tu propio código, Agent Search proporciona opciones adicionales para configurar cómo se muestran los resultados de la búsqueda.
Acciones
Configura los resultados de la búsqueda con las siguientes opciones:
- Filtra la búsqueda personalizada para datos estructurados o no estructurados.
- Obtén fragmentos, respuestas extractivas o segmentos extractivos. Consulta Cómo obtener fragmentos y contenido extraído.
Puedes obtener una vista previa de los resultados de la búsqueda para verificar si las configuraciones de tu app funcionan como se espera.
Acciones
Para obtener una vista previa de los resultados de la búsqueda, usa la consola o la API.
Consola: Usa la página Vista previa de la consola de Agent Search para obtener una vista previa de cómo las configuraciones del widget de búsqueda afectan tus resultados. Consulta las instrucciones de la consola en Cómo obtener resultados de la búsqueda.
API : Si integras llamadas a la API en tu aplicación, realiza llamadas a la API para obtener una vista previa de tus configuraciones de búsqueda. Consulta las instrucciones de REST en Cómo obtener resultados de la búsqueda.
Cuando estés satisfecho con la versión preliminar de tu app de búsqueda, compártela con los usuarios implementándola en tu sitio web.
Acciones
Puedes implementar tu app de búsqueda de cualquiera de las siguientes maneras:
Incorpora el widget de búsqueda en tu sitio web. Agent Search proporciona código que puedes copiar en tu sitio web o aplicación web. Esto implementa el widget de búsqueda. Puedes obtener una vista previa de los resultados de la búsqueda en la consola. Consulta Cómo agregar el widget de búsqueda a una página web.
Integra llamadas a la API de búsqueda en tu servidor o aplicación. Para tener un control total sobre cómo se muestran los resultados de la búsqueda, puedes integrar llamadas a la API en tu servidor o aplicaciones. Para obtener más información sobre cómo realizar llamadas a la API, consulta Cómo obtener resultados de la búsqueda. Para obtener recursos de la biblioteca cliente, consulta Bibliotecas cliente de Agent Search.
Para obtener resultados de búsqueda y exploración personalizados, puedes actualizar los eventos de usuario en tu app de búsqueda. Para obtener más información, consulta Acerca de los eventos de usuario para apps personalizadas.
Acciones
Puedes mantener tu app para asegurarte de que los datos más recientes y necesarios estén disponibles en tu almacén de datos.