Connect to Salesforce untuk basis pengetahuan Anda

Salesforce adalah alat manajemen hubungan pelanggan (CRM) untuk mengelola tim dukungan, penjualan, dan pemasaran. Anda dapat terhubung ke instans Salesforce untuk basis pengetahuan Amazon Bedrock Anda dengan menggunakan AWS Management Console untuk Amazon Bedrock atau API CreateDataSource(lihat Amazon Bedrock didukung dan). SDKs AWS CLI

catatan

Konektor sumber data Salesforce dalam rilis pratinjau dan dapat berubah sewaktu-waktu.

Sumber data Salesforce tidak mendukung data multimodal, seperti tabel, bagan, diagram, atau gambar lainnya.

Saat ini, hanya penyimpanan vektor Amazon OpenSearch Tanpa Server yang tersedia untuk digunakan dengan sumber data ini.

Ada batasan berapa banyak file dan MB per file yang dapat dirayapi. Lihat Kuota untuk basis pengetahuan.

Fitur yang didukung

• Deteksi otomatis bidang dokumen utama

• Filter konten inklusi/pengecualian

• Konten tambahan disinkronkan untuk konten yang ditambahkan, diperbarui, dihapus

• OAuth 2.0 otentikasi

Prasyarat

Di Salesforce, pastikan Anda:

• Catat URL instans Salesforce Anda. Misalnya, https://company.salesforce.com/. Instans harus menjalankan Aplikasi Terhubung Salesforce.

• Buat Aplikasi Terhubung Salesforce dan konfigurasikan kredensional klien. Kemudian, untuk aplikasi yang Anda pilih, salin kunci konsumen (ID klien) dan rahasia konsumen (rahasia klien) dari OAuth pengaturan. Untuk informasi selengkapnya, lihat Dokumentasi Salesforce tentang Membuat Aplikasi Tersambung dan Mengonfigurasi Aplikasi Terhubung untuk Kredensyal Klien OAuth 2.0.

  catatan

  Untuk Salesforce Connected Apps, di bawah Client Credentials Flow, pastikan Anda mencari dan memilih nama pengguna atau alias untuk kredensyal klien Anda di bidang “Run As”.

Di AWS akun Anda, pastikan Anda:

• Simpan kredensyal otentikasi Anda secara AWS Secrets Manager rahasia dan catat Nama Sumber Daya Amazon (ARN) dari rahasianya. Ikuti petunjuk konfigurasi Koneksi di halaman ini untuk menyertakan pasangan nilai kunci yang harus disertakan dalam rahasia Anda.

• Sertakan izin yang diperlukan untuk terhubung ke sumber data Anda dalam kebijakan peran/izin AWS Identity and Access Management (IAM) untuk basis pengetahuan Anda. Untuk informasi tentang izin yang diperlukan untuk sumber data ini untuk ditambahkan ke IAM peran basis pengetahuan Anda, lihat Izin untuk mengakses sumber data.

catatan

Jika Anda menggunakan konsol, Anda dapat pergi ke AWS Secrets Manager untuk menambahkan rahasia Anda atau menggunakan rahasia yang ada sebagai bagian dari langkah konfigurasi sumber data. IAM Peran dengan semua izin yang diperlukan dapat dibuat untuk Anda sebagai bagian dari langkah konsol untuk membuat basis pengetahuan. Setelah Anda mengonfigurasi sumber data dan konfigurasi lainnya, IAM peran dengan semua izin yang diperlukan diterapkan ke basis pengetahuan khusus Anda.

Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami tidak menyarankan Anda menggunakan kembali kredensi dan rahasia di seluruh sumber data.

Konfigurasi koneksi

Untuk menyambung ke instans Salesforce, Anda harus memberikan informasi konfigurasi yang diperlukan agar Amazon Bedrock dapat mengakses dan meng-crawl data Anda. Anda juga harus mengikutiPrasyarat.

Contoh konfigurasi untuk sumber data ini disertakan dalam bagian ini.

Untuk informasi selengkapnya tentang deteksi otomatis bidang dokumen, filter inklusi/pengecualian, sinkronisasi inkremental, kredensi otentikasi rahasia, dan cara kerjanya, pilih yang berikut ini:

Deteksi otomatis bidang dokumen utama

Konektor sumber data secara otomatis mendeteksi dan merayapi semua bidang metadata utama dokumen atau konten Anda. Misalnya, konektor sumber data dapat merayapi badan dokumen yang setara dengan dokumen Anda, judul dokumen, tanggal pembuatan atau modifikasi dokumen, atau bidang inti lainnya yang mungkin berlaku untuk dokumen Anda.

penting

Jika konten Anda menyertakan informasi sensitif, maka Amazon Bedrock dapat merespons menggunakan informasi sensitif.

Anda dapat menerapkan operator pemfilteran ke bidang metadata untuk membantu Anda lebih meningkatkan relevansi tanggapan. Misalnya, dokumentasikan “epoch_modification_time” atau jumlah detik yang berlalu 1 Januari 1970 untuk saat dokumen terakhir diperbarui. Anda dapat memfilter data terbaru, di mana “epoch_modification_time” lebih besar dari angka tertentu. Untuk informasi selengkapnya tentang operator pemfilteran yang dapat Anda terapkan ke bidang metadata, lihat Metadata dan pemfilteran.

Deteksi otomatis bidang dokumen utama

Konektor sumber data secara otomatis mendeteksi dan merayapi semua bidang metadata utama dokumen atau konten Anda. Misalnya, konektor sumber data dapat merayapi badan dokumen yang setara dengan dokumen Anda, judul dokumen, tanggal pembuatan atau modifikasi dokumen, atau bidang inti lainnya yang mungkin berlaku untuk dokumen Anda.

penting

Jika konten Anda menyertakan informasi sensitif, maka Amazon Bedrock dapat merespons menggunakan informasi sensitif.

Anda dapat menerapkan operator pemfilteran ke bidang metadata untuk membantu Anda lebih meningkatkan relevansi tanggapan. Misalnya, dokumentasikan “epoch_modification_time” atau jumlah detik yang berlalu 1 Januari 1970 untuk saat dokumen terakhir diperbarui. Anda dapat memfilter data terbaru, di mana “epoch_modification_time” lebih besar dari angka tertentu. Untuk informasi selengkapnya tentang operator pemfilteran yang dapat Anda terapkan ke bidang metadata, lihat Metadata dan pemfilteran.

Filter inklusi/pengecualian

Anda dapat menyertakan atau mengecualikan perayapan konten tertentu. Misalnya, Anda dapat menentukan pola prefix/regular expression pattern to skip crawling any file that contains “private” in the file name. You could also specify an inclusion prefix/regular ekspresi pengecualian untuk menyertakan entitas konten atau jenis konten tertentu. Jika Anda menentukan filter penyertaan dan pengecualian dan keduanya cocok dengan dokumen, filter pengecualian akan diutamakan dan dokumen tidak dirayapi.

Contoh pola ekspresi reguler untuk mengecualikan atau memfilter kampanye yang berisi “pribadi” dalam nama kampanye:”. * pribadi. *”

Anda dapat menerapkan filter inklusi/pengecualian pada jenis konten berikut:

• Account: Nomor akun/pengenal

• Attachment: Nama file lampiran dengan ekstensinya

• Campaign: Nama kampanye dan pengidentifikasi terkait

• ContentVersion: Versi dokumen dan pengidentifikasi terkait

• Partner: Bidang informasi mitra termasuk pengidentifikasi terkait

• Pricebook2: Nama daftar produk/harga

• Case: Nomor pertanyaan/masalah pelanggan dan bidang informasi lainnya termasuk pengidentifikasi terkait (harap dicatat: dapat berisi informasi pribadi, yang dapat Anda pilih untuk mengecualikan atau menyaring)

