Amazon Kendra 不再向新客户开放。要了解与类似的功能 Amazon Kendra,请浏览亚马逊基岩知识库。了解更多。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Salesforce 连接 V1.0
Salesforce 是一款客户关系管理(CRM)工具,用于管理支持、销售和营销团队。您可以使用 Amazon Kendra 索引您的 Salesforce 标准对象甚至自定义对象。
Amazon Kendra 使用 Salesforce API 版本 48。Salesforce API 对每天可以发出的请求数量有限制。如果 Salesforce 超过了这些请求,它会重试,直到能够继续。
Salesforce 连接器 V1.0 / SalesforceConfiguration API 于 2023 年结束。我们建议迁移到或使用 Salesforce 连接器 V2.0 / TemplateConfiguration API。
要对 Amazon Kendra Salesforce 数据源连接器进行故障排除,请参阅数据来源故障排除。
支持的功能
Amazon Kendra Salesforce 数据源连接器支持以下功能:
-
字段映射
-
用户访问控制
-
Inclusion/exclusion 过滤器
先决条件
在使用 Amazon Kendra Salesforce数据源建立索引之前,请在您的Salesforce和 AWS 账户中进行这些更改。
在 Salesforce 中,请确保:
-
已创建一个 Salesforce 账户,并记下了用于连接 Salesforce 的用户名和密码。
-
已创建一个激活 OAuth 的 Salesforce 连接的应用程序账户,并已复制分配给您的 Salesforce 连接的应用程序的使用者键(客户端 ID)和使用者密钥(客户端密钥)。客户端 ID 和客户端密钥用作存储在密 AWS Secrets Manager 钥中的身份验证凭证。有关更多信息,请参阅有关联网应用程序的 Salesforce 文档。
我们建议您定期刷新或轮换您的凭证和密码。为了安全起见,请仅提供必要的访问权限级别。我们建议不要跨数据来源以及连接器版本 1.0 和 2.0(如果适用)重复使用凭证和密钥。
-
已复制与用于连接 Salesforce 的账户关联的 Salesforce 安全令牌。
-
要编制索引的 Salesforce 实例的 URL。通常为 https://<company>.salesforce.com/。服务器必须运行与 Salesforce 连接的应用程序。
-
通过克隆 ReadOnly 个人资料,然后添加 “查看所有数据” 和 “管理文章” 权限,为具有 Salesforce 只读访问权限的用户向您的 Salesforce 服务器添加了凭据。这些凭据可识别进行连接的用户以及连接的 Salesforce Amazon Kendra 连接应用程序。
-
在 Salesforce 以及计划用于编制同一索引的其他数据来源中,已检查每个文档都是唯一的。您要用于编制索引的每个数据来源在所有数据来源中都不能包含相同的文档。文档 ID 对索引来说是全局性的,并且每个索引都必须是唯一的。
在您的中 AWS 账户,请确保您有:
如果您没有现有 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 到 Salesforce
-
登录 AWS 管理控制台并打开Amazon Kendra 控制台。
-
在左侧导航窗格中,选择索引,然后从索引列表中选择要使用的索引。
您可以选择在索引设置下配置或编辑您的用户访问控制设置。
-
在开始使用页面上,选择添加数据来源。
-
在添加数据来源页面上,选择 Salesforce 连接器 V1.0,然后选择添加连接器。
-
在指定数据来源详细信息页面上输入以下信息:
-
数据源名称 - 输入您的数据源的名称。可以包含连字符,但不能包含空格。
-
(可选)说明 - 为数据来源输入说明。
-
默认语言 - 用于筛选文档以编制索引的语言。除非另行指定,否则语言默认为英语。在元数据中指定的语言会覆盖所选语言。
-
添加新标签 - 用于搜索和筛选资源或跟踪分摊费用的标签。
-
选择下一步。
-
在定义访问权限和安全性页面上,请输入以下信息:
-
Salesforce URL - 输入要编制索引的 Salesforce 站点的实例 URL。
-
对于身份验证类型,请选择现有或新建,以便存储您的 Salesforce 身份验证凭证。如果您选择创建新密钥,则会打开一个 AWS
Secrets Manager 秘密窗口。
-
在创建 AWS
Secrets Manager 密钥窗口中输入以下信息:
-
密钥名称 - 密钥的名称。前缀 “AmazonKendra-Salesforce-” 会自动添加到您的密钥名称中。
-
对于用户名、密码、安全令牌、使用者键、使用者密钥和身份验证 URL - 输入您在 Salesforce 账户中创建的身份验证凭证值。
-
选择保存身份验证。
-
IAM 角色 —选择现有 IAM 角色或创建新 IAM 角色来访问您的存储库凭据和索引内容。
IAM 用于索引的角色不能用于数据源。如果您不确定是否将现有角色用于编制索引或常见问题解答,为了避免出错,请选择创建新角色。
-
选择下一步。
-
在配置同步设置页面上,请输入以下信息:
-
对于爬取附件 - 选择爬取所有附加对象、文章和源。
-
对于标准对象、知识文章和聊天源,请选择要爬取的 Salesforce 实体或内容类型。
您必须提供配置信息,以便为至少一个标准对象、知识文章或聊天源编制索引。如果您选择爬取知识文章,则必须指定要编制索引的知识文章的类型、文章的名称,以及是为所有知识文章的标准字段编制索引,还是仅为自定义文章类型的字段编制索引。如果您选择为自定义文章编制索引,则必须指定文章类型的内部名称。最多可以指定 10 种文章类型。
-
频率 —与数据源同步的频率。 Amazon Kendra
-
选择下一步。
-
在设置字段映射页面上,请输入以下信息:
-
对于标准知识文章、标准对象附件和其他建议字段映射 -从 Amazon Kendra 生成的要映射到索引的默认数据源字段中进行选择。
映射到 _document_body 的索引是必需的。您无法更改 Salesforce ID 字段与 Amazon Kendra
_document_id 字段之间的映射。
-
添加字段 - 添加自定义数据来源字段以创建要映射到的索引字段名称和字段数据类型。
-
选择下一步。
-
在查看和创建页面上,请检查输入的信息是否正确,然后选择添加数据来源。您也可以选择在此页面上编辑信息。成功添加数据来源后,您的数据来源将显示在数据来源页面上。
- API
-
连接 Amazon Kendra 到 Salesforce
必须指定以下 SalesforceConfiguration API:
-
服务器 URL - 要编制索引的 Salesforce 站点的实例 URL。
-
亚马逊机密资源名称 (ARN) — 提供包含您的 Salesforce 账户身份验证凭证的 Secrets Manager 密钥的亚马逊资源名称 (ARN)。密钥必须使用具有以下键的 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以向 IAM 角色提供访问您的 Secrets Manager 密钥的权限,以及调用 Salesforce 连接器所需的公共 API 的权限,以及。 Amazon Kendra有关更多信息,请参阅 Salesforce 数据来源的IAM 角色。
-
您必须提供配置信息,以便为至少一个标准对象、知识文章或聊天源编制索引。
-
标准对象 - 如果选择爬取标准对象,则必须指定标准对象的名称以及包含文档内容的标准对象表中字段的名称。
-
知识文章 - 如果您选择爬取知识文章,则必须指定要编制索引的知识文章的类型、要编制索引的知识文章的状态,以及是为所有知识文章的标准字段编制索引,还是仅为自定义文章类型的字段编制索引。
-
聊天订阅源 —如果您选择抓取 Chatter 订阅源,则必须在 Salesforce FeedItem 表中指定包含要索引的内容的列的名称。
您还可以添加以下可选功能:
-
包含和排除筛选条件 - 指定是包含还是排除某些文件附件。
大多数数据来源使用正则表达式模式,即称为筛选条件的包含或排除模式。如果您指定包含筛选条件,则只会为与包含筛选条件匹配的内容编制索引。不会为任何与包含筛选条件不匹配的文档编制索引。如果您指定包含和排除筛选条件,则不会为与排除筛选条件匹配的文档编制索引,即使它们与包含筛选条件相匹配。
-
字段映射 - 选择将 Salesforce 数据来源字段映射到 Amazon Kendra 索引字段。有关更多信息,请参阅映射数据来源字段。
要搜索您的文档,必须填写文档正文字段或相应的 Amazon Kendra 文档正文字段。您必须将数据来源中的文档正文字段名映射到索引字段名称 _document_body。其他所有字段均为可选字段。
-
用户上下文筛选和访问控制 – 如果文档有 ACL,则Amazon Kendra 会爬取文档的访问控制列表(ACL)。ACL 信息用于根据用户或其所在组对文档的访问权限来筛选搜索结果。有关更多信息,请参阅用户上下文筛选。