View a markdown version of this page

ServiceNow connettore V1.0 - Amazon Kendra
Funzionalità supportatePrerequisitiIstruzioni di connessioneUlteriori informazioni

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 V1.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 di conoscenza e i relativi allegati.

Nota

ServiceNow il V1.0 ServiceNowConfiguration connettore/API è terminato nel 2023. Ti consigliamo di migrare o utilizzare il ServiceNow connettore V2.0 / TemplateConfiguration API.

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à:

  • ServiceNow versioni di esempio: Londra, altre

  • Inclusion/exclusion modelli: cataloghi di servizi, articoli informativi e relativi allegati

Prerequisiti

Prima di poterla utilizzare Amazon Kendra per indicizzare l'origine ServiceNow dati, apporta queste modifiche ai tuoi account ServiceNow . AWS

In ServiceNow, assicurati di avere:

  • Hai creato un account ServiceNow amministratore e hai creato un' ServiceNowistanza.

  • Hai copiato l'host dell'URL dell' ServiceNow istanza. Ad esempio, se l'URL dell'istanza èhttps://your-domain.service-now.com, il formato per l'URL host inserito èyour-domain.service-now.com.

  • Ho notato le tue credenziali di autenticazione di base contenenti un nome utente e una password per consentire la connessione Amazon Kendra all' ServiceNow istanza.

    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 diverse fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).

  • Facoltativo: è stato configurato un token di credenziali OAuth 2.0 in grado di identificare Amazon Kendra e generare un nome utente, una password, un ID client e un segreto client. Il nome utente e la password devono fornire l'accesso alla ServiceNow knowledge base e al catalogo dei servizi. 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.

    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.

  • 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.

    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 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

  1. Accedi alla console di AWS gestione 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 ServiceNow connettore V1.0, quindi scegli Aggiungi origine dati.

  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. Puoi 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 Avanti.

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

    1. ServiceNow host: inserisci l'URL dell' ServiceNowhost.

    2. ServiceNow version: seleziona la tua ServiceNow versione.

    3. Scegli tra l'autenticazione di base e l'autenticazione Oauth 2.0 in base al tuo caso d'uso.

    4. AWS Secrets Manager segreto: scegli un segreto esistente o creane uno nuovo per archiviare le tue Secrets Manager ServiceNow credenziali di autenticazione. Se scegli di creare un nuovo segreto, si apre una finestra AWS Secrets Manager segreta.

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

      2. Se utilizzi l'autenticazione di base, inserisci il nome, il nome utente e la password segreti per il tuo account. ServiceNow

        Se utilizzi l'autenticazione OAuth2, inserisci il nome segreto, il nome utente, la password , l'ID client e il segreto client che hai creato nel tuo account. ServiceNow

      3. Scegli Salva e aggiungi segreto.

    5. 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.

    6. Scegli Avanti.

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

    1. Includi articoli di conoscenza: scegli di indicizzare gli articoli di conoscenza.

    2. Tipo di articoli informativi: scegli tra Includi solo articoli pubblici e Includi articoli 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.

    3. Includi allegati agli articoli di conoscenza: scegli di indicizzare gli allegati degli articoli di conoscenza. Puoi anche selezionare tipi di file specifici da indicizzare.

    4. Includi elementi del catalogo: scegli di indicizzare gli elementi del catalogo.

    5. Includi gli allegati degli elementi del catalogo: scegli di indicizzare gli allegati degli elementi del catalogo. È inoltre possibile selezionare tipi di file specifici da indicizzare.

    6. Frequenza: con quale frequenza Amazon Kendra verrà sincronizzata con l'origine dati.

    7. Scegli Avanti.

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

    1. Articoli della conoscenza e catalogo dei servizi: seleziona tra i campi di origine dati predefiniti Amazon Kendra generati e le mappature dei campi suggerite aggiuntive che desideri mappare al tuo indice.

    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 Avanti.

  9. 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 quanto segue utilizzando l'ServiceNowConfiguration API:

  • URL dell'origine dati: specificare l' ServiceNow URL. L'endpoint host dovrebbe essere simile al seguente:. your-domain.service-now.com

  • Istanza host di origine dati: specificare la versione dell'istanza ServiceNow host come oLONDON. OTHERS

  • 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 utilizza l'autenticazione 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:

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

    Nota

    Il campo relativo al corpo del documento o l'equivalente del corpo del documento è obbligatorio per poter Amazon Kendra effettuare la ricerca 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.

  • Filtri di inclusione ed esclusione: specificate se includere o escludere determinati file allegati di cataloghi e articoli informativi.

    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.

  • Parametri di indicizzazione: puoi anche scegliere di specificare se:

    • Indicizzare articoli informativi e cataloghi di servizi, o entrambi. Se scegli di indicizzare gli articoli della conoscenza e gli elementi del catalogo dei servizi, devi fornire il nome del ServiceNow campo mappato al campo del contenuto del documento di indice nell' Amazon Kendra indice.

    • Indicizza gli allegati agli articoli della conoscenza e agli elementi del catalogo.

    • Usa una ServiceNow query che seleziona i documenti da una o più knowledge base. Le basi di conoscenza possono essere pubbliche o private. Per ulteriori informazioni, consulta la sezione Specifica dei documenti da indicizzare con una query.

Ulteriori informazioni

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