• Contact: Bidang informasi pelanggan (harap dicatat: dapat berisi informasi pribadi, yang dapat Anda pilih untuk dikecualikan atau disaring)

• Contract: Nama kontrak dan pengidentifikasi terkait

• Document: Nama file dengan ekstensinya

• Idea: Bidang informasi ide dan pengidentifikasi terkait

• Lead: Bidang informasi pelanggan baru yang potensial (harap dicatat: dapat berisi informasi pribadi, yang dapat Anda pilih untuk dikecualikan atau disaring)

• Opportunity: Bidang informasi penjualan/kesepakatan yang tertunda dan pengidentifikasi terkait

• Product2: Bidang informasi produk dan pengidentifikasi terkait

• Solution: Nama solusi untuk pertanyaan/masalah pelanggan dan pengidentifikasi terkait

• Task: Bidang informasi tugas dan pengidentifikasi terkait

• FeedItem: Pengidentifikasi posting umpan obrolan

• FeedComment: Pengidentifikasi posting umpan obrolan yang menjadi milik komentar

• Knowledge__kav: Versi artikel pengetahuan dan pengidentifikasi terkait

• User: Alias pengguna dalam organisasi Anda

• CollaborationGroup: Nama grup obrolan (unik)

Filter inklusi/pengecualian

Anda dapat menyertakan atau mengecualikan perayapan konten tertentu. Misalnya, Anda dapat menentukan pola prefix/regular expression pattern to skip crawling any file that contains “private” in the file name. You could also specify an inclusion prefix/regular ekspresi pengecualian untuk menyertakan entitas konten atau jenis konten tertentu. Jika Anda menentukan filter penyertaan dan pengecualian dan keduanya cocok dengan dokumen, filter pengecualian akan diutamakan dan dokumen tidak dirayapi.

Contoh pola ekspresi reguler untuk mengecualikan atau memfilter kampanye yang berisi “pribadi” dalam nama kampanye:”. * pribadi. *”

Anda dapat menerapkan filter inklusi/pengecualian pada jenis konten berikut:

• Account: Nomor akun/pengenal

• Attachment: Nama file lampiran dengan ekstensinya

• Campaign: Nama kampanye dan pengidentifikasi terkait

• ContentVersion: Versi dokumen dan pengidentifikasi terkait

• Partner: Bidang informasi mitra termasuk pengidentifikasi terkait

• Pricebook2: Nama daftar produk/harga

• Case: Nomor pertanyaan/masalah pelanggan dan bidang informasi lainnya termasuk pengidentifikasi terkait (harap dicatat: dapat berisi informasi pribadi, yang dapat Anda pilih untuk mengecualikan atau menyaring)

• Contact: Bidang informasi pelanggan (harap dicatat: dapat berisi informasi pribadi, yang dapat Anda pilih untuk dikecualikan atau disaring)

• Contract: Nama kontrak dan pengidentifikasi terkait

• Document: Nama file dengan ekstensinya

• Idea: Bidang informasi ide dan pengidentifikasi terkait

• Lead: Bidang informasi pelanggan baru yang potensial (harap dicatat: dapat berisi informasi pribadi, yang dapat Anda pilih untuk dikecualikan atau disaring)

• Opportunity: Bidang informasi penjualan/kesepakatan yang tertunda dan pengidentifikasi terkait

• Product2: Bidang informasi produk dan pengidentifikasi terkait

• Solution: Nama solusi untuk pertanyaan/masalah pelanggan dan pengidentifikasi terkait

• Task: Bidang informasi tugas dan pengidentifikasi terkait

• FeedItem: Pengidentifikasi posting umpan obrolan

• FeedComment: Pengidentifikasi posting umpan obrolan yang menjadi milik komentar

• Knowledge__kav: Versi artikel pengetahuan dan pengidentifikasi terkait

• User: Alias pengguna dalam organisasi Anda

• CollaborationGroup: Nama grup obrolan (unik)

Sinkronisasi inkremental

