Migra desde la API de Custom Search Site Restricted JSON

Si usas la API de Custom Search Site Restricted JSON del Motor de Búsqueda Programable, puedes crear y, luego, implementar una búsqueda restringida a sitios con la calidad de Google en minutos con Vertex AI Search. Para implementar tu app, puedes usar el widget de búsqueda. Para ello, copia el código de la consola de Google Cloud directamente en una página web. No se requiere programación. 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 el uso de la API, consulta la pestaña REST de Cómo obtener resultados de la búsqueda de una app con datos del sitio web y el método servingConfigs.search en la referencia de REST.

Además de los fragmentos cortos estándar que devuelve Vertex AI Search con los resultados de la búsqueda, puedes agregar funciones avanzadas a tu búsqueda. Estos incluyen resúmenes generados de los resultados de la búsqueda, búsqueda con preguntas de seguimiento para una búsqueda que tiene en cuenta el contexto y permite hacer preguntas de seguimiento, y respuestas extractivas para el texto extraído que se muestra con cada resultado de la búsqueda. Para obtener estas funciones avanzadas para tu búsqueda web, se requiere la verificación del dominio y se generan costos adicionales de indexación.

También puedes filtrar o ordenar los resultados de la búsqueda y aplicar controles de promoción para mostrar un vínculo como resultado promocionado.

Para obtener más información, consulta la página Precios de las Aplicaciones con IA.

Configura Vertex AI Search

Para configurar Vertex AI Search, sigue estos pasos:

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

  2. Activa AI Applications.

Crea una app de búsqueda

Para crear una app de búsqueda, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página AI Applications.

    Aplicaciones basadas en IA

  2. Haz clic en Crear aplicación.

  3. En la página Crear app, en Búsquedas 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. Este campo es obligatorio para la búsqueda en el sitio web. Para obtener más información, consulta Funciones de la edición Enterprise.

  5. Desactiva Funciones avanzadas de LLM. Si desactivas esta opción, obtendrás una funcionalidad similar a la de la API de Custom Search Site Restricted JSON del Motor de Búsqueda Programable. Desactiva esta opción si no necesitas la función de resumen de la búsqueda ni la de búsqueda con preguntas de seguimiento. Para obtener más información, consulta Funciones avanzadas de LLM.

  6. En el campo Nombre de tu app, ingresa un nombre para ella.

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

  8. Selecciona global (Global) como la ubicación de tu app y, luego, haz clic en Continuar.

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

  10. En el panel Selecciona una fuente de datos, elige Contenido de sitios web.

  11. Desactiva la indexación de la indexación avanzada de sitios web. Si desactivas esta opción, obtendrás una funcionalidad similar a la de la API de Custom Search Site Restricted JSON del Motor de Búsqueda Programable. Desactiva esta opción si no necesitas la función de resumen de búsqueda ni la de búsqueda con preguntas de seguimiento, o si no eres propietario de los dominios que especificas. Para obtener más información, consulta Indexación avanzada de sitios web.

  12. En el panel Especificar los patrones de URL que se indexarán, en el campo Sitios que se incluirán, ingresa los patrones de URL de los sitios web que deseas buscar y, luego, haz clic en Continuar.

  13. En el panel Configura tu almacén de datos, ingresa un nombre visible para el almacén de datos y, luego, haz clic en Crear.

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

Implementa la app de búsqueda

Decide cómo planeas autenticar tu app de búsqueda de Vertex AI Search: con OAuth 2.0 o una clave de API. Para obtener información sobre las ventajas y desventajas de cada método, consulta Acerca de la autenticación.

Implementa la app de búsqueda (OAuth 2.0)

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

  1. Para configurar OAuth 2.0, consulta En Google Cloud en Cómo autenticar aplicaciones basadas en IA. Asegúrate de agregar el rol de Usuario de Discovery Engine o Visualizador de Discovery Engine a la cuenta de servicio.

  2. Implementa tu app de búsqueda de una de las siguientes maneras:

Implementa la app de búsqueda (clave de API)

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

  1. Crea la clave de API:

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

      Credenciales

    2. Si aún no estás en tu proyecto, selecciónalo en la lista de proyectos que se encuentra en la parte superior de la página de la consola de Google Cloud .

    3. Haz clic en Crear credenciales y selecciona Clave de API. No agregues ninguna restricción del sitio de referencia. Algunos parámetros de configuración de privacidad del usuario no pasan la URL del sitio de referencia.

      • Toma nota de la clave de API generada, que usarás cuando llames al método searchLite.

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

  2. Implementa tu app de búsqueda con la API. Consulta Cómo obtener resultados de la búsqueda de una app con datos del sitio web (clave de API) y el método servingConfigs.searchLite en la referencia de REST. Para ordenar los resultados de tus búsquedas web, consulta Cómo ordenar los resultados de la búsqueda web.

Acerca de la autenticación

La API de Custom Search Site Restricted JSON del Motor de Búsqueda Programable se autentica con una clave de API. Si bien, con algunas excepciones, Vertex AI Search requiere OAuth 2.0. Si deseas 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 eliges autenticarte a través de OAuth 2.0, deberás usar el método search y el método answer para consultar tu sitio web. Además, puedes implementar tu app de búsqueda a través del widget de búsqueda sin código.

En la siguiente tabla, se enumeran 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.

Funciones y métodos Método searchLite Método search
Authentication Clave de API OAuth 2.0
Widget de la Búsqueda disponible ✘ ✔
Resúmenes creados con la Búsqueda ✔ ✔
Buscar en sitios web públicos ✔ ✔

Próximos pasos