Cómo usar las sugerencias de la Búsqueda de Google

Cuando usas la fundamentación con la Búsqueda de Google y recibes sugerencias de búsqueda en tu respuesta, debes mostrar las sugerencias de búsqueda en producción y en tus aplicaciones.

Para obtener más información sobre la fundamentación con la Búsqueda de Google, consulta Fundamentación con la Búsqueda de Google.

Específicamente, debes mostrar las búsquedas que se incluyen en los metadatos de la respuesta fundamentada. En la respuesta, se incluye :

  • "content": Respuesta generada por el LLM.
  • "webSearchQueries": Son las consultas que se usarán para las sugerencias de búsqueda.

Por ejemplo, en el siguiente fragmento de código, Gemini responde a una instrucción basada en la Búsqueda que pregunta sobre un tipo de planta tropical.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

Puedes tomar este resultado y mostrarlo a través de las sugerencias de búsqueda.

Requisitos para las sugerencias de búsqueda

Los siguientes son requisitos para las sugerencias:

Requisito Descripción
Sí
  • Si bien cumple con los requisitos de visualización, la sugerencia de búsqueda se muestra exactamente como se proporciona sin ningún cambio.
  • Cuando interactúas con la sugerencia de búsqueda, se te dirige directamente a la página de resultados de la Búsqueda (SRP).
No
  • Incluir pantallas o pasos adicionales entre la selección del usuario y la visualización de la SRP
  • Muestra cualquier otro resultado de la búsqueda o sugerencia junto con la sugerencia de búsqueda o la respuesta de LLM fundamentada asociada.

Requisitos de visualización

Los siguientes son los requisitos de visualización:

  • Muestra la sugerencia de búsqueda exactamente como se proporciona y no modifiques los colores, las fuentes ni la apariencia. Asegúrate de que la sugerencia de búsqueda se renderice como se especifica en las siguientes simulaciones, como el modo claro y el oscuro:

  • Cada vez que se muestre una respuesta fundamentada, la sugerencia de la Búsqueda correspondiente debería permanecer visible.
  • En el caso del desarrollo de la marca, debes seguir estrictamente los lineamientos de Google para el uso de terceros de las características de marca de Google en Te damos la bienvenida a nuestro Centro de recursos de marca.
  • Cuando usas la fundamentación con la Búsqueda, se muestran los chips de sugerencias de búsqueda. El campo que contiene los chips de sugerencias debe tener el mismo ancho que la respuesta fundamentada del LLM.

Comportamiento al presionar

Cuando un usuario presiona el chip, se lo dirige directamente a una página de resultados de la búsqueda (SRP) correspondiente al término de búsqueda que se muestra en el chip. La SRP puede abrirse dentro del navegador integrado en la app o en una aplicación de navegador independiente. Es importante no minimizar, quitar ni obstructed la pantalla de la SRP de ninguna manera. En la siguiente simulación animada, se ilustra la interacción de presionar para acceder a la SRP.

ejemplo de app/computadora de escritorio

Código para implementar una sugerencia de búsqueda

Cuando usas la API para fundamentar una respuesta a una búsqueda, la respuesta del modelo proporciona un estilo HTML y CSS compatible en el campo renderedContent, que implementas para mostrar sugerencias de búsqueda en tu aplicación. Para ver un ejemplo de la respuesta de la API, consulta la sección de respuesta en Fundamentos con la Búsqueda.

¿Qué sigue?