View a markdown version of this page

Integrazione della knowledge base di Atlassian Confluence Cloud - Amazon Quick
Prima di iniziareAutenticazioneConfigura l'integrazione della Knowledge BaseTipologie di contenuto supportateControlli sugli accessiGestisci 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.

Prima di iniziare

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

Autenticazione

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.

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

  3. Rivedi e completa il processo di autenticazione.

Configura l'integrazione della Knowledge Base

  1. Nella console Amazon Quick, scegli Integrazioni.

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

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

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

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

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

  7. Scegli Create (Crea).

Tipologie di contenuto supportate

  • Pagine e post di blog di Confluence

  • Contenuto degli spazi

  • Allegati di pagine e blog

Controlli sugli accessi

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

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 OAuth dell'app 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».

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

    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 Riattiva subito il blocco 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 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).