View a markdown version of this page

Eine Confluence Data Center-Datenquelle verbinden - Amazon Bedrock
Erstellen Sie die DatenquelleConnector-ParameterÄndern Sie die AuthentifizierungsmethodeNä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 Confluence Data Center-Datenquelle verbinden

Nachdem Sie die VPC-Konnektivität eingerichtet und Ihre Anmeldeinformationen AWS Secrets Manager geheim gespeichert haben, erstellen Sie die Confluence Data Center-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 VPC-Konfiguration und das Authentifizierungs-Setup ab. Siehe VPC-Konnektivität für eine Datenquelle konfigurieren und Basic- oder PAT-Authentifizierung für Confluence Data Center einrichten. Sie benötigen die VPC-Konfigurations-ID und den geheimen ARN.

Erstellen Sie die Datenquelle

Console
Um Confluence Data Center mit deiner verwalteten Wissensdatenbank zu verbinden

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

  2. Wähle Confluence Data Center aus dem Drop-down-Menü „Datenquelle“ aus.

  3. Wählen Sie unter VPC-Konfiguration eine VPC-Konfiguration aus, die Ihre Confluence Data Center-Instanz erreicht, oder wählen Sie VPC-Konfiguration hinzufügen, um eine zu erstellen. Details hierzu finden Sie unter VPC-Konnektivität für eine Datenquelle konfigurieren.

  4. (Optional) Geben Sie unter Anwendungskontextpfad den Inhaltspfad ein, unter dem die Confluence Data Center REST-API bereitgestellt wird (z. B.). /wiki Lassen Sie das Feld leer, wenn die REST-API im Web-Root bereitgestellt wird.

  5. (Optional, nur HTTPS) Geben Sie unter TLS-Zertifikat die Amazon S3-URI des TLS-Zertifikats für Ihre Confluence Data Center-Instance an.

  6. Wählen Sie unter Authentifizierung Standardauthentifizierung oder Persönliches Zugriffstoken aus und wählen Sie dann das AWS Secrets Manager Geheimnis aus, das die entsprechenden Anmeldeinformationen enthält.

  7. (Optional) Erweitern Sie den Synchronisierungsbereich, um auszuwählen, welche Entitätstypen gecrawlt werden sollen (Seiten, Seitenanhänge, Blogs, Bloganhänge, persönliche Bereiche).

  8. (Optional) Erweitern Sie Entitäts-URLs, um mithilfe von URL-based Filtern bestimmte Confluence-Bereiche, -Seiten und Blogs zu synchronisieren.

  9. (Optional) Erweitern Sie MIME-Typen, um bestimmte MIME-Typen ein- oder auszuschließen.

API

Um eine Confluence Data Center-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 Datenquelle erstellt, die die Standardauthentifizierung verwendet. Um stattdessen ein persönliches Zugriffstoken zu verwenden, wechseln Sie authType zuPERSONAL_TOKEN. Eine Beschreibung der einzelnen Felder finden Sie in der folgenden Referenz zu den Connector-Parametern.

aws bedrock-agent create-data-source \
 --name "Confluence-DataCenter-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://confluence-onprem-connector.json

Die confluence-onprem-connector.json Datei enthält Folgendes:

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCEONPREM",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "authType": "BASIC",
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-onprem-creds",
                "contextPath": "/wiki",
                "vpcConfiguration": {
                    "vpcConfigurationId": "your-vpc-configuration-id"
                },
                "certificateS3Path": {
                    "s3BucketName": "my-cert-bucket",
                    "s3KeyName": "confluence-dc-cert.pem"
                }
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceUrls": ["https://confluence.example.com/spaces/ENG/"]
            }
        }
    }
}

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. Um eine Verbindung zu Confluence Data Center herzustellen, geben Sie CONFLUENCEONPREM als Connector Folgendes ein. connectorParameters Informationen zu Feldern, die umbrochen werden connectorParameters (wie deletionProtectionConfiguration undmediaExtractionConfiguration), finden Sie unter. Verbinden einer Datenquelle

connectionConfiguration
Feld Erforderlich Beschreibung
authType Ja Der Authentifizierungstyp. Auf BASIC oder setzenPERSONAL_TOKEN. Siehe Authentifizierungsmethoden.
secretArn Ja Der ARN des AWS Secrets Manager Geheimnisses, das Ihre Confluence Data Center-Anmeldeinformationen enthält.
vpcConfiguration Ja Der private Netzwerkpfad zu deiner Confluence Data Center-Instanz. Enthält ein vpcConfigurationId Feld, das auf die ID einer VPC-Konfiguration in Ihrer Wissensdatenbank festgelegt ist. Siehe VPC-Konnektivität für eine Datenquelle konfigurieren.
contextPath Nein Der Anwendungskontextpfad, unter dem die Confluence Data Center REST-API bereitgestellt wird (z. B.). /wiki Lassen Sie ihn weg, wenn die REST-API im Web-Root bereitgestellt wird.
certificateS3Path Nein Der Speicherort des TLS-Zertifikats für deine Confluence Data Center-Instanz, das verwendet wird, wenn du eine Verbindung über HTTPS herstellst. Enthält s3BucketName und. s3KeyName
Daten EntityConfiguration (optional)
Feld Erforderlich Description
crawlPage Nein Ob Seiten gecrawlt werden sollen.
crawlBlog Nein Ob Blogbeiträge gecrawlt werden sollen.
crawlPageAttachment Nein Ob Seitenanhänge gecrawlt werden sollen. Nur gecrawlt, wenn es auch crawlPage ist. true
crawlBlogAttachment Nein Ob die Anhänge von Blogbeiträgen gecrawlt werden sollen. Nur gecrawlt, wenn es auch crawlBlog ist. true
crawlPersonalSpace Nein Ob persönliche Bereiche gecrawlt werden sollen.
Anmerkung

Im Gegensatz zu Confluence Cloud unterstützt Confluence Data Center das Crawlen archivierter Bereiche oder archivierter Seiten nicht.

Filterkonfiguration (optional)
Feld Erforderlich Description
inclusionSpaceUrls Nein Platzieren Sie die einzuschließenden URLs.
inclusionPageUrls Nein Einzuschließende Seiten-URLs.
inclusionMimeTypes Nein Einzuschließende MIME-Typen.
exclusionMimeTypes Nein Auszuschließende MIME-Typen.
maxFileSizeInMegaBytes Nein Maximale Größe in Megabyte jeder einzelnen Datei, die der Connector aufnimmt. Geben Sie eine numerische Zeichenfolge an (z. B.). "50"

Ändern Sie die Authentifizierungsmethode

Sie können die Authentifizierungsmethode einer Datenquelle ändern (z. B. von Basic zu Personal Access Token), indem Sie die Datenquelle mit der neuen authType und einem geheimen Schlüssel aktualisieren, der die entsprechenden Anmeldeinformationen enthält. Verwenden Sie dazu den UpdateDataSource Vorgang oder den AWS-Managementkonsole.

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.