Migra desde la API de Custom Search Site Restricted JSON

Si usas la API de JSON de Custom Search Site Restricted del Motor de Búsqueda Programable, puedes crear y implementar una búsqueda restringida a sitios con la calidad de Google en minutos con la Búsqueda de Vertex AI. 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 es necesario que sepas codificar. También puedes implementar una implementación de API para controlar cómo se ve la funcionalidad 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 de sitios web y el método servingConfigs.search en la referencia de REST.

Además de los fragmentos cortos estándar que Vertex AI Search muestra 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 adicionales para la búsqueda contextualizada que permite preguntas adicionales y respuestas extractivas para el texto extraído que se muestra con cada resultado de la búsqueda. Para obtener estas funciones avanzadas en tu búsqueda web, debes realizar la verificación del dominio y generar costos de indexación adicionales.

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 del compilador de agentes de Vertex AI.

Configura Vertex AI Search

Para configurar la Búsqueda de Vertex AI, sigue estos pasos:

  1. En la página del selector de proyectos de la consola de Google Cloud, selecciona el proyecto que usaste para la API de JSON restringida del sitio de búsqueda personalizada.

  2. Activa Vertex AI Agent Builder.

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 Agent Builder.

    Agent Builder

  2. Haz clic en Crear aplicación.

  3. En la página Crear app, en Busca tu sitio web, 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 de sitios web. Para obtener más información, consulta las funciones de la edición Enterprise.

  5. Desactiva la opción Funciones avanzadas de LLM. Si lo desactivas, obtendrás una funcionalidad similar a la API de Custom Search Site Restricted JSON del Motor de Búsqueda Programable. Desactiva esta opción si no necesitas el resumen de la búsqueda ni la búsqueda con preguntas adicionales. 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 Indexación avanzada de sitios web. Si lo desactivas, obtienes funciones similares a las de la API de Custom Search Site Restricted JSON del Motor de Búsqueda Programable. Desactiva esta opción si no necesitas el resumen de la búsqueda ni la búsqueda con preguntas adicionales, 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 tu 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 autenticarse en Vertex AI Agent Builder. Asegúrate de agregar el rol de usuario de Discovery Engine o de 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 referente. Algunos parámetros de configuración de privacidad del usuario no pasan la URL 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 Vertex AI Agent Builder 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 de sitios 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.

Información 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. Mientras que, con algunas excepciones, Vertex AI Search requiere OAuth 2.0. 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 eliges autenticarte a través de OAuth 2.0, debes 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 claves de API y los métodos search y answer con la autenticación de OAuth 2.0.

Funciones/métodos Método searchLite Método search
Authentication Clave de API OAuth 2.0
Widget de la Búsqueda disponible ✘ ✔
Resumen de búsquedas ✔ ✔
Buscar en sitios web públicos ✔ ✔

Próximos pasos