Konektor sumber data merayapi konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan basis pengetahuan Anda. Amazon Bedrock dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan merayapi konten yang berubah sejak sinkronisasi terakhir. Saat Anda menyinkronkan sumber data dengan basis pengetahuan untuk pertama kalinya, semua konten dirayapi secara default.

Untuk menyinkronkan sumber data Anda dengan basis pengetahuan Anda, gunakan StartIngestionJobAPI atau pilih basis pengetahuan Anda di konsol dan pilih Sinkronkan dalam bagian ikhtisar sumber data.

penting

Semua data yang Anda sinkronkan dari sumber data Anda akan tersedia bagi siapa saja yang memiliki bedrock:Retrieve izin untuk mengambil data. Ini juga dapat mencakup data apa pun dengan izin sumber data terkontrol. Untuk informasi selengkapnya, lihat Izin basis pengetahuan.

Sinkronisasi inkremental

Konektor sumber data merayapi konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan basis pengetahuan Anda. Amazon Bedrock dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan merayapi konten yang berubah sejak sinkronisasi terakhir. Saat Anda menyinkronkan sumber data dengan basis pengetahuan untuk pertama kalinya, semua konten dirayapi secara default.

Untuk menyinkronkan sumber data Anda dengan basis pengetahuan Anda, gunakan StartIngestionJobAPI atau pilih basis pengetahuan Anda di konsol dan pilih Sinkronkan dalam bagian ikhtisar sumber data.

penting

Semua data yang Anda sinkronkan dari sumber data Anda akan tersedia bagi siapa saja yang memiliki bedrock:Retrieve izin untuk mengambil data. Ini juga dapat mencakup data apa pun dengan izin sumber data terkontrol. Untuk informasi selengkapnya, lihat Izin basis pengetahuan.

Kredensi otentikasi rahasia

(Untuk otentikasi OAuth 2.0) Kredensyal otentikasi rahasia Anda AWS Secrets Manager harus menyertakan pasangan nilai kunci ini:

• consumerKey: app client ID

• consumerSecret: app client secret

• authenticationUrl: Salesforce instance URL or the URL to request the authentication token from

catatan

Rahasia Anda AWS Secrets Manager harus menggunakan wilayah yang sama dari basis pengetahuan Anda.

Kredensi otentikasi rahasia

(Untuk otentikasi OAuth 2.0) Kredensyal otentikasi rahasia Anda AWS Secrets Manager harus menyertakan pasangan nilai kunci ini:

• consumerKey: app client ID

• consumerSecret: app client secret

• authenticationUrl: Salesforce instance URL or the URL to request the authentication token from

catatan

Rahasia Anda AWS Secrets Manager harus menggunakan wilayah yang sama dari basis pengetahuan Anda.

Console

Hubungkan instans Salesforce ke basis pengetahuan Anda

1. Ikuti langkah-langkah di Buat basis pengetahuan dengan menghubungkan ke sumber data di Amazon Bedrock Knowledge Bases dan pilih Salesforce sebagai sumber data.

2. Berikan nama dan deskripsi opsional untuk sumber data.

3. Berikan URL instance Salesforce Anda. Misalnya, https://company.salesforce.com/. Instans harus menjalankan Aplikasi Terhubung Salesforce.

4. Di bagian Pengaturan lanjutan, Anda dapat secara opsional mengonfigurasi yang berikut:

   • Kunci KMS untuk penyimpanan data sementara. — Anda dapat mengenkripsi data sementara sambil mengubah data Anda menjadi embeddings dengan default atau kunci KMS Anda sendiri. Kunci yang dikelola AWS Untuk informasi selengkapnya, lihat Enkripsi penyimpanan data sementara selama konsumsi data.

   • Kebijakan penghapusan data — Anda dapat menghapus embeddings vektor untuk sumber data Anda yang disimpan di penyimpanan vektor secara default, atau memilih untuk menyimpan data penyimpanan vektor.

