

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
<a name="confluence-knowledge-base"></a>

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.

## Prima di iniziare
<a name="confluence-kb-prerequisites"></a>

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Atlassian Confluence Cloud.
+ Per i requisiti di abbonamento, consulta. [Configura le integrazioni nella console](integration-console-setup-process.md)

## Autenticazione
<a name="confluence-kb-auth-setup"></a>

Per le integrazioni della knowledge base, Amazon Quick gestisce l'autenticazione tramite un flusso popup durante la configurazione. Completa questa procedura:

1. Completa il popup di autenticazione di Confluence Cloud che appare.

1. Concedi le autorizzazioni ad Amazon Quick per accedere ai tuoi contenuti Confluence.

1. Rivedi e completa il processo di autenticazione.

## Configura l'integrazione della Knowledge Base
<a name="confluence-kb-setup"></a>

1. Nella console Amazon Quick, scegli **Integrazioni.**

1. Scegli **Atlassian Confluence Cloud** e scegli il pulsante Aggiungi (più «\$1»).

1. Nella finestra di dialogo **Crea la knowledge base di Confluence**, in **Account connesso, completa i seguenti campi**:
   + **Nome**: un nome descrittivo per l'integrazione dell'accesso ai dati.
   + URL **Confluence: l'URL** del tuo sito Atlassian (ad esempio,). `your-site.atlassian.net`

1. Scegli **Accedi** e completa il flusso di autenticazione di Confluence Cloud nella finestra popup.

1. In **Crea knowledge base**, completa i seguenti campi:
   + **Nome**: un nome per la tua knowledge base.
   + **Descrizione** (facoltativa): note su come verrà utilizzata la knowledge base.

1. In **Contenuto**, incolla gli URLs spazi, i blog o le pagine di Confluence che desideri includere. Scegli **Aggiungi dopo ogni** URL.
**Nota**  
URLs quelli che seguono la struttura `https://company.atlassian.net/wiki/spaces/space-key/overview` vengono considerati come pagine URLs.

1. Scegli **Create** (Crea).

## Tipologie di contenuto supportate
<a name="confluence-kb-content-types"></a>
+ Pagine e post di blog di Confluence
+ Contenuto degli spazi
+ Allegati di pagine e blog

## Controlli sugli accessi
<a name="confluence-kb-access-controls"></a>

**Importante**  
Amazon Quick non sincronizza gli elenchi di controllo degli accessi (ACLs) dalle fonti di dati. Quando crei una knowledge base in Amazon Quick, per impostazione predefinita, solo tu puoi ottenere informazioni dalla knowledge base. Per i contenuti condivisi, puoi fornire l'accesso a diversi utenti e gruppi aggiornando le autorizzazioni della knowledge base.

## Gestisci le basi di conoscenza
<a name="confluence-kb-management"></a>

### Modifica le basi di conoscenza esistenti
<a name="confluence-kb-edit"></a>

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
<a name="confluence-kb-troubleshooting"></a>

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 OAuth dell'app bloccata
<a name="confluence-kb-troubleshooting-blocked-oauth"></a>

**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».
+ Fare clic su **Accetta nella finestra** di dialogo di consenso non ha alcun effetto.

**Causa:**

L'amministratore del sito Atlassian ha bloccato le app installate dall'utente OAuth . 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 Riattiva subito il blocco dopo che l'utente si è connesso.

### Il popup di autenticazione fallisce
<a name="confluence-kb-troubleshooting-auth-popup"></a>

**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
<a name="confluence-kb-troubleshooting-missing-content"></a>

**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 in Confluence URLs . `/overview` URLs che terminano con `/wiki/spaces/space-key/overview` vengono trattate 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`).