Richten Sie ein Google Cloud -Projekt ein, aktivieren Sie KI-Anwendungen und richten Sie die Zugriffssteuerung für Ihr Projekt ein. Sie können ein vorhandenes Google Cloud Projekt verwenden, falls Sie bereits eines haben.
Bereiten Sie Ihre Daten für den Import in Vertex AI Search vor.
In Apps für die Mediensuche werden die folgenden Daten verwendet:
Strukturierte Mediendaten Erforderlich. Lade Metadaten zu deinen Medieninhalten wie Titel, Beschreibungen und URIs an den Speicherort deiner Medien hoch. Vertex AI Search bietet ein vordefiniertes Schema für Medien.
Alternativ können Sie auch Ihr eigenes Schema verwenden.
Nutzerereignisse Erforderlich. Nutzerereignisse tragen zum Ranking der Suchergebnisse bei.
Erstellen Sie eine App und einen Datenspeicher und importieren Sie dann Ihre Mediendaten.
Wie Sie Mediendaten importieren, hängt davon ab, woher Sie sie importieren. Wenn sich Ihre Daten beispielsweise in Cloud Storage befinden, können Sie sie über die Console oder die API importieren, indem Sie den Speicherort des Buckets angeben.
Vertex AI Search bietet viele Konfigurationsoptionen. Einige Optionen hängen davon ab, ob Sie ein Such-Widget bereitstellen möchten.
Aktionen
Je nach Anwendungsfall und je nachdem, ob Sie das vorkonfigurierte Such-Widget bereitstellen oder Such-API-Aufrufe in Ihren eigenen Code einbinden möchten, bietet Vertex AI Search mehrere Konfigurationsoptionen.
Sie können in Ihre Website ein Such-Widget einbetten, das automatisch eine Suchleiste und eine maximierbare Suchoberfläche bereitstellt. Wenn Sie das Such-Widget bereitstellen möchten, konfigurieren Sie Folgendes:
Wenn Sie Such-API-Aufrufe in Ihren Server oder Ihre Anwendung einbinden möchten, anstatt das Widget zu verwenden, können Sie die Sucheinstellungen mit den folgenden Optionen konfigurieren:
Feldeinstellungen Aktualisieren Sie die Feldeinstellungen für strukturierte Daten oder unstrukturierte Daten mit Metadaten, um die Verwendung von Metadaten für die Suche in Vertex AI Search zu optimieren. Weitere Informationen finden Sie unter Felder für die Suche konfigurieren.
Automatische Vervollständigung Je nach Daten können Sie Vorschläge zur automatischen Vervollständigung basierend auf Dokumentinhalten, Feldern, Suchverlauf oder Nutzerereignissen einrichten. Siehe Automatische Vervollständigung konfigurieren.
Bereitstellungseinstellungen Sie können festlegen, wann Suchergebnisse hervorgehoben, ausgeblendet, gefiltert oder weitergeleitet werden oder ob bestimmte Suchanfragen mit anderen verknüpft werden. Weitere Informationen finden Sie unter Auslieferungssteuerung für die Suche konfigurieren.
Search-as-you-type. Wenn in Ihrer App umständliche Eingabegeräte wie Fernsehfernbedienungen verwendet werden, können Sie die Funktion „Suchen, während Sie tippen“ aktivieren. Weitere Informationen finden Sie unter Ergebnisse der Sucheingabe für eine Medien-App abrufen.
Wenn Sie Ihre App bereitstellen möchten, indem Sie Such-API-Aufrufe in Ihren eigenen Code einbinden, können Sie die Filterung und Aufwertung für Ihre Suchergebnisse konfigurieren.
Sie können sich eine Vorschau der Suchergebnisse ansehen, um zu prüfen, ob Ihre App-Konfigurationen wie erwartet funktionieren.
Aktionen
Eine Vorschau Ihrer Suchergebnisse können Sie in der Console oder in der API aufrufen.
Console. Auf der Seite Vorschau der Konsole für KI-Anwendungen können Sie sich ansehen, wie sich die Konfiguration des Such-Widgets auf Ihre Ergebnisse auswirkt. Eine Anleitung für die Console findest du unter Suchergebnisse für Medien abrufen.
API: Wenn Sie API-Aufrufe in Ihre Anwendung einbinden, können Sie API-Aufrufe ausführen, um eine Vorschau Ihrer Suchkonfigurationen zu erhalten. Eine REST-Anleitung findest du unter Suchergebnisse für Medien abrufen.
Wenn Sie mit der Vorabversion Ihrer Mediensuch-App zufrieden sind, können Sie sie auf Ihrer Website bereitstellen und so für Ihre Nutzer freigeben.
Aktionen
Sie haben folgende Möglichkeiten, Ihre Such-App bereitzustellen:
Such-Widget in Ihre Website einbetten Vertex AI Search bietet Code, den Sie in Ihre Website oder Webanwendung kopieren können. Dadurch wird das Such-Widget bereitgestellt. Sie können sich in der Konsole eine Vorschau der Suchergebnisse ansehen.
Weitere Informationen finden Sie unter Such-Widget auf einer Webseite einfügen.
Such-API-Aufrufe in Ihren Server oder Ihre Anwendung einbinden Wenn Sie die Darstellung Ihrer Suchergebnisse vollständig steuern möchten, können Sie API-Aufrufe in Ihren Server oder Ihre Anwendungen einbinden. Weitere Informationen zu API-Aufrufen finden Sie unter Suchergebnisse abrufen. Ressourcen zu Clientbibliotheken finden Sie unter Clientbibliotheken für KI-Anwendungen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
