Buat aplikasi

Halaman ini menjelaskan cara membuat aplikasi Gemini Enterprise.

Penting: Jika ingin menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) untuk melindungi data aplikasi, Anda harus mendaftarkan kunci CMEK sebelum membuat aplikasi. Aplikasi yang dibuat sebelum pendaftaran kunci tetap tidak terlindungi. Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

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

Buat aplikasi

Konsol

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.
2. Di halaman Apps, klik Create app.
3. Di kolom App name, masukkan nama untuk aplikasi Anda.
4. Untuk memperbarui ID aplikasi yang dibuat secara otomatis, klik Edit. ID aplikasi tidak dapat diperbarui setelah Anda membuat aplikasi.
5. Di bagian Choose a location, pilih Multi-region. Gunakan multi-region global (Global) default, kecuali jika Anda perlu membatasi data ke wilayah geografis tertentu.

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

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

   2. Jika 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 akan meningkatkan risiko keamanan, seperti injeksi perintah dari dokumen eksternal dan manipulasi hasil penelusuran.

7. Klik Create.

REST

Sebelum menggunakan command line untuk membuat aplikasi, Anda harus sudah memiliki penyimpanan data. 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 Penyimpanan Data

   2. Klik nama penyimpanan data Anda.

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

2. Membuat aplikasi dan menghubungkannya ke penyimpanan data.

   Istilah Kunci: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin telusur umum dengan kolom app_type yang ditetapkan 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 entity, 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 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 hal berikut dalam payload JSON:

     "includeCrossDomainDocuments": true
     

     Peringatan: Mengaktifkan fitur ini akan meningkatkan eksposur 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 konsolGoogle Cloud atau lihat Mendapatkan hasil penelusuran dari StreamAssist.

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