Buat aplikasi

Halaman ini menjelaskan cara membuat aplikasi Gemini Enterprise.

Catatan: Anda tidak dapat menghubungkan penyimpanan data situs ke aplikasi penelusuran dan asisten Gemini Enterprise Anda.

Buat aplikasi

Konsol

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.
2. Di halaman Aplikasi, klik Buat aplikasi.
3. Di kolom Nama aplikasi, masukkan nama untuk aplikasi Anda.
4. Untuk memperbarui ID aplikasi yang dibuat secara otomatis, klik Edit. ID aplikasi tidak dapat diupdate setelah Anda membuat aplikasi.
5. Di bagian Pilih lokasi, pilih Multi-region. Gunakan multi-region global (Global) default kecuali jika Anda perlu membatasi data ke geografi tertentu.

6. Opsional. Luaskan Advanced options dan konfigurasi hal berikut:

   1. Di kolom Nama perusahaan, masukkan nama eksternal perusahaan Anda, tanpa menyertakan akhiran seperti Inc. atau LLC. Hal ini membantu LLM mengidentifikasi perusahaan yang diwakili aplikasi.

   2. Jika Anda menghubungkan penyimpanan data Google Drive, Anda dapat mengizinkan aplikasi menelusuri dokumen di luar organisasi Anda. Untuk mengaktifkan fitur ini, centang kotak Sertakan dokumen lintas domain.

      Peringatan: Mengaktifkan fitur ini meningkatkan risiko keamanan, seperti serangan injeksi perintah dari dokumen eksternal dan manipulasi hasil penelusuran.

7. Klik Create.

REST

Sebelum menggunakan command line untuk membuat aplikasi, Anda harus memiliki penyimpanan data yang ada. Jika tidak memiliki penyimpanan data, Anda harus menghubungkan sumber data Google atau sumber data pihak ketiga ke aplikasi Anda.

Untuk menggunakan metode engines.create guna membuat aplikasi dari command line, ikuti langkah-langkah berikut:

1. Temukan ID penyimpanan data Anda. Jika Anda sudah memiliki ID penyimpanan data, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman Gemini Enterprise dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama penyimpanan data Anda.

   3. Di halaman Data untuk penyimpanan data Anda, dapatkan ID penyimpanan data.

2. Buat aplikasi dan hubungkan ke penyimpanan data.

   Istilah Penting: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin telusur generik dengan kolom app_type disetel ke 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"
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID project Anda.
   • APP_ID: ID aplikasi yang ingin Anda buat.
   • APP_DISPLAY_NAME: nama tampilan aplikasi yang ingin Anda buat.
   • DATA_STORE_ENTITY_ID: jika penyimpanan data Anda berisi entity, gunakan ID entity tertentu. Jika penyimpanan data Anda tidak berisi entitas, gunakan ID penyimpanan data.

   Anda dapat menyertakan konfigurasi opsional berikut dalam payload JSON:

   • Untuk memberikan nama eksternal perusahaan Anda, sertakan hal berikut:

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

     Ganti COMPANY_NAME dengan nama eksternal perusahaan Anda, tanpa menyertakan akhiran seperti Inc. atau LLC.

   • Jika menghubungkan penyimpanan data Google Drive, Anda dapat mengizinkan aplikasi menelusuri dan mengindeks dokumen di luar organisasi Anda. Untuk mengaktifkan fitur ini, sertakan kode berikut dalam payload JSON:

     "includeCrossDomainDocuments": true
     

     Peringatan: Mengaktifkan fitur ini meningkatkan paparan terhadap risiko keamanan, seperti injeksi perintah dari dokumen eksternal dan potensi manipulasi hasil penelusuran.

   Contoh perintah dan hasil

   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"
     }
   }
   

Langkah berikutnya

• Untuk menghubungkan aplikasi ke penyimpanan data yang ada, lihat Menghubungkan aplikasi ke penyimpanan data yang ada.

• Untuk menghubungkan sumber data, lihat Menghubungkan sumber data Google dan Menghubungkan sumber data pihak ketiga.

• Untuk melihat pratinjau hasil penelusuran, buka Configurations > Search UI di konsol Google Cloud atau lihat Mendapatkan hasil penelusuran dari StreamAssist.

• Untuk mengonfigurasi aplikasi web, seperti mengaktifkan dan menonaktifkan setelan seperti pemilih model dan generator gambar, lihat Mengelola fitur aplikasi web.