Migrar de la API Custom Search Site Restricted JSON

Si usas la API JSON Custom Search Site Restricted de Buscador Programable, puedes crear e implementar una búsqueda de calidad de Google restringida a un sitio en cuestión de minutos con Vertex AI Search. Para desplegar tu aplicación, puedes usar el widget de búsqueda copiando el código de la consola Google Cloud directamente en una página web. No es necesario escribir código. También puedes implementar una API para controlar el aspecto de la función de búsqueda en tu sitio web. Para obtener más información sobre cómo usar la API, consulta la pestaña REST de Obtener resultados de búsqueda de una aplicación con datos de un sitio web y el método servingConfigs.search de la referencia de REST.

Además de los fragmentos cortos estándar que devuelve Vertex AI Search con los resultados de búsqueda, puedes añadir funciones avanzadas a tu búsqueda. Entre ellas, se incluyen resúmenes generados de los resultados de búsqueda, búsquedas con seguimiento para búsquedas contextuales que permiten hacer preguntas de seguimiento y respuestas extractivas para el texto extraído que se devuelve con cada resultado de búsqueda. Para obtener estas funciones avanzadas de búsqueda web, debes verificar tu dominio, lo que conlleva costes de indexación adicionales.

También puedes filtrar u ordenar los resultados de búsqueda y aplicar controles de promoción para mostrar un enlace como resultado promocionado.

Para obtener más información, consulta la página de precios de aplicaciones de IA.

Configurar Vertex AI Search

Para configurar Vertex AI Search, sigue estos pasos:

  1. En la Google Cloud consola, en la página del selector de proyectos, selecciona el proyecto que has estado usando para la API JSON Custom Search Site Restricted.

  2. Activa Aplicaciones de IA.

Crear una aplicación de búsqueda

Para crear una aplicación de búsqueda, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

    Aplicaciones de IA

  2. Haz clic en Crear aplicación.

  3. En la página Crear aplicación, en Búsqueda en el sitio con el modo IA, haz clic en Crear.

  4. Asegúrate de que la opción Funciones de la edición Enterprise esté activada. Es obligatorio para la búsqueda en el sitio web. Para obtener más información, consulta las funciones de la edición Enterprise.

  5. Desactiva las funciones avanzadas de LLM. Si desactiva esta opción, tendrá una función similar a la API JSON Custom Search Site Restricted del Buscador Programable. Desactiva esta opción si no necesitas resúmenes de búsqueda ni búsquedas con seguimiento. Para obtener más información, consulta Funciones avanzadas de LLM.

  6. En el campo Nombre de tu aplicación, escribe el nombre de tu aplicación.

  7. En el campo Nombre externo de tu empresa u organización, introduce el nombre común de tu empresa u organización.

  8. Selecciona global (Global) como ubicación de tu aplicación y, a continuación, haz clic en Continuar.

  9. En la página Almacenes de datos, haga clic en Crear almacén de datos.

  10. En el panel Seleccionar una fuente de datos, elija Contenido del sitio web.

  11. Desactiva la indexación Indexación avanzada de sitios web. Si desactivas esta opción, tendrás funciones similares a las de la API JSON Custom Search Site Restricted de Buscador Programable. Desactiva esta opción si no necesitas la función de resumen de búsqueda o la de búsqueda con seguimiento, o si no eres el propietario de los dominios que especifiques. Consulta más información en el artículo Indexación avanzada de sitios web.

  12. En el panel Especificar patrones de URL para indexar, en el campo Sitios que incluir, introduzca los patrones de URL de los sitios web en los que quiera buscar y, a continuación, haga clic en Continuar.

  13. En el panel Configurar tu almacén de datos, introduce un nombre visible para tu almacén de datos y, a continuación, haz clic en Crear.

  14. En la página Almacenes de datos, selecciona el nuevo almacén de datos y haz clic en Crear.

Desplegar la aplicación de búsqueda

Decide cómo quieres autenticar tu aplicación de búsqueda de Vertex AI Search: con OAuth 2.0 o con una clave de API. Para obtener información sobre las ventajas y desventajas de cada método, consulte el artículo Acerca de la autenticación.

Implementar la aplicación de búsqueda (OAuth 2.0)

Para implementar tu aplicación de búsqueda mediante la autenticación con OAuth 2.0, sigue estos pasos:

  1. Para configurar OAuth 2.0, consulta la sección En Google Cloud del artículo Autenticar aplicaciones de IA. Asegúrate de añadir el rol Usuario de Discovery Engine o Lector de Discovery Engine a la cuenta de servicio.

  2. Despliega tu aplicación de búsqueda de una de las siguientes formas:

Desplegar la aplicación de búsqueda (clave de API)

Para implementar tu aplicación de búsqueda con una clave de API para la autenticación, sigue estos pasos:

  1. Crea la clave de API:

    1. En la Google Cloud consola, ve a la página Credenciales.

      Credenciales

    2. Si aún no estás en tu proyecto, selecciona el proyecto en la lista de proyectos de la parte superior de la página de la consola. Google Cloud

    3. Haz clic en Crear credenciales y, a continuación, selecciona Clave de API. No añadas ninguna restricción de referente. Algunos ajustes de privacidad del usuario no transmiten la URL referente.

      • Anota la clave de API generada, que usarás al llamar al método searchLite.

    4. Para aumentar la seguridad, añade una restricción HTTP a tu clave de API para restringir el acceso al servicio AI Applications en https://discoveryengine.googleapis.com/*.

  2. Despliega tu aplicación de búsqueda mediante la API. Consulta Obtener resultados de búsqueda de una aplicación con datos de un sitio web (clave de API) y el método servingConfigs.searchLite en la referencia de REST. Para ordenar los resultados de tus consultas de búsqueda web, consulta Ordenar resultados de búsqueda web.

Acerca de la autenticación

La API JSON Custom Search Site Restricted del Buscador Programable se autentica mediante una clave de API. Vertex AI Search requiere OAuth 2.0, salvo un par de excepciones. Si quieres seguir usando una clave de API para la autenticación, debes usar el método searchLite a través de llamadas a la API.

Si decides autenticarte mediante OAuth 2.0, debes usar el método search y el método answer para consultar tu sitio web. Además, puedes implementar tu aplicación de búsqueda mediante el widget de búsqueda sin código.

En la siguiente tabla se muestran las diferencias entre el uso del método searchLite con la autenticación de clave de API y los métodos search y answer con la autenticación de OAuth 2.0.

Función/Métodos Método searchLite Método search
Autenticación Clave de API OAuth 2.0
Widget de búsqueda disponible ✘ ✔
Resúmenes de búsqueda ✔ ✔
Buscar en sitios web públicos ✔ ✔

Pasos siguientes