建立應用程式

本頁說明如何建立 Gemini Enterprise 應用程式。

注意： 您無法將網站資料儲存庫連結至 Gemini Enterprise 搜尋和助理應用程式。

建立應用程式

控制台

1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。
2. 在「應用程式」頁面中，按一下「建立應用程式」。
3. 在「App name」(應用程式名稱) 欄位中輸入應用程式名稱。
4. 如要更新自動產生的應用程式 ID，請按一下「編輯」。應用程式建立完成後，應用程式 ID 就無法更新。
5. 在「選擇位置」部分中，選取「多區域」。除非需要將資料限制在特定地理位置，否則請使用預設的全球 (Global) 多區域。

6. 選用。展開「Advanced options」(進階選項)，然後設定下列項目：

   1. 在「公司名稱」欄位中，輸入貴公司的外部名稱，並省略 Inc 或 LLC 等後置字元。這有助於 LLM 識別應用程式代表的公司。

   2. 如果連結 Google 雲端硬碟資料儲存庫，您可以允許應用程式搜尋貴機構以外的文件。如要啟用這項功能，請勾選「包含跨網域文件」核取方塊。

      警告： 啟用這項功能會增加安全性風險，例如有心人士透過外部文件注入提示詞，以及搜尋結果可能遭到操控。

7. 點選「建立」。

REST

使用指令列建立應用程式前，必須先有現有的資料存放區。如果沒有資料儲存庫，請連結 Google 資料來源或第三方資料來源至應用程式。

如要使用 engines.create 方法透過指令列建立應用程式，請按照下列步驟操作：

1. 找出資料儲存庫 ID。如果已有資料儲存庫 ID，請跳到下一個步驟。

   1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面，然後點按導覽選單中的「Data Stores」(資料儲存庫)。

      前往「Data Stores」頁面

   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 雲端硬碟資料儲存庫，您可以允許應用程式搜尋及建立貴機構以外的文件索引。如要啟用這項功能，請在 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

• 如要設定網頁應用程式，例如開啟及關閉模型選取器和圖像生成器等設定，請參閱「管理網頁應用程式功能」。