Si es la primera vez que usas Vertex AI Agent Builder, te recomendamos que sigas el instructivo Comienza a usar la Búsqueda de Vertex AI para crear una app de ejemplo.
Configura un Google Cloud proyecto, activa Vertex AI Agent Builder y configura el control de acceso para tu proyecto. Puedes usar un proyecto Google Cloud existente si ya tienes uno.
Acciones
- Revisa Antes de comenzar y confirma que completaste los pasos.
Determina qué tipo de datos pondrás a disposición en tu app de búsqueda y prepáralos para importarlos a Vertex AI 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 compatibles y la relación entre las apps y los almacenes de datos en Acerca de las apps y los almacenes de datos.
Prepara tus datos según los requisitos que se indican en Cómo preparar 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 tu app de búsqueda, revisa los requisitos previos y sigue las instrucciones para tu tipo de proveedor de identidad y fuente de datos en Cómo usar el control de acceso a la fuente de datos.
Crea un almacén de datos y, luego, importa tus datos a él, o bien configura un conector de terceros como tu fuente de datos sincronizada.
La forma en que importes tus datos dependerá de dónde los importes. Por ejemplo, si tus datos están en Cloud Storage, puedes importarlos con la consola o la API si proporcionas la ubicación del bucket de tus datos.
Acciones
- Sigue las instrucciones para tu fuente de datos en Cómo crear un almacén de datos de búsqueda.
Crea tu app de búsqueda genérica y conéctala a tu nuevo almacén de datos.
Acciones
Vertex AI 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, Vertex AI 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 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 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 la configuración de búsqueda con las siguientes opciones:
Configuración de campos. En el caso de los datos estructurados o no estructurados con metadatos, actualiza la configuración del campo para definir mejor cómo Vertex AI Search usa los metadatos para la búsqueda. Consulta Configura campos para la búsqueda.
Autocompletar. Según tus datos, configura las sugerencias de autocompletado según el contenido del documento, los campos, el historial de búsqueda o los eventos del usuario. Consulta Configura la función de autocompletar.
Controles de publicación. Controla cuándo se mejoran, ocultan, filtran o redireccionan los resultados de la búsqueda, o si ciertas búsquedas están asociadas con otras. Consulta Configura controles de publicación.
Ajuste 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 la optimización de la búsqueda.
Incorporaciones personalizadas (versión preliminar). Si creaste tus propias incorporaciones, es posible que prefieras usarlas en lugar de las que genera Vertex AI 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 incorporaciones personalizadas.
Si planeas implementar tu app integrando llamadas a la API de búsqueda en tu propio código, Vertex AI 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 genérica 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 la configuración de tu app funciona 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 Vertex AI Agent Builder para obtener una vista previa de cómo las configuraciones de los widgets de búsqueda afectan tus resultados. Consulta las instrucciones de Console en 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 conforme con la versión preliminar de tu app de búsqueda, compártela con tus 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. Vertex AI Search proporciona código que puedes copiar en tu sitio web o aplicación web. Esto implementará 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 las llamadas a la API de búsqueda en tu servidor o aplicación. Para tener 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 bibliotecas cliente, consulta Bibliotecas cliente de Vertex AI Agent Builder.
Puedes mantener tu app para asegurarte de que los datos más recientes y necesarios estén disponibles en tu almacén de datos.