View a markdown version of this page

Connettore Salesforce V2.0 - Amazon Kendra

Amazon Kendra non è più aperto a nuovi clienti. Per funzionalità simili a Amazon Kendra, esplora le Knowledge Bases di Amazon Bedrock. Ulteriori informazioni.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connettore Salesforce V2.0

Salesforce è uno strumento di gestione delle relazioni con i clienti (CRM, Customer Relationship Management) per la gestione dei team di supporto, vendita e marketing. Puoi utilizzarlo Amazon Kendra per indicizzare gli oggetti standard di Salesforce e persino gli oggetti personalizzati.

Il connettore per le origini dati Amazon Kendra Salesforce supporta le seguenti edizioni Salesforce: Developer Edition ed Enterprise Edition.

Nota

Il V1.0 SalesforceConfiguration connettore/API Salesforce è terminato nel 2023. Ti consigliamo di migrare o utilizzare il V2.0 connettore/API Salesforce. TemplateConfiguration

Per risolvere i problemi relativi al connettore di origine dati Amazon Kendra Salesforce, consulta. Risoluzione dei problemi relativi alle origini dati

Funzionalità supportate

Amazon Kendra Il connettore di origine dati Salesforce supporta le seguenti funzionalità:

  • Mappature dei campi

  • Controllo degli accessi degli utenti

  • Inclusion/exclusion filtri

  • Sincronizzazione completa e incrementale dei contenuti

  • Cloud privato virtuale (VPC)

Prerequisiti

Prima di poterla utilizzare Amazon Kendra per indicizzare l'origine dati Salesforce, apporta queste modifiche a Salesforce e agli account. AWS

Nota

Salesforce ritirerà la versione Username-Password Flow nella versione invernale 2027. Consigliamo di utilizzare Client Credentials Flow per nuove configurazioni per evitare future interruzioni della connessione dati. Per ulteriori informazioni, consulta Retirement of OAuth 2.0 Username-Password Flow for Connected Apps nella documentazione di Salesforce.

In Salesforce, assicurati di avere:

Per Client Credentials Flow (consigliato):

  • Crea un'app client esterna in Salesforce con OAuth abilitato:

    1. In Configurazione, scegli App, App Manager, quindi scegli Nuova app client esterna.

    2. Abilita gli ambiti OAuth: gestisci i dati degli utenti tramite API (api) ed esegui le richieste in qualsiasi momento (refresh_token, offline_access).

    3. Nella sezione Flussi di autenticazione e miglioramenti delle app client esterne, abilita Client Credentials Flow.

    4. Configura un utente RunAs per il contesto di esecuzione. Ad esempio: Run As (nome utente).

    5. Annota la chiave Consumer (client_id) e il Consumer secret (client_secret).

  • Copia l'URL My Domain della tua istanza Salesforce (ad esempio,). https://<orgDomain>.my.salesforce.com Per trovare l'URL My Domain, da Configurazione, nella casella Ricerca rapida, inserisci Il mio dominio, quindi seleziona Il mio dominio. Per Client Credentials Flow https://login.salesforce.com e non https://test.salesforce.com sono supportati.

