Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A navegação usa métodos de navegação para mostrar resultados de pesquisa que correspondem às categorias ou filtros selecionados pelo usuário final. A navegação retorna resultados que podem ser personalizados.
Esta página descreve como receber resultados de navegação para armazenamentos de dados de pesquisa genéricos.
Sobre a navegação
Em um app de pesquisa de aplicativos de IA, navegar é pesquisar sem uma consulta ou com uma consulta vazia. Se você tiver um repositório de dados de pesquisa genérica que contenha dados estruturados, dados não estruturados com metadados ou dados de sites, poderá enviar uma consulta de pesquisa vazia para receber resultados de navegação.
Quando você envia uma solicitação de navegação, os documentos no seu repositório de dados que correspondem aos filtros são retornados de acordo com os indicadores baseados em eventos. Você pode
oferecer uma experiência de navegação aprimorada fazendo o seguinte:
Use filtros na sua solicitação de pesquisa para restringir os resultados. Se você usa a indexação avançada de sites, consulte Usar dados estruturados para indexação avançada de sites e saiba como adicionar metadados ao seu esquema e usá-los para enriquecer os campos de filtro e aumentar.
Adicione uma especificação de reforço para influenciar a ordem dos resultados retornados, reforçando ou ocultando resultados específicos.
Entenda e registre eventos do usuário. O Google usa seus eventos de usuário para otimizar a classificação dos resultados de acordo com a taxa de cliques.
Como a navegação difere da pesquisa
A tabela a seguir apresenta as diferenças entre pesquisa e navegação.
Recurso
Pesquisar
Procurar
Finalidade
Encontrar informações específicas
Explorar e descobrir conteúdo
Exemplo
Pesquisar "melhores restaurantes coreanos em Vancouver" na Pesquisa Google
Procurar um restaurante com base nas categorias a que ele pode pertencer, como "Restaurantes > Coreano > Vancouver > 4 estrelas e acima"
User
Intent
Normalmente orientada a metas
Exploratória
Ponto de partida
Uma consulta ou palavra-chave
geralmente em uma barra de pesquisa
Um site ou plataforma específica que geralmente usa um menu, rastros de navegação, links ou outros métodos de navegação, como refinamentos
Método
Inserir palavras-chave ou frases e aplicar a configuração de pesquisa e veiculação
Pesquisar com uma consulta vazia, aplicando
a configuração de pesquisa e veiculação
Resultados
Uma lista de resultados relevantes
Todos os documentos no repositório de dados que correspondem aos filtros
Receber resultados de navegação para um app com dados do site
Para usar a API e receber resultados de navegação de um app com dados de sites,
Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.
No console Google Cloud , acesse a página Aplicativos de IA.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[],[],null,["# Get personalized browse results\n\nBrowsing uses navigational methods to display search results that match\nthe end user's selected categories or filters. Browsing returns results that can be\npersonalized.\nThis page describes how to get browse results for generic search data stores.\n\nAbout browse\n------------\n\nIn an AI Applications search app, to browse is to search with\nno query or an empty query. If you have a generic search data store that\ncontains structured data, unstructured data with metadata, or website data, you\ncan send an empty search\nquery to receive browse results.\n\nWhen you send a browse request, the documents in your data store that match\nthe filters are returned according to event-based signals. You can\ndeliver an enhanced browsing experience by doing the following:\n\n- Use filters in your search request to narrow down the search results. If you use advanced website indexing, see [Use structured data for advanced website\n indexing](/generative-ai-app-builder/docs/add-website-metadata) to understand how to add metadata in your schema and use it to enrich your filter and boost fields.\n- Add a boost specification to influence the order of the returned results by boosting or burying specific results.\n- Understand user events and record them. Google uses your user events to optimize result ranking for click-through rate.\n\nHow browse differs from search\n------------------------------\n\nThe following table presents the differences between searching and browsing.\n\nGet browse results for an app with website data\n-----------------------------------------------\n\nTo use the API to get browse results for an app with website data,\n\n1. Find your app ID. If you already have your app ID, skip to the next step.\n\n 1. In the Google Cloud console, go to the **AI Applications** page.\n\n [Go to Apps](https://console.cloud.google.com/gen-app-builder/engines)\n 2. On the **Apps** page, find the name of your app and get the app's ID from\n the **ID** column.\n\n2. Call the [`engines.servingConfigs.search`](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.engines.servingConfigs/search) method with an\n empty query or no query as follows:\n\n\n ### REST\n\n \u003cbr /\u003e\n\n **Key Term:** In Vertex AI Search, the term *app* can be used interchangeably with the term *engine* in the context of APIs. \n\n curl -X POST -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H \"Content-Type: application/json\" \\\n \"https://discoveryengine.googleapis.com/v1/projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/locations/global/collections/default_collection/engines/\u003cvar translate=\"no\"\u003eAPP_ID\u003c/var\u003e/servingConfigs/default_search:search\" \\\n -d '{\n \"servingConfig\": \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/locations/global/collections/default_collection/engines/\u003cvar translate=\"no\"\u003eAPP_ID\u003c/var\u003e/servingConfigs/default_search\",\n \"orderBy\": \"\u003cvar translate=\"no\"\u003eORDER_BY\u003c/var\u003e\",\n \"params\": {\n \"searchType\": \"0\"\n },\n \"filter\": \"\u003cvar translate=\"no\"\u003eFILTER\u003c/var\u003e\",\n \"boostSpec\": \"\u003cvar translate=\"no\"\u003eBOOST_SPEC\u003c/var\u003e\",\n }'\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project.\n - \u003cvar translate=\"no\"\u003eAPP_ID\u003c/var\u003e: the ID of the Vertex AI Search app that you want to query.\n - \u003cvar translate=\"no\"\u003eORDER_BY\u003c/var\u003e: optional. The order in which the results are arranged. The attribute to sort on must have a numerical interpretation---for example, `date`. For more information, see [Order web search\n results](/generative-ai-app-builder/docs/order-web-search-results).\n - \u003cvar translate=\"no\"\u003eFILTER\u003c/var\u003e: optional but recommended. A text field for filtering your search using a filter expression. The default value is an empty string. For more information about using the `filter` field, see [Filter generic search\n for structured or unstructured data](/generative-ai-app-builder/docs/filter-search-metadata) and [Filter website search](/generative-ai-app-builder/docs/filter-website-search).\n - \u003cvar translate=\"no\"\u003eBOOST_SPEC\u003c/var\u003e: optional. A specification to boost or bury documents. Values:\n - `BOOST`: a floating point number in the range \\[-1,1\\]. When the value is negative, results are demoted (they appear lower down in the results). When the value is positive, results are promoted (they appear higher up in the results).\n - `CONDITION`: a [text filter expression](/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax) to select the documents to which boost is applied. The filter must evaluate to a boolean value. To learn about boost for structured search, see [Boost search results](/generative-ai-app-builder/docs/boost-search-results).\n\n You should receive a JSON response similar to the following truncated response.\n The response contains itemized search results listed in the order that's\n determined by the fields set in the search request.\n\n #### Response\n\n ```\n {\n \"results\": [\n {\n \"id\": \"DOCUMENT_ID\",\n \"document\": {\n \"name\": \"projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID\",\n \"id\": \"DOCUMENT_ID\",\n \"structData\": {},\n \"derivedStructData\": {\n \"displayLink\": \"LINK_TO_BE_DISPLAYED\",\n \"link\": \"DOCUMENT_URL\",\n …\n }\n }\n },\n {\n \"id\": \"DOCUMENT_ID\",\n \"document\": {\n \"name\": \"projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID\",\n \"id\": \"DOCUMENT_ID\",\n \"structData\": {},\n \"derivedStructData\": {\n \"displayLink\": \"LINK_TO_BE_DISPLAYED\",\n \"link\": \"DOCUMENT_URL\",\n …\n }\n }\n }\n …\n ]\n }\n ```\n\n \u003cbr /\u003e\n\n\u003cbr /\u003e"]]
