View a markdown version of this page

Connetti una fonte di ServiceNow dati - Amazon Bedrock

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

Connetti una fonte di ServiceNow dati

Dopo aver impostato l'autenticazione e archiviato le credenziali in modo AWS Secrets Manager segreto, crea l'origine ServiceNow dati nella tua knowledge base. Questa pagina descrive come creare l'origine dati con Console di gestione AWS o l'API, seguita da un riferimento per i parametri del connettore che è possibile configurare.

Nota

Completa prima la configurazione dell'autenticazione. Consulta Configurare l'autenticazione delle credenziali client OAuth 2.0 per ServiceNow. Ti serve l'ARN segreto.

Crea l'origine dati

Console
Per connetterti ServiceNow alla tua knowledge base gestita
  1. Apri la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/. Nel pannello di navigazione, scegli Knowledge Bases e apri la tua knowledge base gestita.

  2. In Fonte dati, fornisci un nome per la tua origine dati.

  3. Dall'elenco Tipo di origine dati, seleziona ServiceNow.

  4. Per Host URL, inserisci l'URL della tua ServiceNow istanza (ad esempio,https://INSTANCE.service-now.com).

  5. In Autenticazione, seleziona o crea un AWS Secrets Manager segreto contenente i tuoiclientId,clientSecret, einstanceUrl.

  6. In Ambito di sincronizzazione, seleziona il contenuto da scansionare: articoli informativi, elementi del catalogo dei servizi e relativi allegati. Puoi anche scegliere se eseguire la scansione degli elementi inattivi del catalogo dei servizi e se limitare la scansione solo agli articoli di pubblico dominio.

  7. (Facoltativo) Per limitare la ricerca per indicizzazione, aggiungi i filtri della knowledge base, della categoria degli articoli di conoscenza o del catalogo dei servizi.

API

Per creare un'origine ServiceNow dati, invia una CreateDataSource richiesta con un endpoint build-time di Agents for Amazon Bedrock. L' AWS Command Line Interface esempio seguente crea un'origine dati. ServiceNow Per una descrizione di ogni campo, vedere il riferimento ai parametri del connettore che segue.

aws bedrock-agent create-data-source \ --name "ServiceNow-connector" \ --knowledge-base-id "your-knowledge-base-id" \ --data-source-configuration file://servicenow-managed-connector.json

Il servicenow-managed-connector.json file contiene quanto segue:

{ "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "SERVICENOW", "connectorType": "SERVICENOW", "version": "1", "connectionConfiguration": { "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-servicenow-creds", "authType": "OAUTH2", "hostUrl": "https://INSTANCE.service-now.com" }, "dataEntityConfiguration": { "crawlKnowledgeArticles": true, "crawlServiceCatalogs": true, "crawlKnowledgeArticleAttachments": true, "crawlServiceCatalogAttachments": true, "crawlInactiveServiceCatalogItems": false, "crawlPublicKnowledgeArticlesOnly": false }, "filterConfiguration": { "knowledgeArticleFilter": { "inclusionKnowledgeBaseSysIds": ["optional-kb-sys-id"], "inclusionKnowledgeArticleCategorySysIds": [] }, "serviceCatalogFilter": { "inclusionServiceCatalogSysIds": [], "inclusionServiceCatalogCategorySysIds": [] }, "maxFileSizeInMegaBytes": "500" } } } }

I dataEntityConfiguration campi controllano quali entità vengono scansionate dal connettore. Il filterConfiguration campo è facoltativo; utilizzalo per definire l'ambito della ricerca per indicizzazione verso specifiche knowledge base, categorie di articoli di conoscenza o cataloghi di servizi e per impostare una dimensione massima del file. Senza filtri, il connettore esegue la scansione di tutti gli articoli della Knowledge Base e degli elementi del catalogo dei servizi attivi.

Per le knowledge base gestite, CreateDataSource è asincrono: lo stato dell'origine dati passa da CREATING a quando l'operazione viene completata. AVAILABLE

Parametri dei connettori

La configurazione dell'origine dati utilizza i seguenti parametri del connettore. All'internoconnectorParameters, imposta entrambi type e connectorType su SERVICENOW e imposta version su1. Per i campi sovrapposti connectorParameters (ad esempio deletionProtectionConfiguration emediaExtractionConfiguration), consultaConnettere un’origine dati.

La tabella seguente descrive i connectionConfiguration campi.

connectionConfiguration
Campo Richiesto Descrizione
secretArn L'ARN del AWS Secrets Manager segreto contenente i tuoiclientId,clientSecret, einstanceUrl.
hostUrl L'URL della tua ServiceNow istanza (ad esempio,https://INSTANCE.service-now.com).
authType Il tipo di autenticazione. ServiceNow supportaOAUTH2. Consulta Metodo di autenticazione.

La tabella seguente descrive i dataEntityConfiguration campi che controllano le entità sottoposte a scansione dal connettore.

dati EntityConfiguration
Campo Richiesto Descrizione
crawlKnowledgeArticles Se eseguire la scansione degli articoli di conoscenza (kb_knowledge).
crawlServiceCatalogs Se eseguire la scansione degli elementi del catalogo dei servizi ()sc_cat_item.
crawlKnowledgeArticleAttachments Se eseguire la scansione degli allegati negli articoli di conoscenza.
crawlServiceCatalogAttachments Se eseguire la scansione degli allegati sugli elementi del catalogo dei servizi.
crawlInactiveServiceCatalogItems Se eseguire la scansione degli elementi inattivi del catalogo dei servizi.
crawlPublicKnowledgeArticlesOnly Se limitare la scansione solo agli articoli di pubblico dominio.

La tabella seguente descrive i filterConfiguration campi opzionali che riguardano la ricerca per indicizzazione.

Configurazione del filtro (opzionale)
Campo Richiesto Description
knowledgeArticleFilter No Visualizzazione degli articoli di conoscenza di Scopes. Contiene inclusionKnowledgeBaseSysIds (un elenco di ID di sistema della knowledge base) e inclusionKnowledgeArticleCategorySysIds (un elenco di ID di sistema delle categorie degli articoli di conoscenza).
serviceCatalogFilter No Scansione del catalogo dei servizi Scopes. Contiene inclusionServiceCatalogSysIds (un elenco di ID di sistema del catalogo dei servizi) e inclusionServiceCatalogCategorySysIds (un elenco degli ID di sistema delle categorie del catalogo dei servizi). In casi di grandi dimensioni, il filtraggio per ID di sistema riduce significativamente il tempo di sincronizzazione.
maxFileSizeInMegaBytes No Dimensione massima, in megabyte, di ogni singolo file inserito dal connettore. Fornire come stringa numerica (ad esempio,). "500"

Fasi successive

Dopo aver creato l'origine dati, sincronizzala per inserire i contenuti nella tua knowledge base. Per informazioni dettagliate, vedi Sincronizzare un’origine dati. Poiché ServiceNow non supporta il controllo degli accessi a livello di documento, tutti gli utenti autenticati che possono interrogare la knowledge base possono vedere tutti i contenuti sottoposti a scansione.