# Knowledge base La sezione Knowledge base è l'area di Aurora in cui puoi raccogliere i contenuti che aiutano gli agenti a rispondere in modo più coerente, preciso e allineato alla tua attività. In termini semplici, è il luogo in cui trasformi informazioni aziendali, documenti, testi e pagine web in materiale consultabile dal sistema. Questa sezione è particolarmente importante perché un agente può avere una buona voce, un buon tono e un buon obiettivo, ma se non dispone delle informazioni corrette rischia comunque di dare risposte incomplete, troppo generiche o poco affidabili. La knowledge base serve proprio a ridurre questo rischio e a mettere a disposizione dell'agente una base informativa più solida. *** ### Che cos'è una knowledge base Una knowledge base è un contenitore di informazioni che l'agente può usare come supporto durante la conversazione. Può contenere, per esempio, risposte frequenti, procedure interne, spiegazioni sui servizi, regole commerciali, condizioni operative, orari, informazioni di prodotto o istruzioni relative alla gestione di appuntamenti e richieste. {% hint style="warning" %} Non va però intesa come un archivio generico in cui inserire qualsiasi testo. Per essere davvero utile, una knowledge base deve contenere contenuti chiari, affidabili e pertinenti rispetto al ruolo dell'agente che la utilizzerà. Più le informazioni sono ordinate e ben scritte, più sarà facile ottenere conversazioni coerenti e utili. {% endhint %} *** ### A cosa serve la pagina principale La pagina principale della sezione ti permette di consultare l'elenco delle knowledge base già presenti in piattaforma e di crearne di nuove. È il punto da cui puoi controllare ciò che è stato già caricato, verificare l'ultimo aggiornamento dei contenuti e intervenire con azioni operative come l'indicizzazione o l'eliminazione.
### I tre modi per creare una knowledge base Aurora consente di creare una knowledge base in tre modi diversi. La scelta dipende soprattutto da come sono organizzate oggi le tue informazioni e dal livello di controllo che vuoi mantenere sul contenuto.
#### 1. Inserimento da testo Questa modalità è utile quando vuoi scrivere o incollare direttamente il contenuto all'interno della piattaforma. È la scelta più adatta quando: * devi inserire istruzioni brevi o ben strutturate * vuoi creare velocemente una base informativa essenziale * stai raccogliendo FAQ, regole o procedure in forma testuale * vuoi avere il massimo controllo sul testo che l'agente userà Nel modulo da testo trovi due campi principali:
**Nome** È il nome con cui riconoscerai la knowledge base nella piattaforma. Conviene scegliere un titolo specifico e immediatamente comprensibile, perché questo ti aiuterà sia nella gestione interna sia quando dovrai associarla a un agente. **Testo** È il contenuto vero e proprio della knowledge base. Qui puoi inserire informazioni operative, spiegazioni, procedure, domande frequenti e contenuti di supporto. Il valore di questo campo non dipende dalla quantità di testo, ma dalla sua qualità: più il contenuto è chiaro e ordinato, più sarà utile. [Alcuni esempi pratici](#esempio-1-knowledge-base-per-prenotazione-appuntamenti) #### 2. Caricamento da file Questa modalità è utile quando le informazioni esistono già in documenti separati e vuoi importarli senza doverli riscrivere. Puoi selezionare file nei formati: * `PDF` * `TXT` * `MD` * `DOC` * `DOCX` * `RTF` * `HTML` * `CSV` Questa opzione è particolarmente utile quando hai già materiale preparato, ad esempio documentazione commerciale, procedure, documenti di supporto o raccolte di contenuti che vuoi rendere disponibili all'agente. Nel modulo da file trovi: **Nome** Anche in questo caso è il titolo con cui la knowledge base apparirà in piattaforma. Non è necessario che coincida perfettamente con il nome del file, ma deve aiutarti a riconoscere il contenuto in modo immediato. **File** Qui selezioni il documento da caricare. Dopo la scelta, l'interfaccia mostra il nome del file selezionato, così puoi verificare subito di aver scelto il documento corretto prima del salvataggio. #### 3. Caricamento da URL Questa modalità è utile quando le informazioni da usare sono già pubblicate su una pagina web e vuoi importarle a partire da un indirizzo. È una soluzione comoda quando: * la tua azienda ha già contenuti utili sul sito * hai una pagina con FAQ, servizi o istruzioni operative * vuoi partire da una fonte online già mantenuta aggiornata Nel modulo da URL trovi: **URL** È il campo principale e deve contenere un indirizzo valido. Conviene verificare bene il collegamento prima del salvataggio, perché la qualità del risultato dipende anche dalla qualità e dalla chiarezza della pagina di origine. **Nome** È facoltativo. Se lo inserisci, puoi assegnare alla knowledge base un titolo più leggibile rispetto al solo indirizzo web. *** ### Ricerca e organizzazione Quando il numero delle knowledge base cresce, la ricerca diventa essenziale. La pagina mette a disposizione una barra di ricerca e opzioni di ordinamento che ti aiutano a trovare più rapidamente il contenuto corretto. Dal punto di vista pratico, conviene mantenere una nomenclatura ordinata e coerente. Se i nomi sono troppo generici, con il tempo la consultazione diventa meno chiara. Al contrario, titoli ben scelti rendono più semplice sia la gestione della sezione sia il collegamento con gli agenti. *** ### Aggiornare l'elenco La pagina include anche un comando di aggiornamento manuale. Questa funzione è utile quando hai appena creato, indicizzato o eliminato una knowledge base e vuoi ricaricare rapidamente la lista per controllare che il risultato sia correttamente visibile. *** ### Indicizzazione della knowledge base Una volta caricata una knowledge base, la piattaforma mette a disposizione un'azione di indicizzazione. In termini pratici, questa operazione serve a preparare il contenuto perché possa essere utilizzato in modo più efficace dal sistema.
Per l'utente, il concetto chiave è questo: caricare un contenuto e renderlo davvero pronto all'uso non sono esattamente la stessa cosa. L'indicizzazione è il passaggio che aiuta Aurora a trattare quel contenuto come una base informativa utilizzabile. Quando apri la finestra di indicizzazione, trovi: **Knowledge base selezionata** La piattaforma ti mostra il contenuto su cui stai per intervenire, così puoi verificare di stare lavorando sulla base corretta. **Modello di indicizzazione** Puoi scegliere il modello con cui avviare l'indicizzazione. Se non hai esigenze particolari, conviene mantenere l'impostazione consigliata o già selezionata e modificare questa scelta solo se hai una ragione precisa per farlo. *** ### Eliminazione di una knowledge base Se una knowledge base non è più utile, puoi eliminarla. Prima della cancellazione, la piattaforma richiede una conferma. Questo passaggio è importante perché evita rimozioni accidentali di contenuti che potrebbero essere ancora collegati a un agente o utili come riferimento.
Dal punto di vista operativo, conviene eliminare solo i contenuti che sei sicuro di non dover più usare. Se una knowledge base contiene informazioni ancora valide ma da rivedere, in molti casi è preferibile aggiornarla o sostituirla con una versione migliorata. ### Relazione con la configurazione degli agenti La knowledge base non lavora in isolamento. Il suo valore emerge quando viene collegata a un agente. Nella configurazione dell'agente, infatti, puoi selezionare una o più knowledge base da associare al suo comportamento. Questo significa che la sezione Knowledge base è il luogo in cui prepari il contenuto, mentre la sezione Gestione agenti è il luogo in cui decidi quale agente deve utilizzarlo. Le due aree vanno quindi pensate insieme: prima si costruisce una base informativa affidabile, poi la si collega al profilo operativo corretto. ### Come scrivere contenuti utili Se stai creando una knowledge base da zero, il criterio più importante è la chiarezza. L'obiettivo non è scrivere il testo più lungo possibile, ma costruire un contenuto che sia: * chiaro * ordinato * coerente * aggiornato * pertinente rispetto all'uso reale dell'agente In generale, funzionano meglio contenuti che: * separano bene gli argomenti * usano frasi dirette e non ambigue * evitano contraddizioni * distinguono chiaramente regole, eccezioni e casi particolari * riportano informazioni realmente utili alla conversazione ### Esempi pratici Di seguito trovi alcuni esempi semplici che possono aiutarti a capire come strutturare i contenuti. #### Esempio 1: knowledge base per prenotazione appuntamenti Questa è una struttura utile quando l'agente deve aiutare a fissare appuntamenti. ``` Servizi principali dello studio: - igiene dentale - visita odontoiatrica - ortodonzia - cura delle carie - implantologia - protesi dentali - odontoiatria pediatrica Quando un paziente chiede informazioni: - spiega i servizi in modo semplice - aiuta il paziente a capire quale appuntamento richiedere - se la domanda è troppo specifica sul piano clinico, invita a fissare una visita Quando un paziente vuole prenotare: - raccogli nome e cognome - raccogli numero di telefono - chiedi il motivo della visita - chiedi una preferenza di giorno o fascia oraria - conferma sempre i dati raccolti prima di chiudere Regole sugli appuntamenti: - proponi appuntamenti solo negli orari di apertura - se l’orario richiesto non è disponibile, proponi un’alternativa vicina - se mancano dati essenziali, chiedili prima di concludere Gestione richieste delicate: - se il paziente riferisce forte dolore, gonfiore o urgenza, non fare diagnosi - mantieni sempre un tono calmo e ordinato - non minimizzare mai il problema Indirizzo dello studio: Via Dei mille 5, Roma Orari di apertura: - mattina dalle 9 alle 13 - pomeriggio dalle 15 alle 20 ``` Questo tipo di contenuto è utile perché unisce informazioni pratiche e regole di comportamento in una forma semplice da consultare. #### Esempio 2: knowledge base per FAQ commerciali Questa è una struttura utile quando l'agente deve rispondere a domande frequenti su servizi o offerte. ``` Gestione delle FAQ: - ascolta la richiesta del cliente - identifica il tema principale della domanda - fornisci una risposta breve e comprensibile - se necessario, accompagna il cliente al passo successivo - se la richiesta non rientra nelle FAQ, proponi il contatto con un operatore Esempi di domande frequenti generiche: - Come funziona il servizio? - Come posso attivarlo? - Come posso richiedere informazioni? - Come posso essere ricontattato? - Come faccio a modificare i miei dati? - Come posso sapere a che punto è la mia richiesta? - Cosa devo fare se ho bisogno di assistenza? - Come posso prenotare un appuntamento o una consulenza? - Quali documenti potrebbero servire? - In quali orari è disponibile il servizio? Regole di risposta: - spiega sempre le cose in modo semplice - se il cliente chiede dettagli troppo specifici, chiarisci che serve una verifica sul suo caso - se il cliente mostra incertezza, guidalo con una domanda breve - chiudi la risposta verificando se ha bisogno di altro ``` Questo formato è efficace perché trasforma il contenuto in domande e risposte chiare, molto facili da mantenere e da aggiornare. *** ### Un metodo consigliato Se stai iniziando a usare questa sezione, il metodo più efficace è questo: 1. parti da contenuti brevi e ben strutturati 2. crea una knowledge base distinta per ogni area importante 3. usa nomi chiari e facilmente riconoscibili 4. indicizza i contenuti dopo il caricamento 5. collega la knowledge base all'agente giusto Questo approccio rende più semplice sia la gestione dei contenuti sia il controllo della qualità delle risposte generate dagli agenti. ### Errori comuni da evitare I casi più frequenti in questa sezione sono: * caricare documenti troppo generici, poco pertinenti e troppo grandi * inserire testi disordinati o contraddittori * usare nomi poco chiari per le knowledge base * dimenticare l'indicizzazione dopo il caricamento * collegare all'agente contenuti non coerenti con il suo ruolo * lasciare in uso informazioni non aggiornate ### Serve supporto? Se riscontri problemi nel caricamento dei contenuti, dubbi su come strutturare una knowledge base o difficoltà nel collegarla agli agenti, puoi scrivere a `assistenza@aurorasuite.ai`. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aurorasuite.ai/funzionalita-operative/phone-numbers-and-voip-1.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.