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 V1.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.
Amazon Kendra utilizza l'API Salesforce versione 48. L'API Salesforce limita il numero di richieste che puoi effettuare al giorno. Se Salesforce supera tali richieste, riprova finché non è in grado di continuare.
Il V1.0 SalesforceConfiguration connettore/API Salesforce è terminato nel 2023. Ti consigliamo di migrare o utilizzare il V2.0 connettore/API di 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à:
Prerequisiti
Prima di poterli utilizzare Amazon Kendra per indicizzare l'origine dati Salesforce, apporta queste modifiche a Salesforce e AWS agli account.
In Salesforce, assicurati di avere:
-
Hai creato un account Salesforce e hai annotato il nome utente e la password utilizzati per connetterti a Salesforce.
-
Hai creato un account Salesforce Connected App con OAuth attivato e hai copiato la chiave utente (ID cliente) e il segreto del consumatore (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.
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).
-
È stato copiato il token di sicurezza Salesforce associato all'account utilizzato per connettersi a Salesforce.
-
È stato copiato l'URL dell'istanza di Salesforce che si desidera 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
-
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.
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.
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 a Amazon Kendra Salesforce
-
Accedi alla console di AWS gestione 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 di controllo dell'accesso utente in Impostazioni dell'indice.
-
Nella pagina Guida introduttiva, scegli Aggiungi origine dati.
-
Nella pagina Aggiungi origine dati, scegli il connettore Salesforce V1.0, quindi scegli Aggiungi connettore.
-
Nella pagina Specifica i dettagli dell'origine dati, inserisci le seguenti informazioni:
-
Nome origine dati: inserisci un nome per l'origine dati. È possibile includere trattini ma non spazi.
-
(Facoltativo) Descrizione: inserisci una descrizione opzionale per l'origine dati.
-
Lingua predefinita: una lingua per filtrare i documenti per l'indice. Salvo diversa indicazione, la lingua predefinita è l'inglese. La lingua specificata nei metadati ha la precedenza sulla lingua selezionata.
-
Aggiungi un nuovo tag: tag per cercare e filtrare le risorse o tenere traccia dei costi condivisi.
-
Scegli Next (Successivo).
-
Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:
-
URL Salesforce: inserisci l'URL dell'istanza per il sito Salesforce che desideri indicizzare.
-
Per Tipo di autenticazione, scegli tra Esistente e Nuovo per archiviare le tue credenziali di autenticazione Salesforce. Se scegli di creare un nuovo segreto, si apre una finestra AWS
Secrets Manager segreta.
-
Inserisci le seguenti informazioni nella finestra Crea un AWS
Secrets Manager segreto:
-
Nome segreto: un nome per il segreto. Il prefisso 'AmazonKendra-Salesforce-' viene aggiunto automaticamente al tuo nome segreto.
-
Per Nome utente, password, token di sicurezza, chiave di consumo , segreto di consumo e URL di autenticazione: inserisci i valori delle credenziali di autenticazione che hai creato nel tuo account Salesforce.
-
Scegli Salva autenticazione.
-
IAM ruolo: scegli un IAM ruolo esistente o crea un nuovo IAM ruolo per accedere alle credenziali del repository e ai contenuti dell'indice.
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.
-
Scegli Next (Successivo).
-
Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:
-
Per la scansione degli allegati: seleziona questa opzione per scansionare tutti gli oggetti, gli articoli e i feed allegati.
-
Per oggetti standard, articoli di Knowledge e feed di Chatter: seleziona le entità o i tipi di contenuto di Salesforce che desideri scansionare.
È necessario fornire informazioni di configurazione per l’indicizzazione di almeno uno degli oggetti standard, degli articoli di conoscenza o dei feed di Chatter. Se si sceglie di eseguire il crawling degli Articoli di conoscenza, è necessario specificare i tipi di articoli di conoscenza da indicizzare, il nome degli articoli e se indicizzare i campi standard di tutti gli articoli di conoscenza o solo i campi di un tipo di articolo personalizzato. Se si sceglie di indicizzare gli articoli personalizzati, è necessario specificare il nome interno del tipo di articolo. Puoi specificare fino a 10 tipi di articoli.
-
Frequenza: con quale frequenza Amazon Kendra verrà eseguita la sincronizzazione con l'origine dati.
-
Scegli Next (Successivo).
-
Nella pagina Imposta le mappature dei campi, inserisci le seguenti informazioni:
-
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.
È 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 .
-
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.
-
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 è stata aggiunta correttamente.
- API
-
Per connettersi Amazon Kendra a Salesforce
È necessario specificare quanto segue l'SalesforceConfigurationAPI:
-
URL del server: l'URL dell'istanza per il sito Salesforce che desideri indicizzare.
-
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.
-
È necessario fornire informazioni di configurazione per l’indicizzazione di almeno uno degli oggetti standard, degli articoli di conoscenza o dei feed di Chatter.
-
Oggetti standard: se si sceglie di eseguire la scansione degli oggetti standard, è necessario specificare il nome dell'oggetto standard e il nome del campo nella tabella degli oggetti standard che contiene il contenuto del documento.
-
Articoli di conoscenza: se scegli di eseguire la scansione degli articoli di conoscenza, devi specificare i tipi di articoli di conoscenza da indicizzare, lo stato degli articoli di conoscenza da indicizzare e se indicizzare i campi standard di tutti gli articoli di conoscenza o solo i campi di un tipo di articolo personalizzato.
-
Feed Chatter: se scegli di eseguire la scansione dei feed di Chatter, devi specificare il nome della colonna nella tabella Salesforce che contiene il contenuto da indicizzare. FeedItem
Puoi anche aggiungere le seguenti funzionalità opzionali:
-
Filtri di inclusione ed esclusione: specificate se includere o escludere determinati file allegati.
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.
-
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.
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.
-
Filtraggio del contesto utente e controllo degli accessi:Amazon Kendra esegue la scansione dell'elenco di controllo degli accessi (ACL) dei documenti, se si dispone di un ACL per i documenti. 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.
