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à.
ServiceNow connettore V2.0
ServiceNow fornisce un sistema di gestione dei servizi basato su cloud per creare e gestire flussi di lavoro a livello di organizzazione, come servizi IT, sistemi di biglietteria e supporto. Puoi utilizzarlo Amazon Kendra per indicizzare i tuoi ServiceNow cataloghi, gli articoli informativi, gli incidenti e i relativi allegati.
Per la risoluzione dei problemi relativi al connettore dell'origine Amazon Kendra ServiceNow dati, consulta. Risoluzione dei problemi relativi alle origini dati
Funzionalità supportate
Amazon Kendra ServiceNow il connettore per origini dati supporta le seguenti funzionalità:
-
Mappature dei campi
-
controllo degli accessi degli utenti
-
Inclusion/exclusion filtri
-
Sincronizzazione completa e incrementale dei contenuti
-
ServiceNow versioni di istanza: Roma, Sandiego, Tokyo, altre
-
Cloud privato virtuale (VPC)
Prerequisiti
Prima di poterla utilizzare Amazon Kendra per indicizzare l'origine ServiceNow dati, apporta queste modifiche ai tuoi ServiceNow AWS account.
In ServiceNow, assicurati di avere:
-
Avere creato un’istanza Personal o Enterprise Developer e disporre di un’istanza di ServiceNow con ruolo di amministratore.
-
Hai copiato l'host dell'URL della tua ServiceNow istanza. Il formato per l'URL dell'host inserito èyour-domain.service-now.com. È necessario l’URL dell’istanza di ServiceNow per la connessione ad Amazon Kendra.
-
Ho annotato le credenziali di autenticazione di base di nome utente e password per consentire la connessione Amazon Kendra all' ServiceNow istanza.
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 diverse fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).
-
Facoltativo: credenziali client OAuth 2.0 configurate in grado di identificarsi Amazon Kendra utilizzando un nome utente, una password, un ID client generato e un segreto client. Per ulteriori informazioni, ServiceNow consulta la documentazione sull'autenticazione OAuth 2.0.
-
Sono state aggiunte le seguenti autorizzazioni:
-
kb_category
-
kb_knowledge
-
kb_knowledge_base
-
kb_uc_cannot_read_mtom
-
kb_uc_can_read_mtom
-
catalogo sc_
-
sc_category
-
sc_cat_item
-
sys_attachment
-
sys_attachment_doc
-
sys_user_role
-
Selezionato che ogni documento è unico nelle ServiceNow e nelle 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 in tutte 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.
-
Hai archiviato le tue credenziali di ServiceNow autenticazione in modo AWS Secrets Manager segreto e, se utilizzi l'API, hai 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 diverse fonti di dati e tra 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 l'origine ServiceNow dati 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 connettersi Amazon Kendra all'origine ServiceNow dati, è necessario fornire i dettagli necessari dell'origine ServiceNow dati in modo che Amazon Kendra possa accedere ai dati. Se non hai ancora configurato ServiceNow per Amazon Kendra SeePrerequisiti.
- Console
-
Per connetterti Amazon Kendra a ServiceNow
-
Accedi Console di gestione AWS 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 ServiceNow connettore, quindi scegli Aggiungi connettore. Se usi la versione 2 (se applicabile), scegli il ServiceNow connettore con il tag V2.0 "».
-
Nella pagina Specifica i dettagli dell'origine dati, inserisci le seguenti informazioni:
-
In Nome e descrizione, per Nome origine dati: inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.
-
(Facoltativo) Descrizione: inserisci una descrizione opzionale per l'origine dati.
-
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.
-
In Tag, per Aggiungi nuovo tag: includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS
-
Scegli Avanti.
-
Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:
-
ServiceNow host: inserisci l'URL dell' ServiceNowhost. Il formato per l'URL dell'host inserito èyour-domain.service-now.com.
-
ServiceNow versione: seleziona la versione dell' ServiceNow istanza. Puoi scegliere tra Roma, Sandiego, Tokyo o Altri.
-
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.
-
Autenticazione: scegli tra l'autenticazione di base e l'autenticazione Oauth 2.0.
-
AWS
Secrets Manager segreto: scegli un segreto esistente o creane uno nuovo per archiviare le tue Secrets Manager credenziali di autenticazione. ServiceNow Se scegli di creare un nuovo segreto, si apre una finestra AWS
Secrets Manager segreta. Nella finestra, immetti le seguenti informazioni:
-
Nome segreto: un nome per il segreto. Il prefisso 'AmazonKendra-ServiceNow-' viene aggiunto automaticamente al tuo nome segreto.
-
Se utilizzi l'autenticazione di base, inserisci il nome, il nome utente e la password segreti per il tuo account. ServiceNow
Se utilizzi OAuth2.0 l'autenticazione, inserisci il nome segreto, il nome utente, la password , l'ID cliente e il segreto cliente che hai creato nel tuo account. ServiceNow
-
Salva e aggiungi il tuo segreto.
-
Virtual Private Cloud (VPC): puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere sottoreti e gruppi di sicurezza VPC.
-
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.
-
IAM ruolo: scegli un ruolo esistente o crea un nuovo IAM 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 Avanti.
-
Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:
-
Per Articoli di conoscenza, scegli tra le seguenti opzioni:
-
Articoli di conoscenza: scegli di indicizzare gli articoli di conoscenza.
-
Allegati agli articoli di conoscenza: scegli di indicizzare gli allegati degli articoli di conoscenza.
-
Tipo di articoli informativi: scegli tra Solo articoli pubblici e Articoli di Knowledge in base alla query di ServiceNow filtro in base al tuo caso d'uso. Se selezioni Includi articoli in base alla query di ServiceNow filtro, devi inserire una query di filtro copiata dal tuo ServiceNow account. Le query di filtro di esempio includono:workflow_state=draft^EQ,,kb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text
ISNOTEMPTY^EQ. article_type=text^active=true^EQ
Se scegli di eseguire la scansione Solo articoli pubblici, esegue la scansione solo degli articoli Amazon Kendra informativi a cui è stato assegnato un ruolo di accesso pubblico in. ServiceNow
-
Includi articoli in base al filtro descrittivo breve: specifica i modelli di espressione regolare per includere o escludere articoli specifici.
-
Per gli Elementi dei cataloghi di servizi:
-
Elementi del catalogo dei servizi: scegli di indicizzare gli elementi del catalogo dei servizi.
-
Allegati degli elementi del catalogo dei servizi: scegliere di indicizzare gli allegati degli elementi del catalogo dei servizi.
-
Elementi del catalogo dei servizi attivi: scegliere di indicizzare gli elementi del catalogo dei servizi attivi.
-
Elementi del catalogo dei servizi inattivi: scegliere di indicizzare gli elementi del catalogo dei servizi inattivi.
-
Interrogazione di filtro: scegli di includere gli elementi del catalogo dei servizi in base a un filtro definito nell'istanza. ServiceNow Le query di filtro di esempio includono:short_descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ,. nameSTARTSWITHService^active=true^EQ
-
Includi elementi del catalogo dei servizi in base al filtro di descrizione breve: specifica un modello regex per includere elementi del catalogo specifici.
-
Per Incidenti:
-
Incidenti: scegli di indicizzare gli incidenti relativi al servizio.
-
Allegati relativi agli incidenti: scegli di indicizzare gli allegati relativi agli incidenti.
-
Incidenti attivi: scegliere di indicizzare gli incidenti attivi.
-
Incidenti inattivi: scegli di indicizzare gli incidenti inattivi.
-
Tipo di incidente attivo: scegli tra Tutti gli incidenti, Incidenti aperti, Incidenti aperti non assegnati e Incidenti risolti a seconda del caso d'uso.
-
Interrogazione con filtro: scegli di includere gli incidenti in base a un filtro definito nell'istanza. ServiceNow Le query di filtro di esempio includono:,. short_descriptionLIKETest^urgency=3^state=1^EQ priority=2^category=software^EQ
-
Includi incidenti in base al filtro di descrizione breve: specifica un modello regex per includere incidenti specifici.
-
Per una configurazione aggiuntiva:
-
Informazioni ACL: le liste di controllo di accesso per le entità selezionate sono incluse per impostazione predefinita. La deselezione di un elenco di controllo degli accessi renderà pubblici tutti i file di quella categoria. Le opzioni ACL vengono disattivate automaticamente per le entità non selezionate. Per gli articoli pubblici, l'ACL non viene applicato.
-
Per la dimensione massima del file: specifica il limite di dimensione dei file in MB che Amazon Kendra eseguirà la scansione. Amazon Kendra eseguirà la scansione solo dei file entro il limite di dimensione definito. La dimensione predefinita dei file è 50 MB. La dimensione massima dei file deve essere maggiore di 0 MB e inferiore o uguale a 50 MB.
-
Schemi di espressione regolare degli allegati: aggiungi modelli di espressioni regolari per includere o escludere determinati file allegati di cataloghi, articoli di conoscenza e incidenti. È 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.
-
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.
-
In Sync run schedule, per Frequenza: scegli la frequenza con cui sincronizzare il contenuto dell'origine dati e aggiornare l'indice.
-
Scegli Avanti.
-
Nella pagina Imposta le mappature dei campi, inserisci le seguenti informazioni:
-
Mappature predefinite dei campi: seleziona tra i campi Amazon Kendra generati dall'origine dati predefinita che desideri mappare al tuo indice.
-
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 Avanti.
-
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 ServiceNow
È 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 SERVICENOWV2 quando si utilizza lo schema TemplateConfiguration JSON. Specifica inoltre l'origine dati come TEMPLATE quando chiami l'CreateDataSourceAPI.
-
URL host: specifica la versione dell'istanza ServiceNow host. Ad esempio, your-domain.service-now.com.
-
Tipo di autenticazione: specifica il tipo di autenticazione che usi, indipendentemente dal fatto che sia basicAuth o OAuth2 per la tua ServiceNow istanza.
-
ServiceNow versione dell'istanza: specifica l' ServiceNow istanza utilizzata, seTokyo, SandiegoRome, o. Others
-
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.
-
Secret Amazon Resource Name (ARN): fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione che hai creato nel tuo account. ServiceNow
Se utilizzi l'autenticazione di base, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:
{
"username": "user name",
"password": "password"
}
-
Se si utilizzano le credenziali del client OAuth2, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
-
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 e. ServiceNow Amazon Kendra Per ulteriori informazioni, consulta IAM Ruoli per ServiceNow le origini dati.
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: è possibile specificare se includere o escludere determinati file allegati utilizzando i nomi dei file e i tipi di file contenuti negli articoli di conoscenza, nei cataloghi di servizi e negli incidenti.
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.
-
Documenti specifici da indicizzare: è possibile utilizzare una ServiceNow query per specificare i documenti desiderati da una o più knowledge base, incluse le knowledge base private. L'accesso alle knowledge base è determinato dall'utente utilizzato per connettersi all' ServiceNow istanza. Per ulteriori informazioni, consulta la sezione Specifica dei documenti da indicizzare con una query.
-
Parametri di indicizzazione: puoi anche scegliere di specificare se:
-
Indicizza gli articoli informativi, i cataloghi di servizi e gli incidenti o tutti questi. Se si sceglie di indicizzare gli articoli della conoscenza, gli elementi del catalogo dei servizi e gli incidenti, è necessario fornire il nome del ServiceNow campo mappato al campo del contenuto del documento indice nell'indice. Amazon Kendra
-
Indicizza gli allegati agli articoli della conoscenza, agli elementi del catalogo dei servizi e agli incidenti.
-
Includi articoli informativi, articoli del catalogo dei servizi e incidenti in base al short description modello di filtro.
-
Scegli di filtrare gli elementi e gli incidenti attivi e inattivi del catalogo dei servizi.
-
Scegli di filtrare gli incidenti in base al tipo di incidente.
-
Scegli quali entità devono sottoporre a scansione i relativi ACL.
-
È possibile utilizzare una ServiceNow query per specificare i documenti desiderati da una o più knowledge base, incluse le knowledge base private. L'accesso alle knowledge base è determinato dall'utente utilizzato per connettersi all' ServiceNowistanza. Per ulteriori informazioni, consulta la sezione Specifica dei documenti da indicizzare con una query.
-
Identity crawler: specifica se attivare il crawler Amazon Kendra di identità. 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 ServiceNow dati ai campi dell'indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
Il campo relativo al corpo del documento o l'equivalente del corpo del documento è obbligatorio per poter Amazon Kendra effettuare ricerche nei 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.
Per un elenco di altre importanti chiavi JSON da configurare, consulta lo schema ServiceNow del modello.
Ulteriori informazioni
Per saperne di più sull'integrazione Amazon Kendra con la tua fonte di ServiceNow dati, consulta: