View a markdown version of this page

Eine Confluence-Datenquelle Connect - 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-Datenquelle Connect

Nachdem Sie die Authentifizierung eingerichtet und Ihre Anmeldeinformationen AWS Secrets Manager geheim gespeichert haben, erstellen Sie die Confluence-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 zu den Konnektorparametern, die Sie konfigurieren können.

Anmerkung

Schließen Sie zuerst die Einrichtung der Authentifizierung ab. Weitere Informationen unter Standardauthentifizierung für Confluence einrichten oder OAuth 2.0-Authentifizierung für Confluence einrichten. Sie benötigen den geheimen ARN und die Confluence-Host-URL.

Erstellen Sie die Datenquelle

Console
Um Confluence mit Ihrer verwalteten Wissensdatenbank zu verbinden

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

  2. Wählen Sie Confluence aus dem Drop-down-Menü für die Datenquelle aus.

  3. Geben Sie unter Quelle Ihre Confluence-URL ein (z. B.). https://example.atlassian.net

  4. Wählen Sie unter Authentifizierung die Option Standardauthentifizierung oder OAuth 2.0-Authentifizierung aus.

  5. Wählen Sie ein AWS Secrets Manager Geheimnis aus, um Ihre Anmeldeinformationen zu speichern, oder erstellen Sie ein solches.

  6. (Optional, nur Standardauthentifizierung) Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, wählen Sie Dokumentenzugriff mit ACLs kontrollieren aus. Das von Ihnen ausgewählte Geheimnis muss, und enthaltenadminApiKey. organizationId directoryId Diese Option kann nach der Erstellung nicht geändert werden. Details hierzu finden Sie unter Document-level Zugriffskontrollen.

  7. (Optional) Erweitern Sie den Synchronisierungsbereich, um auszuwählen, welche Entitätstypen gecrawlt werden sollen (Seiten, Blogs, Seitenanhänge, Bloganhänge, archivierte Bereiche, archivierte Seiten, 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 das Regex-Muster für MIME-Typen, um bestimmte MIME-Typen ein- oder auszuschließen.

API

Um eine Confluence-Datenquelle zu erstellen, senden Sie eine CreateDataSourceAnfrage mit einem Build-Time-Endpunkt von Agents for Amazon Bedrock. Im folgenden AWS Command Line Interface Beispiel wird eine Datenquelle erstellt, die die Standardauthentifizierung verwendet. Um stattdessen OAuth 2.0 zu verwenden, wechseln Sie authType zu. OAUTH2 Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, setzen Sie auf. aclEnabled true Eine Beschreibung der einzelnen Felder finden Sie in der nachfolgenden Referenz zu den Konnektorparametern.

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

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

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCE",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-basic-creds",
                "type": "SAAS",
                "authType": "BASIC",
                "hostUrl": "https://example.atlassian.net"
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceKeys": ["ENG", "DOCS"]
            }
        }
    }
}

Bei verwalteten Wissensdatenbanken CreateDataSource erfolgt der Vorgang asynchron: Der Status der Datenquelle wechselt von CREATING zu, AVAILABLE wenn der Vorgang abgeschlossen ist.

Connector-Parameter

Die Datenquellenkonfiguration verwendet die folgenden Konnektorparameter. Um eine Verbindung zu Confluence herzustellen, geben Sie CONFLUENCE als Konnektortyp in an. connectorParameters Informationen zu Feldern, die umbrechen connectorParameters (z. B. deletionProtectionConfiguration undmediaExtractionConfiguration), finden Sie unter. Verbinden einer Datenquelle

Legen Sie ACLEnabled explizit fest

Wenn Sie den Wert weglassenaclEnabled, hängt der Standardwert von folgenden Faktoren abauthType: BASIC standardmäßig auf und standardmäßig auftrue. OAUTH2 false Da die ACL-Konfiguration nach der Erstellung der Datenquelle permanent ist, sollten Sie sie aclEnabled explizit so einstellen, dass die Datenquelle das von Ihnen beabsichtigte Zugriffssteuerungsverhalten aufweist. Details hierzu finden Sie unter Document-level Zugriffskontrollen.

connectionConfiguration
Feld Erforderlich Beschreibung
secretArn Ja Der ARN des AWS Secrets Manager Secrets, das Ihre Confluence-Anmeldeinformationen enthält.
type Ja Der Confluence-Bereitstellungstyp. Setzen Sie diesen Wert auf SAAS. Confluence Server und Data Center werden nicht unterstützt.
authType Ja Der Authentifizierungstyp. Auf oder eingestellt. BASIC OAUTH2 Siehe Authentifizierungsmethoden.
hostUrl Ja Die Basis-URL Ihrer Confluence Cloud-Instanz (zum Beispielhttps://example.atlassian.net).
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
crawlArchivedSpace Nein Ob archivierte Bereiche gecrawlt werden sollen.
crawlArchivedPage Nein Ob archivierte Seiten gecrawlt werden sollen.
crawlPersonalSpace Nein Ob persönliche Bereiche gecrawlt werden sollen.
Filterkonfiguration (optional)
Feld Erforderlich Description
inclusionSpaceKeys Nein Leertaste, die hinzugefügt werden soll.
inclusionSpaceUrls Nein Einzuschließende Leerzeichen-URLs.
inclusionMimeTypes Nein Einzuschließende MIME-Typen.
exclusionMimeTypes Nein Auszuschließende MIME-Typen.
maxFileSizeInMegaBytes Nein Maximale Größe jeder einzelnen Datei, die der Connector aufnimmt, in Megabyte. Geben Sie eine numerische Zeichenfolge an (z. B.). "500" Standardeinstellung: "500".
ACL aktiviert (optional)
Feld Erforderlich Description
aclEnabled Nein Ob die Zugriffskontrolle auf Dokumentebene aktiviert ist. Stellen Sie true auf „Aktivieren“ oder „Deaktivieren“ false ein. Wenn Sie dieses Feld weglassen, hängt die Standardeinstellung von folgenden Faktoren abauthType: BASIC standardmäßig auftrue; OAUTH2 standardmäßig auf. false Für ACL on BASIC ist ein geheimer Schlüssel erforderlich, der die Administratoranmeldedaten der Atlassian-Organisation enthält. Du kannst diese Einstellung nicht ändern, nachdem du die Datenquelle erstellt hast. Details hierzu finden Sie unter Document-level Zugriffskontrollen.

Ändern Sie die Authentifizierungsmethode

Sie können die Authentifizierungsmethode einer Datenquelle ändern (z. B. von OAuth 2.0 auf Basic), indem Sie die Datenquelle mit dem neuen authType und einem geheimen Schlüssel, der die entsprechenden Anmeldeinformationen enthält, aktualisieren. Verwenden Sie dazu den UpdateDataSourceVorgang oder den. AWS-Managementkonsole Die Einstellung für die Zugriffskontrolle auf Dokumentebene ist festgelegt, wenn Sie eine Datenquelle erstellen. Um ACLs hinzuzufügen oder zu entfernen, müssen Sie also eine neue Datenquelle erstellen.

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. Informationen zum Filtern von Abfrageergebnissen nach Benutzerberechtigungen finden Sie unterDocument-level Zugriffskontrollen.