Uso de un origen de datos de Salesforce - Amazon Kendra

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de un origen de datos de Salesforce

Puede utilizar el servidor de Salesforce como fuente de datos paraAmazon Kendra. Para utilizar Salesforce en la consola de, vaya a laAmazon Kendraconsola, selecciona tu índice y, a continuación, seleccionaOrígenes de datosdesde el menú de navegación para agregar Salesforce.

Cuando utilizaAmazon Kendrapara indexar su servidor Salesforce, puede optar por indexar hasta 17 de los objetos de Salesforce estándar. También puede indexar artículos de conocimiento, fuentes de conversación y archivos adjuntos.

Amazon Kendrautiliza la API de Salesforce versión 48. La API de Salesforce limita el número de solicitudes que puede realizar por día. SiAmazon Kendrasupera esas solicitudes, vuelve a intentarlo hasta que pueda continuar.

Antes de poder conectarseAmazon Kendraen su servidor de Salesforce, debe crear una aplicación conectada con Salesforce con OAuth habilitada para queAmazon Kendrase puede conectar. Cuando creas una aplicación, se le asigna una clave de consumidor y un secreto de consumidor queAmazon Kendrapara conectarse a la aplicación.

Debe proporcionarAmazon Kendracon credenciales para acceder a su servidor Salesforce. Estas credenciales identifican al usuario que realiza la conexión y la aplicación conectada de Salesforce queAmazon Kendrase conecta a.

Las credenciales deben corresponder a un usuario con acceso de solo lectura a Salesforce. Para crear permisos para el usuario, clone el ReadOnly y, a continuación, agregue los permisos Ver todos los datos y Administrar artículos.

Almacena las credenciales en unAWS Secrets Managersecreto de. Si utiliza la consola para crear el origen de datos de, puede crear el secreto de allí o utilizar un origen existenteSecrets Managersecreto de. Si utiliza la API de, deberá proporcionar el nombre de recurso de Amazon (ARN) correspondiente a un secreto existente.

El secreto debe contener la siguiente información:

  • authenticationUrl— La URL del servidor de autenticación de OAuth utilizado para autenticarse con Salesforce. Normalmente, esto es https://login.salesforce.com/services/oauth2/token.

  • consumerKey— La clave de consumidor, también denominada ID de cliente, de la aplicación Salesforce Connected que se utiliza para indexar el servidor. La aplicación debe tener un permiso que permita el acceso a la API REST.

  • consumerSecret— El secreto del consumidor, también denominado secreto de cliente, de la aplicación Salesforce Connected utilizada para indexar el servidor.

  • securityToken— El token de seguridad de Salesforce asociado a la cuenta utilizada para conectarse a Salesforce.

  • password: la contraseña asociada a la cuenta utilizada para conectarse a Salesforce.

  • username: el nombre de usuario de la cuenta utilizada para conectarse a Salesforce. La cuenta debe tener acceso de lectura a los objetos y campos que desee indexar.

Las credenciales se almacenan como una cadena JSON en elSecrets Managersecreto de. La siguiente es la estructura JSON mínima que debe estar en secreto:

{ "username": "user name", "password": "password", "securityToken": "token", "consumerKey": "key", "consumerSecret": "secret", "authenticationUrl": "https://login.salesforce.com/services/oauth2/token" }

Origen de datosIAMel rol debe tener permiso para acceder al secreto de. Para obtener más información, consulte IAMfunciones para las fuentes de datos de Salesforce.

Sin embargo, el secreto puede contener más información,Amazon Kendraignora otros campos. Para obtener más información, consulte¿Qué es ?AWS Secrets Manageren laAWS Secrets ManagerGuía del usuario de.

Debe crear un índice antes de crear el origen de datos de Salesforce. Para obtener más información, consulte Creación de un índice. Proporciona el ID del índice al crear el origen de datos.

Especifica la conexión y otra información en la consola o mediante una instancia delSalesforceConfigurationobjeto. Debe proporcionar la siguiente información:

  • URL del servidor de Salesforce que contiene la información que se va a indexar.

  • Las credenciales necesarias para conectarse al servidor de Salesforce.

Debe proporcionar información de configuración para indexar al menos una de las siguientes:

  • Objetos Salesforce

  • Artículos de conocimiento de Salesforce

  • Salesforce chatter feeds

Si lo desea, puede:

  • Proporcionar información de configuración para indexar adjuntos.

  • Indique siAmazon Kendradebe recopilar información de control de acceso para el filtrado de contexto de usuario.

Objetos estándar

Salesforce proporciona una extensa lista de objetos estándar que contienen información sobre las relaciones con los clientes. Puede optar por indexar cualquiera de estos objetos estándar:

  • Cuenta

  • Campaña

  • Caso

  • Contacto

  • Contrato

  • Parloteo

  • Document

  • Grupo

  • Idea

  • Plomo

  • Oportunidad

  • Socio

  • Libro de precios

  • Producto

  • Perfil

  • Solución

  • Tarea

  • Usuario

