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.

Membuat aplikasi

Konsol

1. Di Google Cloud konsol, 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 konfigurasi hal berikut:

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

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

      Peringatan: Mengaktifkan fitur ini 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 memiliki penyimpanan data. Jika tidak memiliki penyimpanan data, Anda harus menghubungkan sumber data Google atau sumber data pihak ketiga ke aplikasi.

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

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

   1. Di Google Cloud konsol, 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 Utama: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah engine dalam konteks API. Engine Gemini Enterprise adalah mesin penelusuran 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 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 hal berikut dalam payload JSON:

     "includeCrossDomainDocuments": true
     

     Peringatan: Mengaktifkan fitur ini meningkatkan paparan 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 Anda, lihat Menghubungkan sumber data Google dan Menghubungkan sumber data pihak ketiga.

• Untuk melihat pratinjau hasil penelusuran, buka Configurations > Search UI di Google Cloud konsol 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.