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à.
# Knowledge base
Una knowledge base è una raccolta organizzata e indicizzata di documenti o contenuti provenienti da fonti di dati ottimizzata per il recupero generativo basato sull'intelligenza artificiale e la risposta alle domande. Sia che il tuo team archivi la documentazione in Confluence, collabori tramite o gestisca i file nel cloud storage SharePoint, puoi riunire tutte queste informazioni in un'unica esperienza di ricerca unificata creando basi di conoscenza.
Le integrazioni integrate possono essere configurate con pochi clic per sincronizzare i dati in Quick e sfruttare facilmente le conoscenze della tua organizzazione su Google Drive, Confluence OneDrive, S3 e Web Crawler. SharePoint Sia che il tuo team archivi la documentazione in Confluence, collabori o gestisca i file nel cloud storage SharePoint, puoi riunire tutte queste informazioni in un'unica esperienza di ricerca unificata con l'aiuto delle knowledge base.
## Come funzionano le knowledge base
La Knowledge base è una raccolta indicizzata di documenti o contenuti provenienti da fonti di dati come Google Drive, ottimizzata per il recupero generativo basato sull'intelligenza artificiale e la risposta alle domande. È possibile creare più basi di conoscenza dalla stessa fonte e tutte possono risiedere all'interno di un indice rapido condiviso. Ad esempio, se sincronizzi due cartelle da Google Drive e crei due knowledge base, una per i «Documenti normativi» per rispondere a domande come *«Qual è la nostra politica di rimborso»* e una per «Feedback dei clienti» per rispondere a domande come *«Quali sono i reclami più comuni dei clienti»*, entrambe possono far parte dello stesso indice. Quick li distingue utilizzando l'id della knowledge base, in modo che le query possano essere filtrate per recuperare solo i documenti pertinenti dalla knowledge base desiderata. Ciò consente agli utenti di organizzare, proteggere e recuperare informazioni relative a diversi domini o casi d'uso, anche se i dati sottostanti sono indicizzati insieme.
Le tue knowledge base possono essere utilizzate singolarmente o condivise con i membri del team tramite Amazon Quick spaces. Il nostro controllo degli accessi a grana grossa garantisce la sicurezza a livello di knowledge base, garantendo che gli utenti ricevano informazioni solo dalle knowledge base a cui sono autorizzati ad accedere.
### Processo di creazione
Puoi creare basi di conoscenza mentre configuri una nuova integrazione per l'accesso ai dati e utilizzare le integrazioni esistenti per creare basi di conoscenza aggiuntive:
1. **Configurazione dell'integrazione dell'accesso ai dati** - Connect alla fonte di dati esterna
1. **Selezione dei contenuti**: scegli quali contenuti includere tramite filtri e impostazioni dell'ambito
1. **Indicizzazione**: Amazon Quick elabora e indicizza i contenuti selezionati
1. **Disponibilità: la** knowledge base diventa disponibile per l'uso negli spazi e da parte degli agenti di intelligenza artificiale
### Funzionalità
Ogni knowledge base offre le seguenti funzionalità:
+ **Indicizzazione dei contenuti**: elabora testo, documenti e dati strutturati provenienti da fonti esterne
+ **Ricerca semantica: consente la ricerca** basata sull'intelligenza artificiale tra contenuti indicizzati
+ **Sincronizzazione automatica: mantiene i contenuti con pianificazioni di sincronizzazione** configurabili up-to-date
+ **Controllo degli accessi a grana grossolana**: assicura che gli utenti ricevano solo le informazioni dalle knowledge base a cui sono autorizzati ad accedere.
+ **Utilizzo in più spazi**: può essere utilizzato in più spazi e da diversi agenti AI
## Flusso di lavoro generale
Il flusso di lavoro tipico per l'utilizzo delle knowledge base prevede i seguenti passaggi:
1. **Configura l'integrazione delle fonti di dati**: connettiti alla tua applicazione esterna (come SharePoint Google Drive o Confluence) con l'autenticazione appropriata. Per ulteriori informazioni, consulta [Guide specifiche per l'integrazione](integration-guides.md).
1. **Crea una knowledge base**: puoi creare una knowledge base durante la configurazione della nuova integrazione. Configura i filtri dei contenuti impostando filtri di inclusione, restrizioni sui tipi di file e selezioni di cartelle per concentrarti sui contenuti pertinenti.
1. **Imposta la pianificazione della sincronizzazione**: la frequenza di aggiornamento dei dati è impostata su base giornaliera per impostazione predefinita. È possibile modificare la frequenza di sincronizzazione per configurare la frequenza con cui la knowledge base deve essere aggiornata con nuovi contenuti dalla fonte.
1. **Monitoraggio e gestione**: verifica lo stato della sincronizzazione, gestisci le autorizzazioni di accesso.
## Impostazioni di configurazione comuni
Le knowledge base condividono modelli di configurazione comuni tra diverse integrazioni di fonti di dati. La comprensione di queste impostazioni consente di ottimizzare l'indicizzazione dei contenuti e gestire efficacemente il comportamento di sincronizzazione.
**Nota**
Sebbene queste opzioni di configurazione siano disponibili per la maggior parte delle integrazioni, le impostazioni specifiche e le opzioni disponibili possono variare a seconda dell'integrazione della fonte di dati scelta.
### Limiti relativi alla dimensione dei file e al contenuto
Configura i limiti di dimensione dei file per ottimizzare le prestazioni di elaborazione e gestire i costi di archiviazione. I limiti specifici variano in base al tipo di contenuto e vengono visualizzati nella console quando si configura la knowledge base.
**Documenti di testo standard**
Si applica a documenti come PDFs file Word e file di testo. Il limite di dimensione del file è di 500 MB.
**File video**
Disponibile quando l'elaborazione video è abilitata. I formati supportati includono `.mp4``.mov`,`.m4v`. Il limite di dimensione del file è 10 GB (10240 MB). Quick Index supporta fino a **10 file video per GB di spazio di archiviazione**. Se il tuo caso d'uso richiede volumi video più elevati, apri un ticket con l' AWS assistenza per estendere questo limite.
**File audio**
Disponibile quando l'elaborazione audio è abilitata. I formati supportati includono `.mp3`` .wav`,` .m4a`,`.flac`, e` .ogg`. Il limite è di 2 GB (2048 MB) per i file audio.
I file con testo estratto che supera il limite di sistema di 30 MB non vengono indicizzati, indipendentemente dalla dimensione originale del file. La quantità massima di testo che può essere estratta da un singolo documento è di 30 MB.
**Immagini**
Quick Index applica i seguenti limiti per le immagini:
+ **Limite per documento**: 500 immagini per documento
+ **Limite per GB**: 10.000 immagini per GB di spazio di archiviazione dell'indice
+ **Limite per indice: 2 milioni di immagini per indice**
Se il tuo caso d'uso richiede volumi di immagini più elevati, apri un ticket con l' AWS assistenza per estendere questi limiti.
### Pianificazione e misure di sicurezza della sincronizzazione
Configura la frequenza di aggiornamento della tua knowledge base e proteggiti dall'eliminazione involontaria dei contenuti:
#### Frequenza di sincronizzazione
La frequenza di aggiornamento dei dati è impostata su base giornaliera per impostazione predefinita. È possibile modificare la frequenza di sincronizzazione per configurare la frequenza con cui la knowledge base deve aggiornarsi con nuovi contenuti dalla fonte
#### Protezione contro l’eliminazione dei documenti
Proteggi i contenuti indicizzati dall'eliminazione di massa accidentale impostando una soglia percentuale massima di eliminazione. Se un processo di sincronizzazione comporta l'eliminazione di un numero di documenti superiore a quello consentito dalla soglia, la fase di eliminazione viene saltata, preservando il contenuto indicizzato esistente.
Questa protezione protegge da problemi temporanei di rete, modifiche delle autorizzazioni o problemi del sistema di origine che potrebbero rendere i contenuti temporaneamente non disponibili.
# Le migliori pratiche per la gestione ACLs nelle knowledge base
Quando utilizzi le knowledge base con liste di controllo degli accessi (ACLs), hai la responsabilità di mantenere accurate le identità e le autorizzazioni degli utenti. Ciò garantisce che le persone giuste possano accedere ai documenti giusti. Per impostazione predefinita, Quick sincronizza automaticamente le modifiche all'identità e all'ACL a livello di documento ogni 24 ore. Eventuali aggiornamenti agli utenti o alle autorizzazioni impiegheranno fino a un giorno per essere visualizzati nel sistema, a meno che tu non abbia configurato una pianificazione di aggiornamento diversa per le tue knowledge base.
Per ulteriori informazioni sulla configurazione ACLs per un'origine dati specifica, consulta. [Integrazione Amazon S3](s3-integration.md)
**Nota**
Quick considera tutti gli indirizzi e-mail senza distinzione tra maiuscole e minuscole. `JohnDoe@example.com``johndoe@example.com`, e `JOHNDOE@example.com` sono tutti considerati lo stesso utente.
## Importanti scenari di gestione degli utenti
**Comprendere l'associazione delle e-mail**
Gli indirizzi e-mail vengono associati dinamicamente agli utenti Quick quando gli utenti avviano interazioni in chat. Questa associazione segue un first-come-first-serve approccio. Il primo utente che chatta con un determinato indirizzo e-mail stabilisce l'associazione per quell'identità all'interno del namespace.
**Quando un dipendente lascia l'organizzazione**
Quando un dipendente se ne va, ripulisci immediatamente il suo accesso:
1. Aggiorna i file di configurazione ACL per rimuovere i riferimenti al suo indirizzo e-mail. Ad esempio, in Amazon S3, aggiorna il file ACL globale o i file di metadati.
1. Aggiorna le knowledge base per applicare le modifiche.
In questo modo si evitano potenziali problemi di sicurezza se l'e-mail viene successivamente riassegnata a qualcun altro.
**Quando un indirizzo e-mail viene riassegnato a un nuovo dipendente**
+ L'accesso alla knowledge base compatibile con ACL viene automaticamente bloccato per l'indirizzo e-mail riassegnato per proteggere la sicurezza dei dati.
+ Contatta l'assistenza rapida per ripulire l'accesso dell'utente precedente prima che il nuovo dipendente possa accedere ai documenti associati a quell'e-mail.
## Limitazioni
Quando configuri a livello di documento ACLs per le tue knowledge base, tieni presente queste limitazioni:
+ La **configurazione ACL a livello di documento è permanente: non è** possibile attivarla ACLs su knowledge base create senza il supporto ACL. Inoltre, non è possibile disattivarla una volta abilitata. ACLs Per modificare la configurazione ACL, crea una nuova knowledge base con l'impostazione desiderata fin dall'inizio.
+ **Indirizzi e-mail condivisi all'interno di un namespace**: se più utenti Quick condividono lo stesso indirizzo e-mail all'interno di un namespace, il sistema nega l'accesso a tutti coloro che utilizzano quell'e-mail condivisa. Questa protezione impedisce di concedere accidentalmente l'accesso ai documenti alla persona sbagliata.
+ **Ambito di risoluzione ACL**: tutti ACLs vengono risolti all'interno dello spazio dei nomi Quick del creatore della knowledge base. Ciò vale sia che ACLs vengano specificati tramite l'indirizzo e-mail o il nome del gruppo. Ricerca rapidamente le identità nel contesto organizzativo del creatore per garantire una risoluzione coerente delle identità.
+ **Tempi di riciclo degli indirizzi e-mail**: se l'organizzazione riassegna un indirizzo e-mail da un dipendente a un altro, è importante considerare la tempistica. Se il precedente dipendente non ha mai utilizzato Quick for chat o per le interazioni con l'intelligenza artificiale e l'e-mail viene riassegnata prima del successivo aggiornamento dell'ACL, il nuovo dipendente può accedere temporaneamente ai documenti destinati al dipendente precedente.
Per evitare ciò, completa i seguenti passaggi nell'ordine:
1. Aggiorna il tuo ACLs (se applicabile, ad esempio in Amazon S3) per rimuovere il vecchio utente e aggiungere il nuovo utente.
1. Aggiorna manualmente la tua knowledge base o attendi l'aggiornamento automatico giornaliero.
1. Assegna l'indirizzo e-mail al nuovo dipendente.
Ciò garantisce che le autorizzazioni di accesso siano sincronizzate correttamente prima che il nuovo utente inizi a utilizzare Quick.
+ **Compatibilità con la ricerca**: le basi di conoscenza con livello di documento ACLs abilitato non sono attualmente compatibili con Quick Research. Se hai bisogno di utilizzare documenti di una knowledge base abilitata all'ACL per scopi di ricerca, crea una knowledge base separata senza ACLs tali documenti.
# Knowledge base per la risoluzione
Se riscontri problemi con la tua knowledge base Quick, puoi utilizzare questa guida alla risoluzione dei problemi per identificare e risolvere i problemi più comuni. I problemi della Knowledge Base in genere riguardano la sincronizzazione dei documenti, gli errori di aggiornamento dei processi o le autorizzazioni di accesso.
## I documenti non vengono visualizzati nella Knowledge Base
Quando i documenti che si prevede di visualizzare non vengono visualizzati nella knowledge base, il problema potrebbe essere causato da diversi fattori.
Cause comuni:
+ **Sincronizzazione in corso**: i documenti potrebbero essere ancora in fase di elaborazione. Controlla lo stato dell'aggiornamento per confermare che l'aggiornamento è completo.
+ **Formato di file non supportato**: verifica che i documenti siano nei formati supportati: Word, Excel, PDF, CSV PowerPoint, TXT, RTF, JSON, XML, HTML
+ **Dimensione del file troppo grande**: ogni file deve pesare meno di 50 MB.
+ **Autorizzazioni di accesso insufficienti**: verifica che la knowledge base disponga delle autorizzazioni appropriate per accedere alla fonte del documento.
+ **Filtraggio dei documenti**: verifica se i filtri o le regole di esclusione impediscono l'indicizzazione di determinati documenti.
**Per risolvere i problemi:**
1. Esamina la cronologia degli aggiornamenti per i messaggi di errore relativi a documenti specifici che non sono riusciti a sincronizzare.
1. Verifica che i formati dei documenti e le dimensioni dei file soddisfino i requisiti.
1. Controlla le autorizzazioni di accesso e le impostazioni di connessione.
## Il processo di aggiornamento non riesce
Un processo di aggiornamento in genere fallisce quando si verifica un errore di configurazione nella Knowledge Base o nella connessione all'origine dati.
Cause comuni:
+ **Problemi di autorizzazione**: l'integrazione non dispone di autorizzazioni sufficienti per accedere all'origine dati.
+ **Errori di configurazione**: impostazioni di connessione errate URLs o all'origine dati.
+ **Limitazioni delle risorse**: limitazione della velocità dal sistema di origine.
**Per risolvere:**
1. Controlla i dettagli della cronologia degli aggiornamenti per messaggi di errore specifici.
1. Verifica che tutte le impostazioni e le autorizzazioni di connessione siano configurate correttamente.
1. Esegui l'azione consigliata in base al messaggio di errore.
## Il processo di aggiornamento viene completato con problemi
Quando un processo di aggiornamento viene completato con problemi, il processo è stato elaborato correttamente ma ha riscontrato problemi con alcuni documenti.
**Cosa significa:**
+ **Operazione riuscita parziale**: alcuni documenti sono stati sincronizzati correttamente mentre altri hanno avuto esito negativo.
+ **Errori a livello di documento**: i singoli file potrebbero presentare problemi di formattazione, danneggiamento o problemi di accesso.
+ Problemi **relativi ai metadati: problemi** con i metadati dei documenti o le informazioni associate.
+ **Violazioni relative alle dimensioni o al formato**: alcuni file potrebbero superare i limiti di dimensione o essere in formati non supportati.
**Per risolvere:**
1. Esamina i report di aggiornamento dettagliati per identificare i documenti che hanno riscontrato problemi.
1. Risolvi i problemi relativi ai singoli documenti.
1. Esegui un altro aggiornamento dopo aver risolto i problemi.
## Il processo di aggiornamento ha esito positivo ma non viene visualizzato alcun documento
Se un processo di aggiornamento risulta riuscito ma nella Knowledge Base non compare alcun documento, verificate queste possibili cause.
Cause comuni:
+ **Fonte vuota**: la posizione dell'origine dati configurata non contiene documenti.
+ **Configurazione errata del percorso**: il percorso di origine o le impostazioni di connessione non puntano alla posizione corretta.
+ **Filtri per i documenti: i** criteri di inclusione o esclusione potrebbero filtrare tutti i documenti.
+ **Autorizzazioni di lettura mancanti**: il lavoro si è connesso correttamente ma non disponeva delle autorizzazioni per leggere i documenti effettivi.
**Per risolvere:**
1. Verifica che i punti di configurazione dell'origine dati siano nella posizione corretta.
1. Conferma la presenza dei documenti nella posizione specificata.
1. Verifica che siano configurate le autorizzazioni di accesso appropriate.
1. Esamina tutti i filtri dei documenti che potrebbero escludere il contenuto.
## Problemi di formato dei file durante l'aggiornamento
Le basi di conoscenza rapide supportano formati di file specifici. I file devono soddisfare i requisiti di formato, dimensione e limite di caratteri.
**Requisiti:**
+ **Formati supportati:** Word, Excel, PDF PowerPoint, CSV, TXT, RTF, JSON, XML, HTML
+ **Limite di dimensione del file: 50 MB** per file
+ **Condizione del file:** non danneggiato o protetto da password
**Per risolvere problemi di formato:**
1. Verifica che i tuoi file soddisfino i requisiti di formato e dimensione.
1. Converti i formati non supportati in formati supportati.
1. Rimuovi la protezione tramite password dai file.
1. Verifica che i file non siano danneggiati.
## Errori di accesso negato
Gli errori di accesso negato si verificano in genere a causa di problemi di autenticazione o autorizzazione.
Cause comuni:
+ **Credenziali non valide**: i token o le password di autenticazione potrebbero essere scaduti.
+ **Autorizzazioni insufficienti**: l'account utilizzato nell'integrazione non ha accesso in lettura all'origine dati.
+ **Restrizioni di rete**: il firewall o le politiche di sicurezza bloccano l'accesso.
+ Problemi **SSL/TLS: problemi relativi ai** certificati con connessioni sicure.
**Per risolvere:**
1. **Verifica delle credenziali di autenticazione**: conferma che le credenziali di autenticazione siano aggiornate e valide. Modifica l'integrazione per autenticarti nuovamente e generare un nuovo token.
1. **Per le fonti di dati dei web crawler**: verifica che le connessioni sicure siano configurate correttamente e che i certificati SSL siano configurati correttamente e affidabili.
1. **Contatta l'amministratore di sistema**: se continui a riscontrare problemi di accesso, contatta l'amministratore di sistema. Potrebbe essere necessario modificare le autorizzazioni o le impostazioni di sicurezza.