View a markdown version of this page

Eine ServiceNow Datenquelle verbinden - Amazon Bedrock
Erstellen Sie die DatenquelleConnector-ParameterNächste Schritte

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. 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/. Wählen Sie im Navigationsbereich Knowledge Bases aus und öffnen Sie Ihre verwaltete Wissensdatenbank.

  2. Geben Sie unter Datenquelle einen Namen für Ihre Datenquelle ein.

  3. Wählen Sie in der Liste Datenquellentyp die Option aus ServiceNow.

  4. Geben Sie als Host-URL Ihre ServiceNow Instanz-URL ein (z. B.https://INSTANCE.service-now.com).

  5. Wählen oder erstellen Sie unter Authentifizierung ein AWS Secrets Manager Geheimnis, das Ihre clientIdclientSecret, und enthältinstanceUrl.

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

  7. (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 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 auf1. Informationen zu Feldern, die umgebrochen werden connectorParameters (z. B. deletionProtectionConfiguration undmediaExtractionConfiguration), finden Sie unterVerbinden einer Datenquelle.

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.

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