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à.
# Integrazione della knowledge base di Atlassian Confluence Cloud
Utilizza l'integrazione della knowledge base di Atlassian Confluence Cloud per indicizzare i contenuti Confluence in modo che gli agenti di Amazon Quick possano cercare e rispondere a domande al riguardo. Amazon Quick supporta controlli di accesso a livello di documento (ACL) opzionali per le knowledge base di Confluence. Se abilitato, gli utenti vedono solo le risposte dai documenti a cui sono autorizzati ad accedere in Confluence. Per ulteriori informazioni, consulta [Document-level controlli di accesso](confluence-kb-acl.md).
## Prima di iniziare
Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un'istanza di Atlassian Confluence Cloud.
+ Per i requisiti di abbonamento Quick, consulta. [Configura le integrazioni nella console](integration-console-setup-process.md)
Se prevedi di abilitare i controlli di accesso a livello di documento, devi fornire le credenziali di amministratore di Atlassian durante la configurazione. Queste credenziali consentono ad Amazon Quick di accedere a tutte le informazioni di utenti e gruppi indipendentemente dalle impostazioni di visibilità delle e-mail individuali. Senza credenziali di amministratore, l'opzione ACL non è disponibile durante la creazione della knowledge base. Per fornire le credenziali di amministratore, è necessario che l'amministratore dell'organizzazione Atlassian fornisca quanto segue:
+ **Chiave API di amministrazione Atlassian**: una stringa alfanumerica generata nel portale di amministrazione Atlassian.
+ **Organization ID (UUID)**: l'identificatore univoco della tua organizzazione Atlassian. Puoi trovarlo nell'URL del tuo browser quando accedi al portale di amministrazione:. `admin.atlassian.com/o/{{orgId}}`
+ **Directory ID (UUID)**: l'identificatore univoco per la tua directory utente. Recupera questo valore utilizzando l'API Atlassian Admin Workspace.
Per i passaggi dettagliati per ottenere queste credenziali, consulta. [Ottieni le credenziali di amministratore di Atlassian](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)
## Configurare l'integrazione della Knowledge Base
La procedura guidata di configurazione prevede tre passaggi: autenticazione, creazione della knowledge base e impostazioni aggiuntive.
### Autentica il tuo account
1. Nella console Amazon Quick, scegli **Knowledge**.
1. In **Knowledge**, scegli **Atlassian Confluence Cloud** e scegli il pulsante Aggiungi (più «\+»).
1. Nella finestra di dialogo **Crea la knowledge base di Confluence**, in **Metodo di autenticazione**, scegli un account connesso esistente dal menu a discesa **Nome** o scegli **Aggiungi** account per creare una nuova connessione.
1. Se stai aggiungendo un nuovo account, completa i seguenti campi:
+ **Nome**: un nome descrittivo per la connessione.
+ **Descrizione** (opzionale): note sulla connessione.
+ URL **Confluence: l'**URL del tuo sito Atlassian (ad esempio,). `https://{{your-site}}.atlassian.net`
1. (Facoltativo) In **Gestione ACL**, seleziona **Usa le credenziali di amministratore Atlassian per fornire le credenziali di amministratore di Atlassian**. Quando l'opzione è selezionata, inserisci quanto segue:
+ **Chiave API: la chiave API** di amministrazione di Atlassian.
+ **OrganizationID (UUID): l'ID dell'organizzazione Atlassian**.
+ **Directory ID (UUID): l'ID della directory utente Atlassian**.
**Importante**
**Le credenziali di amministratore di Atlassian sono necessarie per abilitare i controlli di accesso a livello di documento (ACL) nelle impostazioni aggiuntive.** Senza credenziali di amministratore, l'opzione ACL è disabilitata. Le credenziali di amministratore non possono essere aggiunte dopo la creazione della knowledge base. Per la procedura per ottenere queste credenziali, vedere. [Ottieni le credenziali di amministratore di Atlassian](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)
1. Scegli **Next (Successivo)**.
1. Completa il popup di autenticazione di Confluence Cloud che appare. Controlla le autorizzazioni richieste e scegli **Accetta** per autorizzare Amazon Quick ad accedere ai tuoi contenuti Confluence.
### Crea la knowledge base
1. In **Crea knowledge base**, inserisci un **nome** per la tua knowledge base.
1. (Facoltativo) Inserisci una **descrizione** con note su come verrà utilizzata la knowledge base.
1. In **URL di Confluence**, incolla gli URL degli spazi, dei blog o delle pagine di Confluence che desideri includere. **Scegli Aggiungi dopo ogni URL.**
**Nota**
Gli URL che seguono la struttura `https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}/overview` vengono trattati come URL di pagina, non come URL spaziali. Per indicizzare un intero spazio, utilizzate l'URL dello spazio senza `/overview` (ad esempio,). `https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}`
1. Scegliete **Avanti: impostazioni aggiuntive** per configurare i controlli di accesso e le opzioni di indicizzazione oppure scegliete **Crea** per creare la knowledge base con le impostazioni predefinite.
### Configura impostazioni aggiuntive
1. Per abilitare i controlli di accesso a livello di documento, seleziona **Controlla l'accesso ai documenti con** gli ACL. **Questa opzione è disponibile solo se hai fornito le credenziali di amministratore di Atlassian nel metodo di autenticazione.** Se abilitato, Amazon Quick sincronizza gli elenchi di controllo degli accessi da Confluence e verifica le autorizzazioni di ogni utente al momento della query. Per ulteriori informazioni su come funzionano i controlli di accesso, consulta. [Document-level controlli di accesso](confluence-kb-acl.md)
Se non si abilitano gli ACL, l'accesso viene controllato a livello di knowledge base. Chiunque abbia accesso alla knowledge base può ottenere informazioni dettagliate da tutti i contenuti al suo interno. Quando gli ACL sono abilitati, l'accesso è controllato a livello di documento. Gli utenti che hanno accesso alla knowledge base vedono solo le risposte dei documenti a cui sono autorizzati ad accedere in Confluence.
**Importante**
La gestione ACL non può essere modificata dopo la creazione della knowledge base. Se è necessario modificare questa impostazione, è necessario creare una nuova knowledge base.
**Nota**
Se non hai fornito le credenziali di amministratore di Atlassian nel **metodo di autenticazione**, questa opzione è disabilitata. Per abilitare gli ACL, scegli **Indietro** o annulla la procedura guidata e ricomincia con un account connesso che include le credenziali di amministratore.
1. In **Multi-media Contenuto, dimensione del file e modelli di file,** configura le seguenti opzioni di indicizzazione in base alle esigenze:
+ **Contenuto visivo nei documenti**: indicizza i contenuti visivi come immagini e grafici incorporati nei documenti.
+ **File audio**: indicizza gli allegati dei file audio.
+ **File video**: indicizza gli allegati dei file video.
+ Dimensione **massima per singolo file: la dimensione** massima del file per i singoli allegati (impostazione predefinita: 50 MB).
1. Scegli **Create** (Crea).
## Tipologie di contenuto supportate
+ Pagine e post del blog di Confluence
+ Allegati di pagine e post del blog
Quando aggiungi un URL dello spazio Confluence, Amazon Quick esegue la scansione di tutte le pagine e i post del blog all'interno di quello spazio. Per i tipi di file allegati supportati e i limiti di dimensione, consulta. [Limiti relativi alla dimensione dei file e al contenuto](knowledge-base-integrations.md#file-size-and-content-limits)
## Gestire le basi di conoscenza
### Modifica le basi di conoscenza esistenti
1. Nella console Amazon Quick, scegli **Knowledge base**.
1. Seleziona la tua knowledge base di Confluence Cloud dall'elenco.
1. Scegli l'icona a tre punti in **Azioni**, quindi scegli **Modifica** knowledge base.
1. Aggiorna le impostazioni di configurazione secondo necessità e scegli **Salva**.
## Risoluzione dei problemi
Per modificare, condividere o eliminare la tua integrazione, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).
Per la risoluzione generale della Knowledge Base, inclusi problemi di sincronizzazione e documenti mancanti, consulta[Knowledge base per la risoluzione](troubleshooting-knowledge-bases.md).
### Autorizzazione dell'app OAuth bloccata
**Caratteristiche:**
+ Messaggio di errore: «L'amministratore del sito deve autorizzare questa app per il sito {{instance-name}} .atlassian.net prima che l'app possa accedere al tuo account».
+ La scelta di **Accetta nella finestra** di dialogo di consenso non ha alcun effetto.
**Causa:**
L'amministratore del sito Atlassian ha bloccato le app OAuth installate dall'utente. Quando questa impostazione è abilitata, solo un amministratore del sito o dell'organizzazione può autorizzare nuove app di terze parti.
**Fasi di risoluzione:**
Utilizza una delle seguenti opzioni per risolvere il problema.
+ **Opzione 1 (consigliata): l'amministratore autorizza direttamente l'app**
1. Un amministratore del sito Atlassian accede ad Amazon Quick e avvia una nuova configurazione della knowledge base con Confluence Cloud.
1. Poiché l'amministratore dispone delle autorizzazioni a livello di sito, viene visualizzata una schermata di consenso pulita senza l'errore.
1. L'amministratore sceglie **Accept per installare l'app**.
Dopo che l'amministratore ha autorizzato l'app, tutti gli altri utenti del sito possono connettersi senza problemi.
+ **Opzione 2: consenti temporaneamente le app installate dall'utente**: un amministratore accede a`admin.atlassian.com`, accede ad **App, Atlassian Apps****, quindi sceglie il link per le app** di terze parti e Marketplace. In **Impostazioni**, trova **App installate dall'utente e attiva l'opzione per consentire le app** utente. Dopo che l'utente ha autorizzato Amazon Quick, ripristina l'impostazione per bloccare le app utente.
**Importante**
L'autorizzazione amministrativa si applica per sito Atlassian, non per organizzazione. Se la tua azienda ha più siti (ad esempio, `team-a.atlassian.net` e`team-b.atlassian.net`), ogni sito richiede un'autorizzazione separata.
**Nota**
Sebbene le app installate dall'utente siano sbloccate (opzione 2), qualsiasi utente del sito può autorizzare qualsiasi app OAuth. Re-enable il blocco immediatamente dopo che l'utente si è connesso.
### Il popup di autenticazione fallisce
**Caratteristiche:**
+ Il popup di autenticazione non viene visualizzato o si chiude immediatamente.
+ Viene visualizzato il popup ma non riesce a completare il flusso OAuth.
**Fasi di risoluzione:**
1. Verifica che il tuo browser consenta i popup dal dominio della console Amazon Quick.
1. Verifica che l'istanza di Confluence Cloud sia accessibile dalla tua rete.
1. Prova a utilizzare un altro browser o a svuotare la cache del browser.
### Contenuto mancante nella knowledge base
**Caratteristiche:**
+ La sincronizzazione della Knowledge Base viene completata ma il contenuto previsto non viene indicizzato.
+ I risultati della ricerca non includono contenuti provenienti da spazi o pagine specifici.
+ Viene indicizzato un solo documento per un intero spazio.
**Fasi di risoluzione:**
1. Verifica che l'utente di Confluence Cloud che si è autenticato abbia accesso agli spazi e alle pagine selezionati durante la configurazione.
1. Verifica che i tipi di contenuto selezionati siano supportati (pagine, post del blog e allegati).
1. Controlla la selezione dei contenuti nella configurazione della Knowledge Base per confermare che siano inclusi gli spazi e le pagine corretti.
1. Controlla il suffisso negli URL di Confluence. `/overview` Gli URL che terminano con `/wiki/spaces/{{space-key}}/overview` vengono trattati come un URL a pagina singola, non come uno spazio completo. Se intendi indicizzare l'intero spazio, utilizza l'URL dello spazio senza `/overview` (ad esempio,`https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}`).
### ACL-related problemi
**Nessun risultato dalla ACL-enabled knowledge base**
+ Verifica che l'utente finale abbia effettuato l'accesso a Confluence quando richiesto durante la prima query. L'accesso è necessario per la verifica delle autorizzazioni in tempo reale.
+ Verifica che l'utente finale abbia accesso ai contenuti Confluence pertinenti nella propria istanza Confluence.
**Documenti ignorati durante la sincronizzazione**
+ Se i report di sincronizzazione mostrano elementi con lo stato IGNORATO, verifica che l'utente che effettua l'autenticazione abbia accesso agli spazi e alle pagine di Confluence inclusi nella knowledge base.
+ Per ulteriori informazioni sulla verifica dell'accesso ai documenti, consulta. [Verifica l'accesso ai documenti (verifica ACL)](sync-reports-observability.md#sync-reports-acl-verification)