View a markdown version of this page

Integrazione della knowledge base di Atlassian Confluence Cloud - Amazon Quick
Prima di iniziareConfigurare l'integrazione della Knowledge BaseTipologie di contenuto supportateGestire le basi di conoscenzaRisoluzione dei problemi

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.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

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

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.

  2. In Knowledge, scegli Atlassian Confluence Cloud e scegli il pulsante Aggiungi (più «+»).

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

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

  5. (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

  6. Scegli Next (Successivo).

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

  2. (Facoltativo) Inserisci una descrizione con note su come verrà utilizzata la knowledge base.

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

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

    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.

  2. 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).

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

Gestire le basi di conoscenza

Modifica le basi di conoscenza esistenti

  1. Nella console Amazon Quick, scegli Knowledge base.

  2. Seleziona la tua knowledge base di Confluence Cloud dall'elenco.

  3. Scegli l'icona a tre punti in Azioni, quindi scegli Modifica knowledge base.

  4. Aggiorna le impostazioni di configurazione secondo necessità e scegli Salva.

Risoluzione dei problemi

Per modificare, condividere o eliminare la tua integrazione, consultaGestione delle integrazioni esistenti.

Per la risoluzione generale della Knowledge Base, inclusi problemi di sincronizzazione e documenti mancanti, consultaKnowledge base per la risoluzione.

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.

    2. Poiché l'amministratore dispone delle autorizzazioni a livello di sito, viene visualizzata una schermata di consenso pulita senza l'errore.

    3. 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 aadmin.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 eteam-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.

  2. Verifica che l'istanza di Confluence Cloud sia accessibile dalla tua rete.

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

  2. Verifica che i tipi di contenuto selezionati siano supportati (pagine, post del blog e allegati).

  3. Controlla la selezione dei contenuti nella configurazione della Knowledge Base per confermare che siano inclusi gli spazi e le pagine corretti.

  4. 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)