Per Username-Password Flow (versione precedente: obsoleta nell'inverno 2027):

  • Hai creato un account amministrativo Salesforce e ho annotato il nome utente e la password utilizzati per connetterti a Salesforce.

  • È stato copiato il token di sicurezza Salesforce associato all'account utilizzato per connettersi a Salesforce.

  • Hai creato un account Salesforce Connected App con OAuth attivato e hai copiato la chiave utente (ID cliente) e il segreto utente (segreto cliente) assegnati alla tua app Salesforce Connected. L'ID e il segreto del cliente vengono utilizzati come credenziali di autenticazione archiviate in un segreto. AWS Secrets Manager Per ulteriori informazioni, consulta la documentazione di Salesforce sulle app connesse.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. Si sconsiglia di riutilizzare le credenziali e i segreti tra le diverse fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).

  • Hai copiato l'URL dell'istanza di Salesforce che desideri indicizzare. In genere è https://<company>.salesforce.com/. Il server deve eseguire un’app connessa Salesforce.

  • Sono state aggiunte le credenziali al server Salesforce per un utente con accesso in sola lettura a Salesforce clonando il ReadOnly profilo e quindi aggiungendo le autorizzazioni Visualizza tutti i dati e Gestisci articoli. Queste credenziali identificano l'utente che effettua la connessione e l'app connessa a Salesforce a cui si connette. Amazon Kendra

Per entrambi i flussi:

  • Selezionato che ogni documento è unico in Salesforce e in altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni origine dati che desideri utilizzare per un indice non deve contenere lo stesso documento tra le origini dati. Gli ID dei documenti sono globali per un indice e devono essere univoci per indice.

Nel tuo Account AWS, assicurati di avere:

  • Ha creato un Amazon Kendra indice e, se si utilizza l'API, ha annotato l'ID dell'indice.

  • Ha creato un IAM ruolo per l'origine dati e, se si utilizza l'API, ha annotato l'ARN del IAM ruolo.

    Nota

    Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il tuo IAM ruolo per accedere all'ID AWS Secrets Manager segreto corretto.

  • Ha archiviato le credenziali di autenticazione Salesforce in modo AWS Secrets Manager segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. Ti sconsigliamo di riutilizzare le credenziali e i segreti tra le fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).

Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e un nuovo Secrets Manager segreto quando connetti la tua origine dati Salesforce a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e un Secrets Manager segreto esistenti e un ID di indice.

Istruzioni di connessione

Per connetterti Amazon Kendra all'origine dati Salesforce, devi fornire i dettagli necessari dell'origine dati Salesforce in modo che Amazon Kendra possa accedere ai tuoi dati. Se non hai ancora configurato Salesforce, consulta. Amazon Kendra Prerequisiti

Console

