데이터 스토어에 연결하려면 데이터 스토어 페이지에서 구조화된 데이터가 포함된 데이터 스토어를 선택하거나 데이터 스토어를 만들면 됩니다.
다음 중 하나를 수행합니다.
사용 가능한 기존 데이터 스토어가 있는 경우 이를 선택합니다. 데이터 스토어는 하나의 앱에만 연결할 수 있으며 나중에 앱에서 삭제할 수 없습니다.
새 구조화된 데이터 스토어를 만들고 여기에 데이터를 수집합니다. 데이터 스토어 만들기를 클릭하고 열리는 새 데이터 스토어 만들기 창의 단계를 따릅니다. 그런 다음 새 데이터 스토어를 선택합니다. 데이터 스토어를 만드는 방법에 관한 자세한 내용은 맞춤 추천 데이터 스토어 만들기를 참고하세요.
선택사항: 사용할 수 없는 데이터 스토어 목록을 보려면 이유 알아보기를 클릭합니다.
데이터 스토어 목록과 사용 불가 이유가 포함된 테이블이 표시됩니다. 데이터 스토어를 사용할 수 없는 몇 가지 이유는 다음과 같습니다.
데이터 스토어 유형은 하나의 앱에만 연결할 수 있으며 데이터 스토어가 이미 연결되어 있습니다.
데이터 스토어와 앱이 서로 다른 리전에 있습니다.
데이터 스토어와 앱의 유형이 다릅니다. 예를 들어 미디어 데이터 스토어를 맞춤 추천 앱에 연결할 수 없습니다.
데이터 스토어에는 기본 웹사이트 검색이 있지만 맞춤 추천 앱에는 고급 웹사이트 색인 생성이 있는 데이터 스토어가 필요합니다.
만들기를 클릭합니다.
REST
명령줄을 사용하여 앱을 만들려면 기존 데이터 스토어가 있어야 합니다. 데이터 스토어가 없는 경우 맞춤 추천 데이터 스토어 만들기의 단계에 따라 데이터 스토어를 만듭니다.
명령줄을 사용하여 맞춤 콘텐츠 앱을 만들려면 다음 단계를 따르세요.
데이터 스토어 ID를 찾습니다. 데이터 스토어 ID가 이미 있는 경우 다음 단계로 건너뜁니다.
Google Cloud 콘솔에서 AI 애플리케이션 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[[["\u003cp\u003eThis feature is currently in Preview, subject to the Pre-GA Offerings Terms, which may include limited support and potential incompatibility with other pre-GA versions.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a generic recommendations app using the Google Cloud console by navigating to the Agent Builder page, creating a new app, and connecting it to a structured data store, which can be either an existing one or a new one that you create.\u003c/p\u003e\n"],["\u003cp\u003eTo create a recommendations app via the command line (REST), you must first have an existing data store, and you will need to use \u003ccode\u003ecurl\u003c/code\u003e with your project ID, app ID, app display name, and data store ID in the request.\u003c/p\u003e\n"],["\u003cp\u003eA data store can be connected to only one app, and once connected, it cannot be removed from that app.\u003c/p\u003e\n"],["\u003cp\u003eWhen connecting a data store to an app, it may be unavailable due to various reasons, such as already being connected to another app, being in a different region, or being an incompatible data store type.\u003c/p\u003e\n"]]],[],null,["# Create a custom recommendations app\n\n| **Note:** This feature is a Preview offering, subject to the \"Pre-GA Offerings Terms\" of the [GCP Service Specific Terms](https://cloud.google.com/terms/service-terms). Pre-GA products and features may have limited support, and changes to pre-GA products and features may not be compatible with other pre-GA versions. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages). Further, by using this feature, you agree to the [Generative AI Preview terms and conditions](https://cloud.google.com/trustedtester/aitos) (\"Preview Terms\"). For this feature, you can process personal data as outlined in the [Cloud Data Processing Addendum](https://cloud.google.com/terms/data-processing-terms), subject to applicable restrictions and obligations in the Agreement (as defined in the Preview Terms).\n|\n| \u003cbr /\u003e\n|\nThis page describes how to create a custom recommendations app. \n\n### Console\n\nTo use the Google Cloud console to create a custom recommendations app, follow\nthese steps:\n\n1. In the Google Cloud console, go to the **AI Applications** page.\n\n [AI Applications](https://console.cloud.google.com/gen-app-builder/engines)\n2. On the **Apps** page, click **Create app**.\n\n3. On the **Create App** page, under **Recommendations engine** , click\n **Create**.\n\n4. In the **Your app name** field, enter a name for your app. Your app ID\n appears under the engine name.\n\n5. Optional: Click **Edit** to edit your app ID.\n\n6. Click **Continue**.\n\n7. To connect to a data store, on the **Data Stores** page, select a data store\n that contains structured data or choose to create a data store.\n Do one of the following:\n\n - Select an existing data store, if one is available. A data store can be\n attached to only one app, and it can't be removed from the app later.\n\n - Create a new structured data store and ingest data into it. Do this by\n clicking **Create data store** and following the steps in the **Create a\n new data store** pane that opens. Then select your new data store. For\n more information about creating a data store, see [Create a\n custom recommendations data store](/generative-ai-app-builder/docs/create-data-store-recommendations).\n\n8. Optional: To see a list of unavailable data stores, click **Learn why**.\n\n A table is displayed with a list of data stores and the reason why they are\n unavailable. Here are some of the reasons why a data store might be\n unavailable:\n - Your data store type allows connection to only one app and the data store is already connected.\n - Your data store and your app are in different regions.\n - Your data store and your app are of different types. For example, you cannot connect a media data store to a custom recommendations app.\n - Your data store has basic website search, whereas a custom recommendations app requires a data store with advanced website indexing.\n9. Click **Create**.\n\n### REST\n\nBefore you use the command line to create an app, you must have an existing data\nstore. If you don't have a data store, create one following the steps in\n[Create a custom recommendations data store](/generative-ai-app-builder/docs/create-data-store-recommendations).\n| **Note:** This feature is experimental.\n\nTo use the command line to create a recommendations app, follow these steps:\n\n1. Find your data store ID. If you already have your data store\n ID, skip to the next step.\n\n 1. In the Google Cloud console, go to the **AI Applications** page and\n in the navigation menu, click **Data Stores**.\n\n [Go to the Data Stores page](https://console.cloud.google.com/gen-app-builder/data-stores)\n 2. Click the name of your data store.\n\n 3. On the **Data** page for your data store, get the data store ID.\n\n2. Create an app and connect it to a structured data store. A data store\n can be attached to only one app and can't be removed from the app later.\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 \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Goog-User-Project: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\" \\\n \"https://discoveryengine.googleapis.com/v1alpha/projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/locations/global/collections/default_collection/engines?engineId=\u003cvar translate=\"no\"\u003eAPP_ID\u003c/var\u003e\" \\\n -d '{\n \"displayName\": \"\u003cvar translate=\"no\"\u003eAPP_DISPLAY_NAME\u003c/var\u003e\",\n \"dataStoreIds\": [\"\u003cvar translate=\"no\"\u003eDATA_STORE_ID\u003c/var\u003e\"],\n \"solutionType\": [\"SOLUTION_TYPE_RECOMMENDATION\"],\n \"similarDocumentsConfig\": {}\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 recommendations app that you want to create.\n - \u003cvar translate=\"no\"\u003eAPP_DISPLAY_NAME\u003c/var\u003e: the display name of the recommendations app that you want to create.\n - \u003cvar translate=\"no\"\u003eDATA_STORE_ID\u003c/var\u003e: the ID of an existing recommendations data store that you want to add to the recommendations app.\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- To preview how your recommendations appear, see [Get recommendations](/generative-ai-app-builder/docs/preview-recommendations)."]]