Para cada objeto, debe asignar un campo de objeto a laAmazon Kendraincorporado_bodycampo para queAmazon Kendrasabe dónde encontrar el contenido del objeto que se va a indexar. Puede asignar campos de objetos adicionales a personalizadosAmazon Kendra.

Salesforce le permite añadir campos personalizados a objetos estándar. Para utilizar el campo personalizado conAmazon Kendra, debe utilizar el nombre del campo de Salesforce interno. El nombre interno es el nombre del campo seguido de «__c» (dos guiones bajos y el carácter c). Por ejemplo, si tiene un campo personalizado denominadoAccountOriginalOwner, el nombre interno esAccountOriginalOwner__c.

Puede asignar campos de varios objetos a un soloAmazon Kendra. Por ejemplo, puede mapear el objeto AccountNamey el objeto PartnerNamecampo al mismoAmazon Kendraun campo personalizado.

Una vez guardado el mapeo entre unAmazon Kendray un campo de objeto Salesforce; no se puede cambiar la asignación. Sin embargo, puede añadir más mapeos entreAmazon Kendray Salesforce.

Para obtener más información, consulte Asignación de campos de origen de datos.

Artículos de conocimiento

Puede usarAmazon Kendrapara indexar el contenido de artículos de conocimiento estándar o artículos de conocimiento personalizados.

Al indexar artículos de conocimiento estándar,Amazon Kendraindexará todos los artículos de su servidor, incluidos los campos estándar de los artículos de conocimiento personalizados. Si indexas artículos de conocimiento personalizados,Amazon Kendraindexa solo artículos de ese tipo. No indexará el contenido de los artículos de conocimiento estándar.

Puede configurar la indexación de artículos de conocimiento mediante la consola o laSalesforceKnowledgeArticleConfigurationobjeto. Puede indicar el estado de los artículos que desea indexar, puede decirAmazon Kendrapara indexar artículos borradores, publicados o archivados.

Para los artículos de conocimiento personalizados, debe especificar el nombre del tipo de artículo personalizado. Debe especificar el nombre interno del tipo de artículo, que es el nombre del tipo más «__kav» (dos guiones bajos seguidos de los caracteres kav). Por ejemplo, si dispone de un tipo de artículo de cliente llamadoCustomKnowledgeArticleForTech, el nombre interno esCustomKnowledgeArticleForTech__kav. Puede especificar hasta 10 tipos de artículo.

Para los artículos de conocimiento personalizados y estándar, debe especificar el nombre del campo que contiene el contenido del artículo. Si lo desea, puede especificar el campo que contiene el título. Puede asignar campos de artículo adicionales a personalizadosAmazon Kendracampos mediante la consola o elDataSourceToIndexFieldMappingobjeto.

Fuentes de charla

Puede indexar el contenido de sus fuentes de chat de Salesforce. Puede configurar la indexación mediante la consola de o laSalesforceChatterFeedConfigurationobjeto.

Debe especificar el campo en Salesforce FeedItem tabla que contiene el contenido del elemento. Normalmente esta es la columna «Cuerpo». Puede especificar el título del artículo. Normalmente, esta es la columna «Título» del FeedItem table. Puede asignar campos adicionales a personalizadosAmazon Kendracampos mediante la consola o elDataSourceToIndexFieldMappingobjeto.

Por defecto,Amazon Kendraindexa todos los elementos de la fuente de conversación. Puede utilizar la consola de o elIncludeFilterTypedelSalesforceChatterFeedConfigurationpara limitar la indexación a los elementos que proceden de usuarios estándar de Salesforce o de cuentas de usuario activas.

Puede asignar campos adicionales a personalizadosAmazon Kendracampos mediante la consola o elDataSourceToIndexFieldMappingobjeto.

Archivos adjuntos

Puedes elegir tenerAmazon Kendraarchivos adjuntos de índice a objetos estándar, artículos de conocimiento y fuentes de chat. Puede utilizar la consola de o elCrawlAttachmentsopción en elSalesforceConfigurationobjeto para indicar si se deben indexar los anexos.

Por defecto,Amazon Kendraindexa todos los adjuntos. Puede utilizar la consola de o la API para filtrar adjuntos de la lista indexada. Para filtrar un adjunto, se utiliza una expresión regular que se evalúa en función del nombre de archivo del adjunto. Por ejemplo, para eliminar archivos JSON de la lista de archivos indexados, utilice una expresión regular que filtra los archivos que terminan en «.json».

También puede restringir los documentos indexados especificando los adjuntos que se van a indexar. Por ejemplo, para indexar solo archivos de Microsoft Word, especifique una expresión regular que seleccione los archivos que terminan en «.doc» o «.docx».