View a markdown version of this page

Connetti una fonte di dati Confluence Data Center - Amazon Bedrock
Crea l'origine datiParametri dei connettoriModificare il metodo di autenticazioneFasi successive

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 dati Confluence Data Center

Dopo aver configurato la connettività VPC e archiviato le credenziali in modo AWS Secrets Manager segreto, crea l'origine dati di Confluence Data Center 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 puoi configurare.

Nota

Completa prima la configurazione e l'autenticazione del VPC. Consulta Configurare la connettività VPC per un'origine dati e Configurare l'autenticazione Basic o PAT per Confluence Data Center. Sono necessari l'ID di configurazione VPC e l'ARN segreto.

Crea l'origine dati

Console
Per connettere Confluence Data Center alla tua knowledge base gestita

  1. In Fonte dati, fornisci un nome per la tua fonte di dati.

  2. Seleziona Confluence Data Center dal menu a discesa dell'origine dati.

  3. In Configurazione VPC, seleziona una configurazione VPC che raggiunga la tua istanza di Confluence Data Center o scegli Aggiungi configurazione VPC per crearne una. Per informazioni dettagliate, vedi Configurare la connettività VPC per un'origine dati.

  4. (Facoltativo) In Percorso contestuale dell'applicazione, inserisci il percorso del contenuto in base al quale viene fornita l'API REST di Confluence Data Center (ad esempio,). /wiki Lascialo vuoto se l'API REST viene servita nella radice web.

  5. (Facoltativo, solo HTTPS) In base al certificato TLS, fornisci l'URI Amazon S3 del certificato TLS per la tua istanza di Confluence Data Center.

  6. In Autenticazione, seleziona Autenticazione di base o Token di accesso personale, quindi seleziona il AWS Secrets Manager segreto che contiene le credenziali corrispondenti.

  7. (Facoltativo) Espandi l'ambito di sincronizzazione per scegliere i tipi di entità da sottoporre a scansione (pagine, allegati di pagina, blog, allegati di blog, spazi personali).

  8. (Facoltativo) Espandi gli URL delle entità per utilizzare i URL-based filtri per sincronizzare spazi, pagine e blog Confluence specifici.

  9. (Facoltativo) Espandi i tipi MIME per includere o escludere tipi MIME specifici.

API

Per creare un'origine dati Confluence Data Center, invia una CreateDataSource richiesta con un endpoint build-time di Agents for Amazon Bedrock. L' AWS Command Line Interface esempio seguente crea un'origine dati che utilizza l'autenticazione di base. Per utilizzare invece un token di accesso personale, passa authType aPERSONAL_TOKEN. Per una descrizione di ogni campo, vedi il riferimento ai parametri del connettore che segue.

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

Il confluence-onprem-connector.json file contiene quanto segue:

{
    "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/"]
            }
        }
    }
}

Per le knowledge base gestite, CreateDataSource è asincrono: lo stato dell'origine dati passa da CREATING a AVAILABLE quando l'operazione viene completata.

Parametri dei connettori

La configurazione dell'origine dati utilizza i seguenti parametri del connettore. Per connetterti a Confluence Data Center, specifica CONFLUENCEONPREM come tipo di connettore. connectorParameters Per i campi sovrapposti connectorParameters (ad esempio deletionProtectionConfiguration emediaExtractionConfiguration), consulta. Connettere un’origine dati

connectionConfiguration
Campo Richiesto Descrizione
authType Sì Il tipo di autenticazione. Impostato su BASIC oPERSONAL_TOKEN. Consulta Metodi di autenticazione.
secretArn Sì L'ARN del AWS Secrets Manager segreto contenente le credenziali del tuo Confluence Data Center.
vpcConfiguration Sì Il percorso di rete privato verso la tua istanza di Confluence Data Center. Contiene un vpcConfigurationId campo impostato sull'ID di una configurazione VPC nella tua knowledge base. Consulta Configurare la connettività VPC per un'origine dati.
contextPath No Il percorso del contesto dell'applicazione in base al quale viene fornita l'API REST di Confluence Data Center (ad esempio,). /wiki Omettilo se l'API REST viene servita nella radice web.
certificateS3Path No La posizione del certificato TLS per la tua istanza di Confluence Data Center, utilizzato quando ti connetti tramite HTTPS. Contiene e. s3BucketName s3KeyName
dati EntityConfiguration (facoltativi)
Campo Richiesto Description
crawlPage No Se eseguire la scansione delle pagine.
crawlBlog No Se eseguire la scansione dei post del blog.
crawlPageAttachment No Se eseguire la scansione degli allegati delle pagine. È stato sottoposto a scansione solo quando lo è anche. crawlPage true
crawlBlogAttachment No Se eseguire la scansione degli allegati dei post del blog. È stato sottoposto a scansione solo quando lo è anche. crawlBlog true
crawlPersonalSpace No Se esplorare gli spazi personali.
Nota

A differenza di Confluence Cloud, Confluence Data Center non supporta la scansione degli spazi archiviati o delle pagine archiviate.

Configurazione del filtro (opzionale)
Campo Richiesto Description
inclusionSpaceUrls No URL spaziali da includere.
inclusionPageUrls No URL delle pagine da includere.
inclusionMimeTypes No Tipi MIME da includere.
exclusionMimeTypes No Tipi MIME da escludere.
maxFileSizeInMegaBytes No Dimensione massima, in megabyte, di ogni singolo file inserito dal connettore. Fornire come stringa numerica (ad esempio,). "50"

Modificare il metodo di autenticazione

È possibile modificare il metodo di autenticazione di un'origine dati (ad esempio, da Basic a token di accesso personale) aggiornando l'origine dati con il nuovo authType e un segreto che contiene le credenziali corrispondenti, utilizzando l'UpdateDataSourceoperazione o il Console di gestione AWS.

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.