O preenchimento automático do Google Cloud Search ajuda os usuários sugerindo palavras enquanto eles digitam uma consulta de pesquisa. Por exemplo, as sugestões podem incluir palavras de títulos de documentos, operadores de pesquisa ou nomes da sua organização do Google Workspace.
O preenchimento automático extrai frases dos títulos de documentos indexados e usa um modelo de n-grama para determinar sugestões usando a API Suggest. Por padrão, o preenchimento automático mostra frases dos títulos dos documentos. Você também pode marcar propriedades de texto e esquema de enumeração como is_suggestable para
preencher automaticamente nomes e valores de propriedades.
A API Suggest examina as consultas de pesquisa em busca de dicas de idioma, como inglês ou espanhol, e prioriza os resultados. O campo
languageCode
em uma solicitação também melhora as sugestões específicas do idioma.
Exemplo de cenário
Considere uma fonte de dados com informações sobre filmes:
- A fonte de dados contém dois documentos.
- Cada documento tem um título (
ItemMetadata.title) e duas propriedades:genreecharacters. - Título do documento 1: "Avengers Infinity War";
genre=science fiction;characters=Iron Man, Hulk. - Título do documento 2: "Harry Potter";
genre=Adventure, Fantasy;characters=Hermione, Harry Potter.
A Figura 1 ilustra como o preenchimento automático extrai sugestões.
Do documento 1, o modelo extrai n-gramas (até trigramas) como "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War" e "Avengers Infinity War". Do documento 2, ele gera "Harry", "Potter" e "Harry Potter".
Se um usuário digitar "h" ao consultar essa fonte de dados, as seguintes sugestões poderão aparecer:
- Harry
- Hermione
- Hulk
- Harry Potter
Se o usuário selecionar "Hermione" e digitar "a", o preenchimento automático poderá mostrar:
- Hermione Adventure
- Hermione Action
- Hermione Avengers
O preenchimento automático tenta concluir a última palavra ou n-grama digitada. Neste exemplo, ele expande "a" para "adventure", "action" e "avengers" porque nenhum texto indexado começa com "hermione a". Esta é uma sugestão de cauda.
O preenchimento automático do Cloud Search retorna no máximo cinco sugestões do conteúdo do documento e duas sugestões de pessoas.
Por padrão, o preenchimento automático mostra frases dos títulos dos documentos. Você precisa marcar explicitamente as propriedades do esquema como is_suggestable para que a API Suggest preencha automaticamente os nomes e valores das propriedades.
Integrar com a API Suggest
Se você usa o aplicativo de pesquisa padrão ou o widget de pesquisa incorporável, o Cloud Search oferece suporte nativo ao preenchimento automático. Não se esqueça de marcar as propriedades do esquema como is_suggestable se quiser que elas sejam preenchidas automaticamente.
Se você estiver criando um aplicativo de pesquisa personalizado, o preenchimento automático estará disponível usando os endpoints da API /query/suggest.
Limitações
O preenchimento automático tem estas limitações:
- Não é possível restringir frases de preenchimento automático usando
FilterOptions, exceto para filtros integrados comoobjecttypeemimetype. - Sugestões baseadas no histórico de consultas de um usuário não são compatíveis.
- É possível marcar no máximo 20 propriedades como
is_suggestable. Entre em contato com o suporte do Cloud Search para aumentar esse limite. - O preenchimento automático do operador de pesquisa não está disponível para propriedades com
exact_match_with_operator. - O preenchimento automático retorna no máximo cinco sugestões de conteúdo de documentos e duas sugestões de pessoas.
- O preenchimento automático sugere frases apenas de documentos a que o usuário tem acesso.