Per connetterti Amazon Kendra a Salesforce:

  1. Accedi Console di gestione AWS e apri la Amazon Kendra console.

  2. Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.

    Nota

    Puoi scegliere di configurare o modificare le impostazioni di controllo dell'accesso utente in Impostazioni dell'indice.

  3. Nella pagina Guida introduttiva, scegli Aggiungi origine dati.

  4. Nella pagina Aggiungi origine dati, scegli il connettore Salesforce, quindi scegli Aggiungi connettore. Se utilizzi la versione 2 (se applicabile), scegli il connettore Salesforce con il tag V2.0 "».

  5. Nella pagina Specifica i dettagli dell'origine dati, inserisci le seguenti informazioni:

    1. In Nome e descrizione, per Nome origine dati: inserisci un nome per l'origine dati. È possibile includere trattini ma non spazi.

    2. (Facoltativo) Descrizione: inserisci una descrizione opzionale per l'origine dati.

    3. Nella lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Salvo diversa indicazione, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.

    4. In Tag, per Aggiungi nuovo tag: includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS

    5. Scegli Next (Successivo).

  6. Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:

    1. URL Salesforce: inserisci l'URL dell'istanza per il sito Salesforce che desideri indicizzare.

    2. Autorizzazione: attiva o disattiva le informazioni dell'elenco di controllo degli accessi (ACL) per i tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.

    3. Inserisci un segreto esistente o, se ne crei uno nuovo, si apre una finestra AWS Secrets Manager segreta.

      1. Autenticazione: scegli il tipo di autenticazione:

        • Client Credentials Flow (consigliato): utilizza solo client_id e client_secret per le integrazioni da server a server.

        • Username-Password Flow (Legacy): utilizza nome utente, password, token di sicurezza, chiave utente e segreto utente. Obsoleto da Salesforce nell'inverno del 2027.

      2. Nome segreto: un nome per il segreto. Il prefisso 'AmazonKendra-Salesforce-' viene aggiunto automaticamente al tuo nome segreto.

      3. Per Client Credentials Flow:

        • Chiave utente: l'ID del cliente dall'app client esterna Salesforce

        • Segreto per i consumatori: il segreto del cliente contenuto nell'app Salesforce External Client

        • URL di autenticazione: l'URL del tuo dominio personale (ad esempio,). https://<orgDomain>.my.salesforce.com/services/oauth2/token

          Nota

          https://login.salesforce.come non https://test.salesforce.com sono supportati per questo flusso.

      4. Per Username-Password Flow:

        • Nome utente: il nome utente dell'amministratore di Salesforce

        • Password: la tua password di amministratore di Salesforce

        • Token di sicurezza: il token di sicurezza per il tuo account Salesforce

        • Chiave utente: l'ID cliente della tua app Salesforce Connected

        • Segreto per i consumatori: il segreto del cliente della tua app Salesforce Connected

        • URL di autenticazione: per Salesforce Developer Edition, utilizza https://login.salesforce.com/services/oauth2/token il tuo URL di accesso a My Domain (ad esempio,). https://MyCompany.my.salesforce.com Per Salesforce Sandbox Edition, utilizza il nostro URL https://test.salesforce.com/services/oauth2/token di accesso a My Domain (ad esempio,). MyDomainName--SandboxName.sandbox.my.salesforce.com

      5. Scegli Salva autenticazione.

    4. Virtual Private Cloud (VPC): puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere sottoreti e gruppi di sicurezza VPC.

    5. Identity crawler: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) dei documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il Amazon Kendra filtro del contesto utente dei risultati di ricerca. Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto utente.

    6. IAM ruolo: scegli un ruolo esistente o crea un nuovo IAM IAM ruolo per accedere alle credenziali del repository e ai contenuti dell'indice.

      Nota

      IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le origini dati. Se non sei sicuro che venga utilizzato un ruolo esistente per un indice o per le domande frequenti, scegli Crea un nuovo ruolo per evitare errori.

    7. Scegli Next (Successivo).

  7. Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:

    1. Per la scansione degli allegati: seleziona questa opzione per eseguire la scansione di tutti gli oggetti Salesforce allegati.

    2. Per gli oggetti standard, gli oggetti standard con allegati e gli oggetti standard senza allegati e gli articoli della conoscenza: seleziona le entità o i tipi di contenuto di Salesforce che desideri scansionare.

    3. È necessario fornire informazioni di configurazione per l’indicizzazione di almeno uno degli oggetti standard, degli articoli di conoscenza o dei feed di Chatter. Se scegli di eseguire la scansione degli articoli della conoscenza, devi specificare i tipi di articoli di conoscenza da indicizzare. Puoi scegliere tra bozze pubblicate, archiviate e allegati.

      Filtro Regex: specifica un modello regex per includere elementi del catalogo specifici.

  8. Per una configurazione aggiuntiva:

    • Informazioni ACL Tutte le liste di controllo degli accessi sono incluse per impostazione predefinita. La deselezione di un elenco di controllo degli accessi renderà pubblici tutti i file di quella categoria.

    • Schemi Regex: aggiungi modelli di espressioni regolari per includere o escludere determinati file. È possibile aggiungere fino a 100 modelli.

    Modalità di sincronizzazione: scegli come aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. È necessario eseguire una sincronizzazione completa dei dati se la sincronizzazione iniziale non è riuscita, anche se non si sceglie la sincronizzazione completa come opzione della modalità di sincronizzazione.

    • Sincronizzazione completa: indicizza automaticamente tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

    • Nuova sincronizzazione modificata: indicizza solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

    • Sincronizzazione nuova, modificata ed eliminata: indicizza solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  9. Scegli Next (Successivo).

  10. Nella pagina Imposta le mappature dei campi, inserisci le seguenti informazioni:

    1. Per l'articolo di conoscenza standard, Allegati agli oggetti standard e Mappature dei campi suggerite aggiuntive: seleziona dall'origine dati predefinita Amazon Kendra generata i campi che desideri mappare al tuo indice.

      Nota

      È richiesto il mapping dell'indice a. _document_body Non è possibile modificare la mappatura tra il campo Salesforce ID e il campo Amazon Kendra _document_id . Puoi mappare qualsiasi campo Salesforce ai campi dell'indice Amazon reserved/default Kendra del titolo o del corpo del documento.

      Se assegni un campo Salesforce ai campi del titolo e del corpo del documento Amazon Kendra, Amazon Kendra utilizzerà i dati dei campi del titolo e del corpo del documento nelle risposte di ricerca.

    2. Aggiungi campo: per aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.

    3. Scegli Next (Successivo).

  11. Nella pagina Rivedi e crea, verifica che le informazioni inserite siano corrette, quindi seleziona Aggiungi origine dati. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina Origini dati dopo che l'origine dati è stata aggiunta correttamente.

