Como usar os pontos de entrada da Pesquisa Google
Para usar os pontos de entrada da Pesquisa Google, é preciso exibir um ponto de entrada com base na consulta de pesquisa incluída nos metadados da resposta embasada. A resposta inclui:
- "content": resposta gerada pelo LLM.
- "searchQuery": a consulta que será usada para o ponto de entrada da Pesquisa Google.
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?"],
}
}
]
Use pontos de entrada da Pesquisa Google para exibir essa saída.
Requisitos para pontos de entrada da Pesquisa Google
O que fazer:
- Exiba o ponto de entrada exatamente como fornecido, sem modificações, em conformidade com os requisitos de exibição abaixo.
- Isso leva os usuários diretamente para a página de resultados da Pesquisa Google (SRP, na sigla em inglês) quando eles interagirem com o ponto de entrada.
O que não fazer:
- Inclua telas intersticiais 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 do ponto de entrada ou da resposta do LLM fundamentada associada.
Requisitos de exibição
- Mostre o ponto de entrada exatamente como ele foi fornecido e não modifique as cores, as fontes ou a aparência. Verifique se o ponto de entrada é renderizado conforme especificado nas simulações a seguir, incluindo os modos claro e escuro:
- Sempre que uma resposta fundamentada for exibida, o ponto de entrada correspondente da Pesquisa Google deverá permanecer visível.
- Branding (construção da marca): é necessário seguir rigorosamente as Diretrizes do Google para o uso de características da marca do Google por terceiros.
- Os pontos de entrada da Pesquisa Google precisam ter, no mínimo, a largura total da resposta embasada.
Comportamento ao tocar
Quando um usuário toca no ícone, ele é direcionado para uma página de resultados da Pesquisa Google (SRP) com o termo de pesquisa exibido no ícone. O SRP pode ser aberto no navegador no app ou em um app 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.
Código para implementar um ponto de entrada da Pesquisa Google
Quando você usa a API para fundamentar uma resposta para a pesquisa, a resposta do modelo fornece estilo HTML e CSS compatível no campo renderedContent
que você implementa para exibir pontos de entrada de pesquisa no seu aplicativo. Para ver um exemplo de resposta da API, consulte a seção de resposta em Embasamento com a Pesquisa Google.
A seguir
- Saiba como enviar solicitações de comandos de chat.
- Saiba mais sobre as práticas recomendadas de IA responsável e os filtros de segurança da Vertex AI.
- Para aprender a embasar os modelos PaLM, consulte Embasamento na Vertex AI.