앱 만들기

이 페이지에서는 Gemini Enterprise 앱을 만드는 방법을 설명합니다.

참고: 웹사이트 데이터 스토어를 Gemini Enterprise 검색 및 어시스턴트 앱에 연결할 수는 없습니다.

앱 만들기

콘솔

1. 콘솔에서 Gemini Enterprise 페이지로 이동합니다. Google Cloud
2. 앱 페이지에서 앱 만들기 를 클릭합니다.
3. 앱 이름 필드에 앱 이름을 입력합니다.
4. 자동으로 생성된 앱 ID를 업데이트하려면 수정을 클릭합니다. 앱을 만든 후에는 앱 ID를 업데이트할 수 없습니다.
5. 위치 선택 섹션에서 멀티 리전 을 선택합니다. 데이터를 특정 지역으로 제한해야 할 이유가 없다면 기본값인 전역 (Global) 멀티 리전을 사용하세요.

6. 선택사항입니다. 고급 옵션 을 펼치고 다음을 구성합니다.

   1. 회사 이름 필드에 회사 외부 이름을 입력합니다. 이때 Inc 또는 LLC와 같은 접미사는 생략합니다. 이렇게 하면 LLM이 앱에서 대표하는 회사를 식별하는 데 도움이 됩니다.

   2. Google Drive 데이터 스토어를 연결하는 경우 앱에서 조직 외부의 문서를 검색하도록 허용할 수 있습니다. 이 기능을 사용 설정하려면 교차 도메인 문서 포함 체크박스를 선택합니다.

      경고: 이 기능을 사용 설정하면 외부 문서의 프롬프트 인젝션 및 검색 결과 조작과 같은 보안 위험이 증가합니다.

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

REST

명령줄을 사용하여 앱을 만들려면 기존 데이터 스토어가 있어야 합니다. 데이터 스토어가 없는 경우 Google 데이터 소스 또는 서드 파티 데이터 소스를 앱에 연결해야 합니다.

engines.create 메서드를 사용하여 명령줄에서 앱을 만들려면 다음 단계를 따르세요.

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

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

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

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

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

2. 앱을 만들고 데이터 스토어에 연결합니다.

   핵심 용어: Gemini Enterprise에서 앱 이라는 용어는 API라는 맥락에서 엔진 이라는 용어와 서로 바꿔서 사용할 수 있습니다. Gemini Enterprise 엔진은 app_type 필드가 APP_TYPE_INTRANET으로 설정된 일반 검색 엔진입니다.

   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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ENTITY_ID_1", "DATA_STORE_ENTITY_ID_2", "DATA_STORE_ENTITY_ID_3"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트의 ID입니다.
   • APP_ID: 만들려는 앱의 ID입니다.
   • APP_DISPLAY_NAME: 만들려는 앱의 표시 이름입니다.
   • DATA_STORE_ENTITY_ID: 데이터 스토어에 항목이 포함되어 있는 경우 특정 항목 ID를 사용합니다. 데이터 스토어에 항목이 포함되어 있지 않은 경우 데이터 스토어 ID를 대신 사용합니다.

   JSON 페이로드에 다음 선택적 구성을 포함할 수 있습니다.

   • 회사 외부 이름을 제공하려면 다음을 포함합니다.

     "commonConfig": {
       "companyName": "COMPANY_NAME"
     }
     

     COMPANY_NAME을 회사 외부 이름으로 바꿉니다. 이때 Inc 또는 LLC와 같은 접미사는 생략합니다.

   • Google Drive 데이터 스토어를 연결하는 경우 앱에서 조직 외부의 문서를 검색하고 색인을 생성하도록 허용할 수 있습니다. 이 기능을 사용 설정하려면 JSON 페이로드에 다음을 포함합니다.

     "includeCrossDomainDocuments": true
     

     경고: 이 기능을 사용 설정하면 외부 문서의 프롬프트 인젝션 및 검색 결과 조작 가능성과 같은 보안 위험에 노출될 가능성이 커집니다.

   명령어 및 결과 예시

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "my-app",
     "dataStoreIds": ["slack_1234567890123_conversation", "slack_1234567890123_file", "slack_1234567890123_message"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/operations/create-engine-12345678901234567890",
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
       "name": "projects/123456/locations/global/collections/default_collection/engines/my-app",
       "displayName": "my-app",
       "dataStoreIds": [
         "slack_1234567890123_conversation",
         "slack_1234567890123_file",
         "slack_1234567890123_message"
       ],
       "solutionType": "SOLUTION_TYPE_SEARCH",
       "searchEngineConfig": {
         "searchTier": "SEARCH_TIER_STANDARD"
       },
       "industryVertical": "GENERIC",
       "appType": "APP_TYPE_INTRANET"
     }
   }
   

다음 단계

• 앱을 기존 데이터 스토어에 연결하려면 앱을 기존 데이터 스토어에 연결을 참고하세요.

• 데이터 소스를 연결하려면 Google 데이터 소스 연결 및 서드 파티 데이터 소스 연결을 참고하세요.

• 검색 결과를 미리 보려면 콘솔에서 구성 > 검색 UI 로 이동하거나 StreamAssist에서 검색 결과 가져오기를 참고하세요. Google Cloud

• 모델 선택기 및 이미지 생성기와 같은 설정을 사용 설정 또는 사용 중지하는 등 웹 앱을 구성하려면 웹 앱 기능 관리를 참고하세요.