API

Per connettersi Amazon Kendra a Salesforce

È necessario specificare un JSON dello schema dell'origine dati utilizzando l'TemplateConfigurationAPI. È necessario fornire le seguenti informazioni:

  • Origine dati: specificare il tipo di origine dati utilizzato SALESFORCEV2 quando si utilizza lo schema TemplateConfiguration JSON. Specifica inoltre l'origine dati come TEMPLATE quando chiami l'CreateDataSourceAPI.

  • URL host: specifica l'URL host dell'istanza Salesforce.

  • Modalità di sincronizzazione: specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. È necessario eseguire una sincronizzazione completa dei dati se la sincronizzazione iniziale non è riuscita, anche se non si sceglie la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:

    • FORCED_FULL_CRAWLper indicizzare di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

    • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

    • CHANGE_LOGper indicizzare solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • Secret Amazon Resource Name (ARN): fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione per il tuo account Salesforce. Il segreto è archiviato in una struttura JSON con le seguenti chiavi:

    { "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 ruolo: specifica RoleArn quando chiami CreateDataSource per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e per chiamare le API pubbliche richieste per il connettore Salesforce e. Amazon Kendra Per ulteriori informazioni, consulta i IAM ruoli per le origini dati Salesforce.

Puoi anche aggiungere le seguenti funzionalità opzionali:

  • Virtual Private Cloud (VPC): specifica VpcConfiguration quando chiami. CreateDataSource Per ulteriori informazioni, consulta Configurazione Amazon Kendra per l'utilizzo di un Amazon VPC.

  • Filtri di inclusione ed esclusione: puoi specificare se includere o escludere determinati documenti, account, campagne, casi, contatti, lead, opportunità, soluzioni, attività, gruppi, chat e file di entità personalizzati.

    Nota

    La maggior parte delle origini dati utilizza modelli di espressioni regolari, che sono modelli di inclusione o esclusione denominati filtri. Se si specifica un filtro di inclusione, viene indicizzato solo il contenuto che corrisponde al filtro di inclusione. Qualsiasi documento che non corrisponde al filtro di inclusione non viene indicizzato. Se si specifica un filtro di inclusione ed esclusione, i documenti che corrispondono al filtro di esclusione non vengono indicizzati, anche se corrispondono al filtro di inclusione.

  • Identity crawler: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) dei documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo ai documenti. Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il Amazon Kendra filtro del contesto utente dei risultati di ricerca. Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto utente.

  • Mappature dei campi: scegli di mappare i campi dell'origine dati Salesforce ai campi dell'indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.

    Nota

    Il campo del corpo del documento o l'equivalente del corpo del documento per i tuoi documenti è obbligatorio per Amazon Kendra poter cercare i tuoi documenti. È necessario associare il nome del campo del corpo del documento nell'origine dati al nome del campo indice_document_body. Tutti gli altri campi sono facoltativi.

    Nota

    È richiesto il mapping dell'indice _document_body a. Non è possibile modificare la mappatura tra il campo Salesforce ID e il campo Amazon Kendra _document_id . Puoi mappare qualsiasi campo Salesforce ai campi dell'indice Amazon reserved/default Kendra del titolo o del corpo del documento.

    Se assegni un campo Salesforce ai campi del titolo e del corpo del documento Amazon Kendra, Amazon Kendra utilizzerà i dati dei campi del titolo e del corpo del documento nelle risposte di ricerca.

Per un elenco di altre importanti chiavi JSON da configurare, consulta lo schema del modello di Salesforce. https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-salesforce-schema

Ulteriori informazioni

Per saperne di più sull'integrazione Amazon Kendra con la tua fonte di dati Salesforce, consulta:

Note

  • Quando gli elenchi di controllo degli accessi (ACL) sono abilitati, l'opzione «Sincronizza solo contenuti nuovi o modificati» non è disponibile a causa delle limitazioni dell'API Salesforce. Si consiglia invece di utilizzare le modalità “Sincronizzazione completa” o “Sincronizzazione dei contenuti nuovi, modificati o eliminati” oppure di disabilitare le ACL se è necessario utilizzare questa modalità di sincronizzazione.