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) 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 di origine dati Amazon Kendra Salesforce supporta le seguenti edizioni Salesforce: Developer Edition ed Enterprise Edition.
Il connettore Salesforce V1.0/ è terminato nel 2023. SalesforceConfiguration API Si consiglia di eseguire la migrazione o l'utilizzo del connettore Salesforce V2.0/. TemplateConfiguration API
Per la risoluzione dei 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
-
Filtri di inclusione/esclusione
-
Sincronizzazione completa e incrementale dei contenuti
-
Cloud privato virtuale () VPC
Prerequisiti
Prima di utilizzarla Amazon Kendra per indicizzare la tua fonte di dati Salesforce, apporta queste modifiche a Salesforce e agli account. AWS
In Salesforce, assicurati di avere:
-
Hai creato un account amministrativo Salesforce e hai annotato il nome utente e la password utilizzati per connetterti a Salesforce.
-
Ha 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 copiato la chiave utente (ID client) e il segreto del consumatore (segreto del cliente) assegnati alla tua app Salesforce Connected. L'ID client 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.
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e nelle versioni 1.0 e 2.0 dei connettori (ove applicabile).
-
Hai copiato l'istanza URL di Salesforce che desideri indicizzare. In genere, si tratta di https://<company>.salesforce.com/. Il server deve eseguire un'app connessa a Salesforce.
-
Sono state aggiunte 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 Salesforce a cui si connette. Amazon Kendra
-
Controllato, ogni documento è unico in Salesforce e tra le altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni fonte di dati che desideri utilizzare per un indice non deve contenere lo stesso documento in tutte le fonti di dati. IDsI documenti sono globali rispetto a 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 ilAPI, ha annotato l'ID dell'indice.
-
Hai creato un IAM ruolo per la tua fonte di dati e, se utilizzi ilAPI, hai annotato il IAM ruolo. ARN
Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID AWS Secrets Manager segreto corretto.
-
Ha archiviato le credenziali di autenticazione Salesforce in un luogo AWS Secrets Manager segreto e, se si utilizza ilAPI, ha annotato il ARN segreto.
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e nelle 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 Secrets Manager segreto quando connetti la tua fonte di dati Salesforce a. Amazon Kendra Se si utilizza ilAPI, è necessario fornire un IAM ruolo e un Secrets Manager segreto esistenti e un ID di indice. ARN
Istruzioni di connessione
Per connetterti Amazon Kendra alla tua fonte dati Salesforce, devi fornire i dettagli necessari della fonte dati Salesforce in modo che Amazon Kendra possa accedere ai tuoi dati. Se non hai ancora configurato Salesforce, vedi. Amazon Kendra Prerequisiti
- Console
-
Per connetterti a Amazon Kendra Salesforce:
-
Accedi a AWS Management Console e apri la Amazon Kendra console.
-
Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.
Puoi scegliere di configurare o modificare le impostazioni del controllo dell'accesso degli utenti in Impostazioni dell'indice.
-
Nella pagina Guida introduttiva, scegli Aggiungi origine dati.
-
Nella pagina Aggiungi origine dati, scegli Connettore Salesforce, quindi scegli Aggiungi connettore. Se utilizzi la versione 2 (se applicabile), scegli il connettore Salesforce con il tag «V2.0".
-
Nella pagina Specificare i dettagli dell'origine dati, inserisci le seguenti informazioni:
-
In Nome e descrizione, per Nome dell'origine dati, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.
-
(Facoltativo) Descrizione: immetti una descrizione facoltativa per l'origine dati.
-
In Lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.
-
In Tag, per Aggiungi nuovo tag, includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS
-
Scegli Next (Successivo).
-
Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:
-
Salesforce URL: immetti l'istanza URL del sito Salesforce che desideri indicizzare.
-
Autorizzazione: attiva o disattiva le informazioni della lista di controllo degli accessi (ACL) per i tuoi documenti, se ne hai una ACL e desideri utilizzarla per il controllo degli accessi. ACLspecifica a quali documenti possono accedere utenti e gruppi. Le ACL informazioni vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta Filtraggio del contesto utente.
-
Inserisci un segreto esistente o se ne crei uno nuovo, si apre una finestra AWS
Secrets Manager segreta.
-
Autenticazione: inserisci le seguenti informazioni nella finestra Crea un AWS
Secrets Manager segreto:
-
Nome segreto: un nome per il tuo segreto. Il prefisso 'AmazonKendra-Salesforce-' viene aggiunto automaticamente al nome segreto.
-
Per nome utente, password, token di sicurezza, chiave utente, segreto utente e autenticazione, URL inserisci i valori delle credenziali di autenticazione che hai generato e scaricato dal tuo account Salesforce.
Se utilizzi Salesforce Developer Edition, utilizza https://login.salesforce.com/services/oauth2/token o il login My Domain (ad esempio, URL
https://MyCompany.my.salesforce.com) come autenticazione. URL Se utilizzi Salesforce Sandbox Edition, utilizza https://test.salesforce.com/services/oauth2/token o il login My Domain URL (ad esempio,
MyDomainName--SandboxName.sandbox.my.salesforce.com) come autenticazione. URL
-
Scegli Salva autenticazione.
-
Virtual Private Cloud (VPC): puoi scegliere di utilizzare unVPC. In tal caso, è necessario aggiungere sottoreti e VPC gruppi di sicurezza.
-
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) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. Se ne hai uno ACL per i tuoi documenti e scegli di utilizzare il tuoACL, puoi anche scegliere di attivare il crawler Amazon Kendra di identità per configurare il filtraggio contestuale dell'utente dei risultati di ricerca. Altrimenti, se il crawler di identità è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo di accesso per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzarlo PutPrincipalMappingAPIper caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.
-
IAM ruolo: scegli un IAM ruolo esistente o creane uno nuovo IAM per accedere alle credenziali del repository e indicizzare il contenuto.
IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice oppure FAQ scegli Crea un nuovo ruolo per evitare errori.
-
Scegli Next (Successivo).
-
Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:
-
Per indicizzare gli allegati: seleziona per eseguire la scansione di tutti gli oggetti Salesforce collegati.
-
Per gli oggetti Standard, gli oggetti Standard con allegati e gli Oggetti Standard senza allegati e Knowledge Articles, seleziona le entità o i tipi di contenuto Salesforce che desideri sottoporre a scansione.
-
È 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 di Knowledge, devi specificare i tipi di articoli della Knowledge Base da indicizzare. Puoi scegliere bozze e allegati pubblicati, archiviati.
Filtro Regex: specifica un modello regex per includere elementi specifici del catalogo.
-
Per una configurazione aggiuntiva:
-
ACLinformazioni Tutti gli elenchi di controllo degli accessi sono inclusi per impostazione predefinita. La deselezione di un elenco di controllo degli accessi renderà pubblici tutti i file di quella categoria.
-
Modelli Regex: aggiungono modelli di espressioni regolari per includere o escludere determinati file. È possibile aggiungere fino a 100 pattern.
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. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione.
-
Sincronizzazione completa: indicizza di nuovo 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 può 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 può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
-
Scegli Next (Successivo).
-
Nella pagina Imposta mappature dei campi, inserisci le seguenti informazioni:
-
Per gli articoli Standard Knowledge, gli allegati degli oggetti standard e le mappature di campo consigliate aggiuntive, seleziona uno dei campi di origine dati predefiniti Amazon Kendra generati che desideri mappare all'indice.
È richiesta una mappatura dell'indice a. _document_body Non è possibile modificare la mappatura tra Salesforce ID campo e campo Amazon Kendra
_document_id . Puoi mappare qualsiasi campo Salesforce ai campi indice riservati/predefiniti del titolo o del corpo del documento di Amazon Kendra.
Se mappi un campo Salesforce ai campi del titolo e del corpo del documento di Amazon Kendra, Amazon Kendra utilizzerà i dati dei campi titolo e corpo del documento nelle risposte di ricerca.
-
Aggiungi campo: consente di aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.
-
Scegli Next (Successivo).
-
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 sarà stata aggiunta correttamente.
- API
-
Per connettersi Amazon Kendra a Salesforce
È necessario specificare uno schema JSON dell'origine dati utilizzando. TemplateConfigurationAPI È necessario fornire le seguenti informazioni:
-
Origine dati: specificare il tipo di origine dati come SALESFORCEV2 quando si utilizza il TemplateConfigurationJSONschema. Specificate anche l'origine dati come TEMPLATE quando chiamate il CreateDataSource
API.
-
Host URL: specifica l'host dell'istanza Salesforce. URL
-
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. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:
-
FORCED_FULL_CRAWLper indicizzare nuovamente 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 può 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 contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
-
Amazon Resource Name segreto (ARN): fornisci il nome della risorsa Amazon (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione per il tuo account Salesforce. Il segreto è memorizzato in una JSON struttura 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 il pubblico richiesto APIs per il connettore Salesforce e. Amazon Kendra Per ulteriori informazioni, consulta i IAM ruoli per le fonti di dati Salesforce.
Puoi anche aggiungere le seguenti funzionalità opzionali:
-
Virtual Private Cloud (VPC): specifica VpcConfiguration quando si chiamaCreateDataSource. 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.
La maggior parte delle fonti di 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) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. Se ne hai uno ACL per i tuoi documenti e scegli di utilizzare il tuoACL, puoi anche scegliere di attivare il crawler Amazon Kendra di identità per configurare il filtraggio contestuale dell'utente dei risultati di ricerca. Altrimenti, se il crawler di identità è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo di accesso per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzarlo PutPrincipalMappingAPIper caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.
-
Mappature dei campi: scegli di mappare i campi delle sorgenti dati di Salesforce ai campi indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per eseguire la ricerca nei documenti. Amazon Kendra È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice_document_body. Tutti gli altri campi sono facoltativi.
È richiesta una mappatura dell'indice _document_body a. Non è possibile modificare la mappatura tra Salesforce ID campo e campo Amazon Kendra
_document_id . Puoi mappare qualsiasi campo Salesforce ai campi indice riservati/predefiniti del titolo o del corpo del documento di Amazon Kendra.
Se mappi un campo Salesforce ai campi del titolo e del corpo del documento di Amazon Kendra, Amazon Kendra utilizzerà i dati dei campi titolo e corpo del documento nelle risposte di ricerca.
Per un elenco di altre JSON chiavi importanti da configurare, consulta lo schema del modello Salesforce.
Ulteriori informazioni
Per saperne di più sull'integrazione Amazon Kendra con la tua fonte di dati Salesforce, consulta:
