일반 추천 앱 만들기

콘솔

Google Cloud 콘솔을 사용하여 일반 추천 앱을 만들려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder

2. 앱 페이지에서 앱 만들기를 클릭합니다.

3. 앱 만들기 페이지의 추천 엔진에서 만들기를 클릭합니다.

4. 앱 이름 필드에 앱 이름을 입력합니다. 앱 이름 아래에 앱 ID가 표시됩니다.

5. (선택사항) 수정을 클릭하여 앱 ID를 수정합니다.

6. 계속을 클릭합니다.

7. 데이터 스토어에 연결하려면 데이터 스토어 페이지에서 이전에 만든 데이터 스토어를 선택하거나 새 데이터 스토어를 만듭니다. 다음 중 하나를 수행합니다.

   • 사용 가능한 기존 데이터 스토어가 있는 경우 이를 선택합니다. 데이터 스토어는 하나의 앱에만 연결할 수 있으며 나중에 앱에서 삭제할 수 없습니다.

   • 새 데이터 스토어를 만들고 여기에 데이터를 수집합니다. 데이터 스토어 만들기를 클릭하고 열리는 새 데이터 스토어 만들기 창의 단계를 따릅니다. 그런 다음 새 데이터 스토어를 선택합니다. 데이터 스토어를 만드는 방법에 관한 자세한 내용은 일반 추천 데이터 스토어 만들기를 참고하세요.

8. 선택사항: 사용할 수 없는 데이터 스토어 목록을 보려면 이유 알아보기를 클릭합니다.

   데이터 스토어 목록과 사용 불가 이유가 포함된 테이블이 표시됩니다. 데이터 스토어를 사용할 수 없는 몇 가지 이유는 다음과 같습니다.

   • 데이터 스토어 유형은 하나의 앱에만 연결할 수 있으며 데이터 스토어가 이미 연결되어 있습니다.
   • 데이터 스토어와 앱이 서로 다른 리전에 있습니다.
   • 데이터 스토어와 앱의 유형이 다릅니다. 예를 들어 미디어 데이터 스토어를 일반 추천 앱에 연결할 수 없습니다.
   • 데이터 스토어에는 기본 웹사이트 검색이 있지만 일반 맞춤 콘텐츠 앱에는 고급 웹사이트 색인 생성이 있는 데이터 스토어가 필요합니다.

9. 만들기를 클릭합니다.

REST

명령줄을 사용하여 앱을 만들려면 기존 데이터 스토어가 있어야 합니다. 데이터 스토어가 없는 경우 일반 추천 데이터 스토어 만들기의 단계에 따라 데이터 스토어를 만듭니다.

명령줄을 사용하여 맞춤 콘텐츠 앱을 만들려면 다음 단계를 따르세요.

1. 데이터 스토어 ID를 찾습니다. 데이터 스토어 ID가 이미 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 데이터 스토어 이름을 클릭합니다.

   3. 데이터 스토어의 데이터 페이지에서 데이터 스토어 ID를 가져옵니다.

2. 앱을 만들고 데이터 스토어에 연결합니다. 데이터 스토어는 하나의 앱에만 연결할 수 있으며 나중에 앱에서 삭제할 수 없습니다.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • APP_ID: 만들려는 맞춤 콘텐츠 앱의 ID입니다.
   • APP_DISPLAY_NAME: 만들려는 맞춤 콘텐츠 앱의 표시 이름입니다.
   • DATA_STORE_ID: 맞춤 콘텐츠 앱에 추가하려는 기존 맞춤 콘텐츠 데이터 스토어의 ID입니다.