View a markdown version of this page

Connect una fonte di dati Confluence - Amazon Bedrock

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

Connect una fonte di dati Confluence

Dopo aver configurato l'autenticazione e archiviato le credenziali in modo AWS Secrets Manager segreto, crea la fonte di dati Confluence nella tua knowledge base. Questa pagina descrive come creare l'origine dati con l' Console di gestione AWS o l'API, seguita da un riferimento per i parametri del connettore che è possibile configurare.

Nota

Completa prima la configurazione dell'autenticazione. Vedi Configurare l'autenticazione di base per Confluence o Configurare l'autenticazione OAuth 2.0 per Confluence. Sono necessari l'ARN segreto e l'URL dell'host Confluence.

Crea la fonte di dati

Console
Per connettere Confluence alla tua knowledge base gestita
  1. In Origine dati, fornisci un nome per la tua fonte di dati.

  2. Seleziona Confluence dal menu a discesa delle fonti di dati.

  3. In Source, inserisci l'URL di Confluence (ad esempio,). https://example.atlassian.net

  4. In Autenticazione, seleziona Autenticazione di base o Autenticazione OAuth 2.0.

  5. Seleziona o crea un AWS Secrets Manager segreto per archiviare le tue credenziali.

  6. (Facoltativo, solo autenticazione di base) Per abilitare il controllo degli accessi a livello di documento, seleziona Controlla l'accesso ai documenti con gli ACL. Il segreto selezionato deve includereadminApiKey, e. organizationId directoryId Questa opzione non può essere modificata dopo la creazione. Per informazioni dettagliate, vedi Document-level controlli di accesso.

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

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

  9. (Facoltativo) Espandi il pattern regex dei tipi MIME per includere o escludere tipi MIME specifici.

API

Per creare un'origine dati Confluence, invia una CreateDataSourcerichiesta a un endpoint in fase di costruzione Agents for Amazon Bedrock. L' AWS Command Line Interface esempio seguente crea un'origine dati che utilizza l'autenticazione di base. Per utilizzare invece OAuth 2.0, passare authType a. OAUTH2 Per abilitare il controllo degli accessi a livello di documento, imposta su. aclEnabled true Per una descrizione di ogni campo, consulta il riferimento ai parametri del connettore che segue.

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

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

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

Per le knowledge base gestite, CreateDataSource è asincrono: lo stato dell'origine dati passa dal momento in AVAILABLE cui l'operazione viene CREATING completata.

Parametri dei connettori

La configurazione dell'origine dati utilizza i seguenti parametri del connettore. Per connetterti a Confluence, specifica CONFLUENCE come tipo di connettore. connectorParameters Per i campi racchiusi connectorParameters (come deletionProtectionConfiguration emediaExtractionConfiguration), vedi. Connettere un’origine dati

Imposta aclEnabled in modo esplicito

Se si ometteaclEnabled, l'impostazione predefinita dipende daauthType: il valore predefinito è e il BASIC valore predefinito è. true OAUTH2 false Poiché la configurazione ACL è permanente dopo la creazione dell'origine dati, impostala in modo aclEnabled esplicito in modo che l'origine dati abbia il comportamento di controllo dell'accesso desiderato. Per informazioni dettagliate, vedi Document-level controlli di accesso.

connectionConfiguration
Campo Richiesto Descrizione
secretArn L'ARN del AWS Secrets Manager segreto contenente le tue credenziali Confluence.
type Il tipo di distribuzione di Confluence. Imposta su SAAS. Confluence Server e Data Center non sono supportati.
authType Il tipo di autenticazione. Impostato su o. BASIC OAUTH2 Per informazioni, consulta Metodi di autenticazione.
hostUrl L'URL di base dell'istanza di Confluence Cloud (ad esempio,https://example.atlassian.net).
dati EntityConfiguration (opzionale)
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. Scansionato solo quando lo è anche. crawlPage true
crawlBlogAttachment No Indica se scansionare gli allegati dei post del blog. Scansionato solo quando lo è anche. crawlBlog true
crawlArchivedSpace No Indica se eseguire la scansione degli spazi archiviati.
crawlArchivedPage No Se eseguire la scansione delle pagine archiviate.
crawlPersonalSpace No Se eseguire la scansione degli spazi personali.
Configurazione del filtro (opzionale)
Campo Richiesto Description
inclusionSpaceKeys No Tasti spaziatori da includere.
inclusionSpaceUrls No URL spaziali da includere.
inclusionMimeTypes No Tipi MIME da includere.
exclusionMimeTypes No Tipi MIME da escludere.
maxFileSizeInMegaBytes No Dimensione massima, in megabyte, di ogni singolo file importato dal connettore. Fornisci come stringa numerica (ad esempio,). "500" L’impostazione predefinita è "500".
AclEnabled (opzionale)
Campo Richiesto Description
aclEnabled No Se il controllo degli accessi a livello di documento è abilitato. Imposta su true per abilitare o disabilitarefalse. Se si omette questo campo, l'impostazione predefinita dipende daauthType: il valore BASIC predefinito ètrue; OAUTH2 il valore predefinito è. false ACL on BASIC richiede un segreto che includa le credenziali di amministratore dell'organizzazione Atlassian. Non è possibile modificare questa impostazione dopo aver creato l'origine dati. Per informazioni dettagliate, vedi Document-level controlli di accesso.

Modificare il metodo di autenticazione

È possibile modificare il metodo di autenticazione di un'origine dati (ad esempio, da OAuth 2.0 a Basic) aggiornando l'origine dati con una nuova authType fonte segreta che contiene le credenziali corrispondenti, utilizzando l'UpdateDataSourceoperazione o il. Console di gestione AWS L'impostazione del controllo dell'accesso a livello di documento è fissa quando si crea un'origine dati, quindi per aggiungere o rimuovere ACL è necessario creare una nuova origine dati.

Fasi successive

Dopo aver creato l'origine dati, sincronizzala per inserire il contenuto nella tua knowledge base. Per informazioni dettagliate, vedi Sincronizzare un’origine dati. Per filtrare i risultati delle query in base alle autorizzazioni degli utenti, consulta. Document-level controlli di accesso