Menyiapkan penyimpanan data Salesforce

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Salesforce ke Gemini Enterprise. Penyimpanan data menelusuri data Salesforce Anda secara real time dan memungkinkan pengguna akhir menindaklanjutinya menggunakan bahasa alami.

Sebelum memulai

Sebelum menyiapkan koneksi Salesforce, lakukan hal berikut:

1. Berikan peran Discovery Engine Editor (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:

   1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM

   2. Temukan akun pengguna, lalu klik edit Edit.
   3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

2. Minta administrator Salesforce Anda mengaktifkan server MCP SObject All di organisasi Salesforce yang Anda hubungkan, dan konfigurasikan metode autentikasi yang Anda pilih:

   • OAuth 2.0 (Google Managed) (default): Instal paket terkelola Gemini Enterprise - Salesforce Connector dari Salesforce AppExchange ke organisasi tersebut. Anda tidak memerlukan client ID atau rahasia klien.
   • OAuth 2.0 (Bring Your Own App): Buat aplikasi klien eksternal di organisasi tersebut dan dapatkan kunci konsumen (Client ID) dan rahasia konsumen (Client Secret).

   Sebelum aplikasi OAuth dikonfigurasi, pengguna tidak dapat mengizinkan konektor; sebelum server MCP SObject All aktif, tidak ada tindakan yang tersedia. Lihat Konfigurasi Salesforce.

3. Catat URL Domain Saya organisasi Anda, misalnya https://example.my.salesforce.com. Masukkan ini sebagai Instance URI. Untuk organisasi sandbox, gunakan My Domain sandbox, misalnya https://example--sandbox.sandbox.my.salesforce.com.

Menemukan URL My Domain Anda

Untuk menemukan URL Domain Saya yang akan dimasukkan sebagai Instance URI:

1. Di Salesforce, buka Setup.
2. Di kotak Quick Find, telusuri dan pilih My Domain.
3. Di bagian Current My Domain URL, salin URL, misalnya https://example.my.salesforce.com.

Untuk organisasi sandbox, lakukan hal ini di sandbox. URL Domain Saya terlihat seperti https://example--sandbox.sandbox.my.salesforce.com.

Membuat penyimpanan data Salesforce

Untuk membuat penyimpanan data Salesforce, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Pilih atau buat project Google Cloud .

3. Di menu navigasi, klik Penyimpanan data.

4. Klik Buat penyimpanan data.

5. Di bagian Source, telusuri Salesforce, lalu klik Select.

6. Di bagian Data:

   1. Di bagian Authentication settings, untuk Select your authentication method, pilih salah satu opsi berikut:

      • OAuth 2.0 (Google Managed) (default):
        1. Untuk Instance URI, masukkan URL My Domain situs Salesforce Anda, misalnya https://example.my.salesforce.com. Untuk organisasi sandbox, masukkan My Domain sandbox Anda, misalnya https://example--sandbox.sandbox.my.salesforce.com.
      • OAuth 2.0 (Bring Your Own App):
        1. Untuk Instance URI, masukkan URL My Domain situs Salesforce Anda, misalnya https://example.my.salesforce.com. Untuk organisasi sandbox, masukkan My Domain sandbox Anda, misalnya https://example--sandbox.sandbox.my.salesforce.com.
        2. Untuk Client ID, masukkan kunci pengguna aplikasi klien eksternal Salesforce Anda.
        3. Untuk Client Secret, masukkan rahasia konsumen aplikasi klien eksternal Salesforce Anda.
        4. Klik Verify Auth dan selesaikan login Salesforce untuk memverifikasi kredensial OAuth Anda.

   2. Di bagian Advanced options, jika Anda menghubungkan organisasi sandbox, pilih Use Sandbox. Salesforce kemudian akan menyajikan tindakan dari organisasi sandbox Anda.

   3. Klik Lanjutkan.

   4. Di bagian Entities to search, pilih entitas yang Anda inginkan untuk ditelusuri oleh Gemini Enterprise. Untuk Salesforce, pilih Salesforce MCP.

7. Klik Lanjutkan.

8. Opsional: Di bagian Actions, pilih tindakan buat, update, dan hapus yang ingin Anda aktifkan untuk pengguna, atau biarkan tidak dipilih untuk mempertahankan konektor hanya baca (tindakan hanya baca diaktifkan secara default). Anda juga dapat mengaktifkan atau menonaktifkan tindakan ini setelah membuat penyimpanan data; lihat Mengaktifkan tindakan.

9. Klik Lanjutkan.

10. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data Anda, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Setelan enkripsi:
       • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Buka halaman setelan untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu region untuk konektor pihak ketiga.
       • Pilih Google-managed encryption key atau Cloud KMS key.
       • Jika Anda memilih Cloud KMS key:
         • Dalam daftar Key management type, pilih jenis yang sesuai.
         • Di daftar Cloud KMS key, pilih kunci.
       Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

11. Klik Lanjutkan.

12. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

13. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Creating menjadi Active, penyimpanan data Salesforce siap digunakan.

Setelah membuat penyimpanan data, hubungkan penyimpanan data yang baru saja Anda buat ke aplikasi yang ada atau buat aplikasi baru dan hubungkan ke aplikasi baru, dan izinkan Gemini Enterprise untuk mengakses Salesforce sebelum menjalankan kueri apa pun.

Catatan: Langkah Authorize akan mengarahkan setiap pengguna ke halaman login Salesforce organisasi Anda untuk memberikan cakupan mcp_api dan refresh_token ke aplikasi OAuth. Langkah ini akan gagal jika paket terkelola Gemini Enterprise (untuk OAuth 2.0 (Google Managed)) atau aplikasi OAuth kustom Anda (untuk OAuth 2.0 (Bring Your Own App)) tidak dikonfigurasi di organisasi tersebut, atau jika profil pengguna tidak memiliki akses ke aplikasi. Konfigurasi IP statis per penyimpanan data tidak didukung; kebijakan IP login untuk autentikasi dan panggilan refresh token dikonfigurasi di aplikasi di Salesforce, dan panggilan data diizinkan menggunakan token akses pengguna yang valid. Lihat Menetapkan kebijakan IP login untuk aplikasi.

Aktifkan tindakan

Saat Anda membuat penyimpanan data Salesforce, tindakannya akan diisi otomatis di penyimpanan data. Tindakan hanya baca (Soql Query, Find, Get Object Schema, Get Related Records, List Recent Sobject Records, dan Get User Info) diaktifkan secara default dan selalu tersedia. Tindakan yang membuat, memperbarui, atau menghapus data (Create Sobject Record, Update Sobject Record, Update Related Record, Delete Sobject Record, dan Delete Related Record) dinonaktifkan secara default.

Jika Anda tidak mengaktifkan tindakan buat, update, atau hapus selama pembuatan penyimpanan data, Anda dapat mengaktifkannya kapan saja dengan mengikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka penyimpanan data Salesforce Anda.

2. Pilih tab Actions.

3. Pilih tindakan yang ingin Anda aktifkan (Create Sobject Record, Update Sobject Record, Update Related Record, Delete Sobject Record, atau Delete Related Record). Agar konektor tetap hanya baca, biarkan tindakan ini tidak dipilih.

4. Klik Enable actions.

Untuk mengetahui daftar tindakan, lihat Tindakan yang didukung.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi dari penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda memberikan otorisasi kepada Salesforce dan mengirim kueri penelusuran ke Gemini Enterprise:

• Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke server MCP Salesforce.
• Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

• String kueri Anda dikirim ke backend penelusuran pihak ketiga (server MCP Salesforce).
• Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
• Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin akan dikirim ke semua sumber data tersebut.
• Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke Salesforce. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri sesi Anda. Akibatnya, beberapa bagian histori kueri Anda mungkin juga disertakan dalam kueri yang dikirim ke server MCP Salesforce.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna untuk mengkueri data Salesforce Anda, buat aplikasi dan hubungkan ke penyimpanan data Salesforce.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.