Usar as Sugestões da Pesquisa Google

Quando você usa o embasamento com a Pesquisa Google e recebe sugestões de pesquisa na resposta, é necessário mostrar as sugestões de pesquisa na produção e nos seus aplicativos.

Para mais informações sobre o embasamento com a Pesquisa Google, consulte Como basear com a Pesquisa Google.

Especifique as consultas de pesquisa incluídas nos metadados da resposta embasada. A resposta inclui:

  • "content": resposta gerada pelo LLM.
  • "webSearchQueries": as consultas a serem usadas para sugerir pesquisas.

Por exemplo, no snippet de código a seguir, o Gemini responde a um comando baseado na Pesquisa Google, que pergunta sobre um tipo de planta tropical.

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

É possível usar essa saída e exibi-la com sugestões de pesquisa.

Requisitos para sugestões de pesquisa

Estes são os requisitos para sugestões:

Requisito Descrição
O que fazer
  • Ao obedecer aos requisitos de exibição, a sugestão de pesquisa é mostrada exatamente como fornecida, sem mudanças.
  • Quando você interage com a sugestão de pesquisa, é direcionado diretamente para a página de resultados da pesquisa (SRP).
O que evitar
  • Inclua telas ou etapas adicionais entre o toque do usuário e a exibição do SRP.
  • Mostre outros resultados ou sugestões da pesquisa ao lado da Sugestão de pesquisa ou da resposta do LLM fundamentada associada.

Requisitos de exibição

Confira os requisitos de exibição:

  • Mostre o sugestão de pesquisa exatamente como ela foi fornecida e não faça modificações nas cores, fontes ou aparência. Confira se a sugestão de pesquisa é renderizada conforme especificado nos seguintes modelos, como o modo claro e escuro:

  • Sempre que uma resposta fundamentada for exibida, a sugestão de pesquisa correspondente vai permanecer visível.
  • Para a marca, é necessário seguir rigorosamente as diretrizes do Google para o uso de características da marca Google por terceiros no Seja bem-vindo à nossa Central de recursos de marca.
  • Quando você usa o embasamento com a Pesquisa, os ícones de sugestões de pesquisa são exibidos. O campo que contém os ícones de sugestão precisa ter a mesma largura que a resposta fundamentada do LLM.

Comportamento ao tocar

Quando um usuário toca no ícone, ele é direcionado para uma página de resultados da Pesquisa (SRP) com o termo de pesquisa exibido no ícone. O SRP pode ser aberto no navegador no app ou em um aplicativo de navegador separado. É importante não minimizar, remover ou obstruir a exibição do SRP de maneira alguma. O modelo animado a seguir ilustra a interação do toque para o SRP.

exemplo de app/desktop

Código para implementar uma sugestão de pesquisa

Quando você usa a API para fundamentar uma resposta à pesquisa, a resposta do modelo fornece estilo HTML e CSS compatível no campo renderedContent, que você implementa para mostrar sugestões de pesquisa no seu aplicativo. Para conferir um exemplo de resposta da API, consulte a seção de resposta em Embasamento com a Pesquisa.

A seguir