Configure um projeto do Google Cloud , ative os aplicativos de IA e configure o controle de acesso para seu projeto. É possível usar um projeto do Google Cloud atual se você já tiver um.
Prepare seus dados para importação na Vertex AI para Pesquisa.
Os apps de pesquisa de mídia usam os seguintes dados:
Dados de mídia estruturados. Obrigatório. Faça upload de informações de metadados sobre seu
conteúdo de mídia, como títulos, descrições e URIs para o local da
mídia. A Vertex AI para Pesquisa oferece um esquema predefinido para mídia.
Você também pode usar seu próprio esquema.
Eventos do usuário. Obrigatório. Os eventos do usuário ajudam a classificar os resultados da pesquisa.
Crie um app e um repositório de dados e importe seus dados de mídia.
A forma de importar dados de mídia depende de onde você está fazendo a importação. Por exemplo, se os dados estiverem no Cloud Storage, você poderá importá-los usando o console ou a API, fornecendo o local do bucket dos dados.
A Vertex AI para Pesquisa oferece muitas opções de configuração. Algumas opções
dependem se você planeja implantar um widget de pesquisa.
Ações
Dependendo do seu caso de uso e se você planeja implantar o widget de pesquisa
padrão ou integrar chamadas de API de pesquisa ao seu próprio código,
a Vertex AI para Pesquisa oferece várias opções de configuração.
É possível incorporar um widget de pesquisa ao site para fornecer automaticamente
uma barra de pesquisa e uma interface de pesquisa expansível. Se você planeja implantar o
widget de pesquisa, configure o seguinte:
Se você planeja integrar chamadas de API de pesquisa ao servidor ou aplicativo
em vez de usar o widget, é possível configurar as configurações de pesquisa usando
as seguintes opções:
Configurações do campo. Para dados estruturados ou não estruturados com metadados, atualize as configurações de campo para refinar como a Vertex AI para Pesquisa usa metadados na pesquisa. Consulte Configurar campos para
pesquisa.
Preenchimento automático. Dependendo dos seus dados, configure as sugestões de preenchimento automático com base no conteúdo do documento, nos campos, no histórico de pesquisa ou nos eventos do usuário. Consulte
Configurar o preenchimento automático.
Controles de veiculação. Controle quando os resultados da pesquisa
são impulsionados, ocultos, filtrados ou redirecionados ou se determinadas consultas
são associadas a outras. Consulte Configurar controles de veiculação
para pesquisa.
Search-as-you-type. Se o app usa dispositivos de entrada estranhos, como controles remotos
de TV, ative o recurso de pesquisa conforme você digita. Consulte Pesquisar
enquanto digita em um app de mídia.
Se você planeja implantar seu app integrando chamadas de API de pesquisa ao seu próprio
código, configure a filtragem e o aumento para os resultados da pesquisa.
Você pode conferir os resultados da pesquisa para verificar se as configurações do app estão
funcionando conforme o esperado.
Ações
Para conferir os resultados da pesquisa, use o console ou a API.
Console. Use a página Prévia do console de aplicativos de IA para conferir
como as configurações do widget de pesquisa afetam seus resultados. Consulte as instruções do console
em Receber resultados de
pesquisa para mídia.
API. Se você estiver integrando chamadas de API ao seu aplicativo,
faça chamadas de API para visualizar as configurações de pesquisa. Consulte as instruções do REST
em Pegar resultados
da pesquisa para mídia.
Quando estiver satisfeito com a versão de visualização do app de pesquisa de mídia, compartilhe
com os usuários implantando-o no seu site.
Ações
É possível implantar o app de pesquisa de duas maneiras:
Incorpore o widget de pesquisa ao seu site. A Vertex AI para Pesquisa
oferece um código que pode ser copiado para seu site ou aplicativo da Web. Isso
implanta o widget de pesquisa. É possível visualizar os resultados da pesquisa no console.
Consulte Adicionar o widget de pesquisa a uma página da Web.
Integrar chamadas de API de pesquisa ao servidor ou aplicativo. Para ter controle total
sobre como os resultados da pesquisa são exibidos, é possível integrar chamadas de API
ao servidor ou aos aplicativos. Para mais informações sobre como fazer
chamadas de API, consulte Receber resultados da pesquisa. Para recursos de biblioteca de cliente, consulte Bibliotecas de cliente de 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-09-03 UTC."],[[["\u003cp\u003eThis page outlines the steps to implement a media search application using Vertex AI Search, including project setup, data preparation, and app creation.\u003c/p\u003e\n"],["\u003cp\u003ePreparing data involves uploading structured media data and user events, following specified schemas for effective search result ranking.\u003c/p\u003e\n"],["\u003cp\u003eThe process includes creating a media app and data store, importing media data from various sources like Cloud Storage, and setting up real-time and historical user event recording.\u003c/p\u003e\n"],["\u003cp\u003eVertex AI Search offers flexible configuration options for search settings, allowing for deployment of a search widget or integration of search API calls into existing code.\u003c/p\u003e\n"],["\u003cp\u003eAfter configuring and previewing search results, you can deploy the app by embedding the search widget or integrating API calls and maintain the app by regularly updating the structured data.\u003c/p\u003e\n"]]],[],null,["# Media search checklist\n\nThis page provides a checklist of the steps required to implement a media search app.\n\n\u003cbr /\u003e\n\nIf you're new to Vertex AI Search, consider following the [Get started\nwith media search](/generative-ai-app-builder/docs/try-media-search) quickstart\ntutorial to create a sample app. \n\n\n### [Set up a Google Cloud\nproject](#set-up-project)\n\nSet up a Google Cloud project, turn on AI Applications, and set up access\ncontrol for your project. You can use an existing Google Cloud project if you\nhave one already.\n\n### Actions\n\n1. Complete the steps in [Before you begin](/generative-ai-app-builder/docs/before-you-begin). \n\n### [Prepare your data](#prepare-data)\n\nPrepare your data for importing to Vertex AI Search.\n\nMedia search apps use the following data:\n\n- **Structured media data.** Required. Upload metadata information about your\n media content, such as titles, descriptions, and URIs to the location of your\n media. Vertex AI Search provides a predefined schema for media.\n Alternatively, you can use your own schema.\n\n- **User events.** Required. User events help rank search results.\n\n### Actions\n\n1. Review information about media data and data stores and prepare your data\n according to the required schemas and fields in [About media documents and\n data stores](/generative-ai-app-builder/docs/media-documents). If you are\n using your own schema, also see [Example schema as a JSON\n object](/generative-ai-app-builder/docs/provide-schema#example-schema) and\n [structured data](/generative-ai-app-builder/docs/prepare-data#structured).\n\n2. Review media user event requirements in [About media user\n events](/generative-ai-app-builder/docs/media-user-events).\n\n### [Create your app and import your data](#import-data)\n\nCreate an app and data store and then import your media data.\n\nHow you import media data depends on where you're importing it from. For\nexample, if your data is in Cloud Storage, you can import it using the\nconsole or the API by providing the bucket location of your data.\n\n### Actions\n\n1. [Create a media data store](/generative-ai-app-builder/docs/create-data-store-media).\n\n2. [Create media apps](/generative-ai-app-builder/docs/create-app-media).\n\n3. [Bulk import historical user events](/generative-ai-app-builder/docs/import-user-events) so that\n your app can start training.\n\n4. [Set up real-time user event recording](/generative-ai-app-builder/docs/record-user-events).\n\n### [Configure your search\nsettings](#configure-settings)\n\nVertex AI Search provides many configuration options. Some options\ndepend on whether you plan to deploy a search widget.\n\n### Actions\n\nDepending on your use case and whether you plan to deploy the out-of-the-box\nsearch widget or integrate search API calls into your own code,\nVertex AI Search provides several options for configuration.\n\n1. You can embed a search widget into your website that automatically provides\n a search bar and expandable search interface. If you plan to deploy the\n search widget, configure the following:\n\n - **Search widget results.** See [Configure results for the\n search widget](/generative-ai-app-builder/docs/configure-widget-attributes).\n\n - **Search widget facets.** See [Configure facets\n for the search widget](/generative-ai-app-builder/docs/configure-widget-facets).\n\n2. If you plan to integrate search API calls into your server or application\n instead of using the widget, you can configure your search settings using\n the following options:\n\n - **Field settings.** For structured data or for unstructured data with\n metadata, update field settings to refine how Vertex AI Search\n uses metadata for search. See [Configure fields for\n search](/generative-ai-app-builder/docs/configure-search-attributes).\n\n - **Autocomplete.** Depending on your data, set up autocomplete suggestions\n based on document content, fields, search history, or user events. See\n [Configure autocomplete](/generative-ai-app-builder/docs/configure-autocomplete).\n\n - **Serving controls.** Control when search results\n are boosted, buried, filtered, or redirected, or whether certain queries\n are associated with other queries. See [Configure serving\n controls for search](/generative-ai-app-builder/docs/configure-serving-controls).\n\n - **Search-as-you-type.** If your app uses awkward input devices such as TV\n remote controls, you can enable the search-as-you-type feature. See [Get\n search-as-you-type results for a media\n app](/generative-ai-app-builder/docs/preview-search-results#media-search).\n\n### [Filter and boost your\nsearch results](#configure-results)\n\nIf you plan to deploy your app by integrating search API calls into your own\ncode, you can configure filtering and boosting for your search results.\n\n### Actions\n\n1. [Filter media search](/generative-ai-app-builder/docs/filter-media-search).\n\n2. [Boost search results](/generative-ai-app-builder/docs/boost-search-results).\n\n### [Preview search\nresults](#preview-results)\n\nYou can preview your search results to check if your app configurations are\nworking as expected.\n\n### Actions\n\n1. To preview your search results, use the console or the API.\n\n - **Console.** Use the AI Applications console **Preview** page to preview\n how search widget configurations affect your results. See the **Console**\n instructions in [Get search\n results for media](/generative-ai-app-builder/docs/get-media-search-results).\n\n - **API** . If you're integrating API calls into your application,\n make API calls to preview your search configurations. See the **REST**\n instructions in [Get search\n results for media](/generative-ai-app-builder/docs/get-media-search-results).\n\n### [Deploy your\napp](#preview-results)\n\nWhen you're happy with the preview version of your media search app, share it\nwith your users by deploying it to your website.\n\n### Actions\n\n1. You can deploy your search app in either of the following ways:\n\n - **Embed the search widget into your website.** Vertex AI Search\n provides code that you can copy into your website or web application. This\n deploys the search widget. You can preview search results in the console.\n See [Add the search widget to a webpage](/generative-ai-app-builder/docs/add-widget).\n\n - **Integrate search API calls into your server or application.** For full\n control over how your search results are displayed, you can integrate API\n calls into your server or applications. For more information about making\n API calls, see [Get search results](/generative-ai-app-builder/docs/preview-search-results). For client library resources, see [AI Applications client\n libraries](/generative-ai-app-builder/docs/libraries).\n\n### [Maintain your app](#maintain-data)\n\nYou can maintain your app to ensure that latest and necessary data is available\nin your data store.\n\n### Actions\n\n1. [Refresh your structured\n data](/generative-ai-app-builder/docs/refresh-data#refresh-structured)."]]
