本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
銷售連接器 V1.0
Salesforce 是一種客戶關係管理(CRM)工具,用於管理支持,銷售和營銷團隊。您可以使用索 Amazon Kendra 引您的 Salesforce 標準物件,甚至是自訂物件。
Amazon Kendra 使用版本 48 的銷售力量 API。Salesforce API 會限制您每天可發出的要求數量。如果 Salesforce 超過這些要求,它會重試直到能夠繼續。
Support 於 Salesforce 連接器 1.0/ SalesforceConfiguration API 的支援預定於 2023 年結束。我們建議您移轉至或使用 Salesforce 連接器 2.0/ TemplateConfiguration API。
如需 Amazon Kendra Salesforce 資料來源連接器的疑難排解,請參閱疑難排解資料來。
支援的功能
Amazon Kendra Salesforce 資料來源連接器支援下列功能:
必要條件
在您可以使用 Amazon Kendra 索引 Salesforce 資料來源之前,請先在 Salesforce 和 AWS 帳戶中進行這些變更。
在「銷售力量」中,請確定您擁有:
-
已建立 Salesforce 帳戶,並記下您用來連線至 Salesforce 的使用者名稱和密碼。
-
建立已啟用 OAuth 的 Salesforce 連線應用程式帳戶,並複製指派給 Salesforce 連線應用程式的消費者金鑰 (用戶端識別碼) 和消費者密碼 (用戶端密碼)。用戶端 ID 和用戶端密碼會用作儲存在 AWS Secrets Manager 密碼中的驗證憑證。如需詳細資訊,請參閱已連線應用程式的 Salesforce 文件
我們建議您定期重新整理或輪換您的認證和密碼。僅為您自己的安全提供必要的訪問級別。我們不建議您跨資料來源以及連接器 1.0 和 2.0 版 (如果適用) 重複使用認證和密碼。
-
複製與用來連線至 Salesforce 之帳戶相關聯的 Salesforce 安全性權杖。
-
複製您要索引之 Salesforce 執行個體的 URL。<company>通常情況下,這是 HTTPS:
伺服器必須執行已連線到 Salesforce 的應用程式。
-
透過複製 ReadOnly 設定檔,然後新增「檢視所有資料」和「管理文章」權限,為具有 Salesforce 唯讀存取權限的使用者新增認證至您的 Salesforce 伺服器。這些認證可識別進行連線的使用者,以及連線到的 Salesforce Amazon Kendra 連線應用程式。
-
核取每個文件在 Salesforce 和您打算用於相同索引的其他資料來源中都是唯一的。您要用於索引的每個資料來源不得包含跨資料來源的相同文件。文件 ID 對索引來說是全域的,而且每個索引必須是唯一的。
在您的中 AWS 帳戶,請確保您有:
-
建立 Amazon Kendra 索引,如果使用 API,則會記下索引識別碼。
-
為您的資料來源建立 IAM 角色,如果使用 API,則會記錄 IAM 角色的 ARN。
如果您變更驗證類型和認證,則必須更新 IAM 角色以存取正確的 AWS Secrets Manager 密碼 ID。
-
將您的 Salesforce 驗證認證儲存在 AWS Secrets Manager 密碼中,如果使用 API,則會記下密碼的 ARN。
我們建議您定期重新整理或輪換您的認證和密碼。僅為您自己的安全提供必要的訪問級別。我們不建議您跨資料來源以及連接器 1.0 和 2.0 版 (如果適用) 重複使用認證和密碼。
如果您沒有現有的 IAM 角色或密碼,則可以在將 Salesforce 資料來源連線到時,使用主控台建立新 IAM 角色和 Secrets Manager 密碼。 Amazon Kendra如果您使用 API,則必須提供現有 IAM 角色和 Secrets Manager 密碼的 ARN 以及索引 ID。
連接說明
若要連線 Amazon Kendra 到 Salesforce 資料來源,您必須提供 Salesforce 資料來源的必要詳細資料, Amazon Kendra 以便存取您的資料。如果您尚未配置 Salesforce 以查 Amazon Kendra 看必要條件。
- Console
-
若要連線 Amazon Kendra 至銷售力量
-
登入 AWS 管理主控台並開啟主Amazon Kendra 控台。
-
在左側導覽窗格中,選擇 [索引],然後從索引清單中選擇要使用的索引。
您可以選擇在索引設置下配置或編輯用戶訪問控制設置。
-
在 [開始使用] 頁面上,選擇 [新增資料來源]。
-
在 [新增資料來源] 頁面上,選擇 Salesforce 連接器 V1.0,然後選擇 [新增連接器]。
-
在 [指定資料來源詳細資訊] 頁面上,輸入下列資訊:
-
資料來源名稱 — 輸入資料來源的名稱。您可以包含連字號,但不能包含空格。
-
(選擇性) 說明 — 輸入資料來源的選用說明。
-
預設語言 — 用來篩選索引文件的語言。除非另有指定,否則語言預設為英文。中繼資料中指定的語言會覆寫所選語言
-
新增標籤 — 用來搜尋和篩選資源或追蹤共用成本的標籤。
-
選擇下一步。
-
在 [定義存取權和安全性] 頁面上,輸入下列資訊:
-
Salesforce 網址:輸入您要索引之 Salesforce 網站的執行個體 URL。
-
對於驗證類型,請選擇現有和新增來儲存您的 Salesforce 驗證認證。如果您選擇建立新密碼,則會開啟一個 AWS
Secrets Manager 密碼視窗。
-
在「建立 AWS
Secrets Manager 密碼視窗」中輸入下列資訊:
-
秘密名稱 — 您秘密的名稱。前綴 'AmazonKendra-Salesforce' 會自動添加到您的密碼名稱中。
-
針對使用者名稱、密碼、安全性權杖、取用者金鑰、取用者密碼和驗證 URL,請輸入您在 Salesforce 帳戶中建立的驗證認證值。
-
選擇 [儲存驗證]。
-
IAM role — 選擇現有 IAM 角色或建立新 IAM 角色以存取存放庫認證和索引內容。
IAM 用於索引的角色不能用於資料來源。如果您不確定索引或常見問題集是否使用現有角色,請選擇 [建立新角色] 以避免發生錯誤。
-
選擇下一步。
-
在 [設定同步設定] 頁面上,輸入下列資訊:
-
針對編目附件 — 選取此選項可編目所有附加的物件、文章和摘要。
-
針對標準物件、知識文章和 Chatter 摘要,請選取您要編目的 Salesforce 實體或內容類型。
您必須提供組態資訊,以索引至少一個標準物件、知識文章或 chatter 摘要。如果您選擇編目知識文章,您必須指定要索引的知識文章類型、文章的名稱,以及是否要索引所有知識文章的標準欄位,還是僅索引自訂文章類型的欄位。如果您選擇索引自訂文章,您必須指定文章類型的內部名稱。您最多可以指定 10 種文章類型。
-
頻率:與資料來源同步的頻率。 Amazon Kendra
-
選擇下一步。
-
在 [設定欄位對映] 頁面上,輸入下列資訊:
-
對於標準知識文章、標準物件附件和其他建議的欄位對應 — 從 Amazon Kendra 產生的預設資料來源欄位中選取您要對應至索引的預設資料來源欄位。
需要對映_document_body
的索引。您無法變更欄Salesforce ID
位與欄位之間的 Amazon Kendra
_document_id
對應。
-
新增欄位 — 新增自訂資料來源欄位以建立要對映的索引欄位名稱和欄位資料類型。
-
選擇下一步。
-
在 [檢閱並建立] 頁面上,檢查您輸入的資訊是否正確,然後選取 [新增資料來源]。您也可以從此頁面選擇編輯您的資訊。成功新增資料來源後,您的資料來源將顯示在 [資料來源] 頁面上。
- API
-
若要連線 Amazon Kendra 至銷售力量
您必須指定下列 SalesforceConfigurationAPI:
-
伺服器 URL — 您要索引之 Salesforce 網站的執行個體 URL。
-
秘密 Amazon 資源名稱 (ARN) — 提供機 Secrets Manager 密的 Amazon 資源名稱 (ARN),其中包含您的 Salesforce 帳戶的身份驗證登入資料。密碼會以下列金鑰儲存在 JSON 結構中:
{
"authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token
",
"consumerKey": "Application public key generated when you created your Salesforce application
",
"consumerSecret": "Application private key generated when you created your Salesforce application.
",
"password": "Password associated with the user logging in to the Salesforce instance
",
"securityToken": "Token associated with the user account logging in to the Salesforce instance
",
"username": "User name of the user logging in to the Salesforce instance
"
}
-
IAM 角色 — 指定RoleArn
當您呼叫CreateDataSource
以提供具有存取 Secrets Manager 密碼之權限的 IAM 角色,以及呼叫 Salesforce 連接器和所需的公用 API 的時間。 Amazon Kendra如需詳細資訊,請參閱 Salesforce 資料來源的IAM 角色。
-
您必須提供組態資訊,以索引至少一個標準物件、知識文章或 chatter 摘要。
-
標準物件 — 如果您選擇編目標準物件,您必須指定標準物件的名稱,以及包含文件內容的標準物件表格中的欄位名稱。
-
知識文章 — 如果您選擇編目知識文章,您必須指定要索引的知識文章類型、要索引的知識文章的狀態,以及是否要索引所有知識文章的標準欄位,還是只為自訂文章類型的欄位建立索引。
-
Chatter 摘要 — 如果您選擇編目 Chatter 摘要,則必須在包含要索引之內容的 Salesforce FeedItem 表格中指定資料行的名稱。
您還可以添加以下可選功能:
-
包含和排除篩選器 — 指定要包含還是排除某些檔案附件。
大多數資料來源使用規則運算式模式,這些模式是稱為篩選器的包含或排除模式。如果您指定包含篩選器,則只有符合包含項目篩選器的內容會編製索引。不符合包含篩選器的任何文件都不會建立索引。如果您指定包含和排除篩選器,符合排除篩選器的文件將不會建立索引,即使它們符合包含篩選器也是如此。
-
欄位對映 — 選擇將 Salesforce 資料來源欄位對映至 Amazon Kendra 索引欄位。如需詳細資訊,請參閱映射資料來源欄位。
您的文件需要文件內文欄位或文件內文對等項目,才能搜尋您的文件。 Amazon Kendra 您必須將資料來源中的文件內文欄位名稱對應至索引欄位名稱_document_body
。所有其他欄位是選用的。
-
使用者前後關聯篩選與存取控制 —Amazon Kendra 探索文件的存取控制清單 (ACL) (如果您有文件的 ACL)。ACL 資訊可用來根據使用者或使用者對文件的群組存取來篩選搜尋結果。如需詳細資訊,請參閱使用者內容篩選。