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](kb-managed-servicenow-oauth2-setup.md). 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/](https://console.aws.amazon.com/bedrock/). Nel pannello di navigazione, scegli ** Knowledge Bases ** e apri la tua knowledge base gestita.
1. In Fonte ** dati**, fornisci un nome per la tua origine dati.
1. Dall'**elenco Tipo di origine ** dati, seleziona ** ServiceNow**.
1. Per ** Host URL**, inserisci l'URL della tua ServiceNow istanza (ad esempio,`https://{{INSTANCE}}.service-now.com`).
1. In ** Autenticazione**, seleziona o crea un AWS Secrets Manager segreto contenente i tuoi`clientId`,`clientSecret`, e`instanceUrl`.
1. 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.
1. (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 ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 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'interno`connectorParameters`, imposta entrambi `type` e `connectorType` su `SERVICENOW` e imposta `version` su`1`. Per i campi sovrapposti `connectorParameters` (ad esempio `deletionProtectionConfiguration` e`mediaExtractionConfiguration`), consulta[Connettere un’origine dati](kb-managed-connect-ds.md).
La tabella seguente descrive i `connectionConfiguration` campi.
**connectionConfiguration**
| Campo | Richiesto | Descrizione |
| --- | --- | --- |
| secretArn | Sì | L'ARN del AWS Secrets Manager segreto contenente i tuoiclientId,clientSecret, einstanceUrl. |
| hostUrl | Sì | L'URL della tua ServiceNow istanza (ad esempio,https://{{INSTANCE}}.service-now.com). |
| authType | Sì | Il tipo di autenticazione. ServiceNow supportaOAUTH2. Consulta [Metodo di autenticazione](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods). |
La tabella seguente descrive i `dataEntityConfiguration` campi che controllano le entità sottoposte a scansione dal connettore.
**dati EntityConfiguration**
| Campo | Richiesto | Descrizione |
| --- | --- | --- |
| crawlKnowledgeArticles | Sì | Se eseguire la scansione degli articoli di conoscenza (kb\_knowledge). |
| crawlServiceCatalogs | Sì | Se eseguire la scansione degli elementi del catalogo dei servizi ()sc\_cat\_item. |
| crawlKnowledgeArticleAttachments | Sì | Se eseguire la scansione degli allegati negli articoli di conoscenza. |
| crawlServiceCatalogAttachments | Sì | Se eseguire la scansione degli allegati sugli elementi del catalogo dei servizi. |
| crawlInactiveServiceCatalogItems | Sì | Se eseguire la scansione degli elementi inattivi del catalogo dei servizi. |
| crawlPublicKnowledgeArticlesOnly | Sì | 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](kb-managed-sync.md). 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.