Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Eine ServiceNow Datenquelle verbinden
Nachdem Sie die Authentifizierung eingerichtet und Ihre Anmeldeinformationen AWS Secrets Manager geheim gespeichert haben, erstellen Sie die ServiceNow Datenquelle in Ihrer Wissensdatenbank. Auf dieser Seite wird beschrieben, wie Sie die Datenquelle mit der AWS-Managementkonsole oder der API erstellen, gefolgt von einer Referenz für die Connector-Parameter, die Sie konfigurieren können.
**Anmerkung**
Schließen Sie zuerst die Einrichtung der Authentifizierung ab. Siehe [Richten Sie die OAuth 2.0-Clientanmeldeauthentifizierung ein für ServiceNow](kb-managed-servicenow-oauth2-setup.md). Sie benötigen den geheimen ARN.
## Erstellen Sie die Datenquelle
------
#### [ Console ]
**Um eine Verbindung ServiceNow zu Ihrer verwalteten Wissensdatenbank herzustellen**
1. Öffnen Sie die Amazon Bedrock-Konsole unter [ https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). Wählen Sie im Navigationsbereich ** Knowledge Bases aus ** und öffnen Sie Ihre verwaltete Wissensdatenbank.
1. Geben Sie ** unter ** Datenquelle einen Namen für Ihre Datenquelle ein.
1. Wählen Sie in der ** Liste ** Datenquellentyp die Option aus ** ServiceNow**.
1. Geben Sie als ** Host-URL ** Ihre ServiceNow Instanz-URL ein (z. B.`https://{{INSTANCE}}.service-now.com`).
1. Wählen oder erstellen Sie unter ** Authentifizierung ** ein AWS Secrets Manager Geheimnis, das Ihre `clientId``clientSecret`, und enthält`instanceUrl`.
1. Wählen Sie unter ** Synchronisierungsbereich den Inhalt aus**, der gecrawlt werden soll: Wissensartikel, Servicekatalogeinträge und deren Anlagen. Sie können auch wählen, ob inaktive Servicekatalogeinträge gecrawlt werden sollen und ob das Crawlen nur auf öffentliche Wissensartikel beschränkt werden soll.
1. (Optional) Um das Crawlen einzuschränken, fügen Sie Filter für Wissensdatenbanken, Wissensartikelkategorien oder Servicekataloge hinzu.
------
#### [ API ]
Um eine ServiceNow Datenquelle zu erstellen, senden Sie eine [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) Anfrage an einen Build-Time-Endpunkt für Agents for Amazon Bedrock. Im folgenden AWS Command Line Interface Beispiel wird eine ServiceNow Datenquelle erstellt. Eine Beschreibung der einzelnen Felder finden Sie in der folgenden Referenz zu den Connector-Parametern.
```
aws bedrock-agent create-data-source \
--name "{{ServiceNow-connector}}" \
--knowledge-base-id "{{your-knowledge-base-id}}" \
--data-source-configuration file://servicenow-managed-connector.json
```
Die `servicenow-managed-connector.json` Datei enthält Folgendes:
```
{
"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"
}
}
}
}
```
Die `dataEntityConfiguration` Felder steuern, welche Entitäten der Connector crawlt. Das `filterConfiguration` Feld ist optional. Verwenden Sie es, um den Crawl auf bestimmte Wissensdatenbanken, Wissensartikelkategorien oder Servicekataloge einzugrenzen und eine maximale Dateigröße festzulegen. Ohne Filter durchsucht der Connector alle aktiven Wissensartikel und Servicekatalogeinträge.
Bei verwalteten Wissensdatenbanken `CreateDataSource` ist dies asynchron: Der Status der Datenquelle wechselt von `CREATING` zu, `AVAILABLE` wenn der Vorgang abgeschlossen ist.
------
## Connector-Parameter
Die Datenquellenkonfiguration verwendet die folgenden Connector-Parameter. Stellen Sie innerhalb `connectorParameters` sowohl als auch `connectorType` auf ein `type` `SERVICENOW` und setzen Sie `version` auf`1`. Informationen zu Feldern, die umgebrochen werden `connectorParameters` (z. B. `deletionProtectionConfiguration` und`mediaExtractionConfiguration`), finden Sie unter[Verbinden einer Datenquelle](kb-managed-connect-ds.md).
In der folgenden Tabelle werden die `connectionConfiguration` Felder beschrieben.
**connectionConfiguration**
| Feld | Erforderlich | Beschreibung |
| --- | --- | --- |
| secretArn | Ja | Die ARN des AWS Secrets Manager Geheimnisses, das Ihr clientIdclientSecret, und enthältinstanceUrl. |
| hostUrl | Ja | Ihre ServiceNow Instanz-URL (zum Beispielhttps://{{INSTANCE}}.service-now.com). |
| authType | Ja | Der Authentifizierungstyp. ServiceNow unterstütztOAUTH2. Siehe [Authentifizierungsmethode](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods). |
In der folgenden Tabelle werden die `dataEntityConfiguration` Felder beschrieben, die die Entitäten steuern, die der Connector crawlt.
**Daten EntityConfiguration**
| Feld | Erforderlich | Beschreibung |
| --- | --- | --- |
| crawlKnowledgeArticles | Ja | Ob Wissensartikel gecrawlt werden sollen (kb\_knowledge). |
| crawlServiceCatalogs | Ja | Ob Elemente des Servicekatalogs gecrawlt werden sollen ()sc\_cat\_item. |
| crawlKnowledgeArticleAttachments | Ja | Ob Anlagen von Wissensartikeln gecrawlt werden sollen. |
| crawlServiceCatalogAttachments | Ja | Ob Anlagen zu Servicekatalogeinträgen gecrawlt werden sollen. |
| crawlInactiveServiceCatalogItems | Ja | Ob inaktive Servicekatalogelemente gecrawlt werden sollen. |
| crawlPublicKnowledgeArticlesOnly | Ja | Ob das Crawlen nur auf öffentliche Wissensartikel beschränkt werden soll. |
In der folgenden Tabelle werden die optionalen `filterConfiguration` Felder beschrieben, die den Umfang des Crawls ausmachen.
**Filterkonfiguration (optional)**
| Feld | Erforderlich | Description |
| --- | --- | --- |
| knowledgeArticleFilter | Nein | Crawlen von Wissensartikeln in Bereichen. Enthält inclusionKnowledgeBaseSysIds (eine Liste der Sys-IDs der Wissensdatenbank) und inclusionKnowledgeArticleCategorySysIds (eine Liste der Sys-IDs der Wissensartikel-Kategorie). |
| serviceCatalogFilter | Nein | Bereiche, in denen der Servicekatalog gecrawlt wird. Enthält inclusionServiceCatalogSysIds (eine Liste der Sys-IDs des Servicekatalogs) und inclusionServiceCatalogCategorySysIds (eine Liste der Sys-IDs der Servicekatalogkategorie). Bei großen Instanzen reduziert das Filtern nach der Sys-ID die Synchronisierungszeit erheblich. |
| maxFileSizeInMegaBytes | Nein | Maximale Größe in Megabyte jeder einzelnen Datei, die der Connector aufnimmt. Geben Sie eine numerische Zeichenfolge an (z. B.). "500" |
## Nächste Schritte
Nachdem Sie die Datenquelle erstellt haben, synchronisieren Sie sie, um Inhalte in Ihre Wissensdatenbank aufzunehmen. Details hierzu finden Sie unter [Synchronisieren einer Datenquelle](kb-managed-sync.md). Da die Zugriffskontrolle auf Dokumentebene ServiceNow nicht unterstützt wird, können alle authentifizierten Benutzer, die die Wissensdatenbank abfragen können, den gesamten gecrawlten Inhalt sehen.