5. Berikan informasi otentikasi untuk terhubung ke instans Salesforce Anda:

   1. Untuk otentikasi OAuth 2.0, buka AWS Secrets Manager untuk menambahkan kredensyal otentikasi rahasia Anda atau gunakan Nama Sumber Daya Amazon (ARN) yang ada untuk rahasia yang Anda buat. Rahasia Anda harus berisi kunci konsumen Salesforce Connected App (ID klien), rahasia konsumen (rahasia klien), dan URL instans Salesforce atau URL untuk meminta token otentikasi. Untuk informasi selengkapnya, lihat Dokumentasi Salesforce tentang Membuat Aplikasi Tersambung dan Mengonfigurasi Aplikasi Terhubung untuk Kredensyal Klien OAuth 2.0.

6. (Opsional) Di bagian Parsing dan chunking konten, Anda dapat menyesuaikan cara mengurai dan memotong data Anda. Lihat sumber daya berikut untuk mempelajari lebih lanjut tentang penyesuaian ini:

   • Untuk informasi selengkapnya tentang opsi penguraian, lihatOpsi penguraian untuk sumber data Anda.

   • Untuk informasi lebih lanjut tentang strategi chunking, lihat. Bagaimana content chunking bekerja untuk basis pengetahuan

     Awas

     Anda tidak dapat mengubah strategi chunking setelah terhubung ke sumber data.

   • Untuk informasi selengkapnya tentang cara menyesuaikan potongan data dan pemrosesan metadata Anda dengan fungsi Lambda, lihat. Gunakan fungsi Lambda transformasi kustom untuk menentukan bagaimana data Anda dicerna

7. Pilih untuk menggunakan filter/pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. Semua konten standar dirayapi sebaliknya.

8. Lanjutkan untuk memilih model embeddings dan penyimpanan vektor. Untuk melihat langkah-langkah yang tersisa, kembali ke Buat basis pengetahuan dengan menghubungkan ke sumber data di Amazon Bedrock Knowledge Bases dan lanjutkan dari langkah setelah menghubungkan sumber data Anda.

API

Berikut ini adalah contoh konfigurasi untuk menghubungkan ke Salesforce untuk basis pengetahuan Amazon Bedrock Anda. Anda mengonfigurasi sumber data menggunakan API dengan AWS CLI atau SDK yang didukung, seperti Python. Setelah menelepon CreateKnowledgeBase, Anda menelepon CreateDataSourceuntuk membuat sumber data dengan informasi koneksi Anda didataSourceConfiguration.

Untuk mempelajari tentang penyesuaian yang dapat Anda terapkan pada konsumsi dengan menyertakan bidang opsionalvectorIngestionConfiguration, lihat. Sesuaikan konsumsi untuk sumber data

AWS Command Line Interface

aws bedrock create-data-source \
 --name "Salesforce connector" \
 --description "Salesforce data source connector for Amazon Bedrock to use content in Salesforce" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://salesforce-bedrock-connector-configuration.json \
 --data-deletion-policy "DELETE" \
 --vector-ingestion-configuration '{"chunkingConfiguration":[{"chunkingStrategy":"FIXED_SIZE","fixedSizeChunkingConfiguration":[{"maxTokens":"100","overlapPercentage":"10"}]}]}'

salesforce-bedrock-connector-configuration.json
{
    "salesforceConfiguration": {
        "sourceConfiguration": {
            "hostUrl": "https://company.salesforce.com/",
            "authType": "OAUTH2_CLIENT_CREDENTIALS",
            "credentialsSecretArn": "arn:aws::secretsmanager:your-region:secret:AmazonBedrock-Salesforce"
        },
        "crawlerConfiguration": {
            "filterConfiguration": {
                "type": "PATTERN",
                "patternObjectFilter": {
                    "filters": [
                        {
                            "objectType": "Campaign",
                            "inclusionFilters": [
                                ".*public.*"
                            ],
                            "exclusionFilters": [
                                ".*private.*"
                            ]
                        }
                    ]
                }
            }
        }
    },
    "type": "SALESFORCE"
}