Base di conoscenza
La base di conoscenza riunisce ciò che i tuoi agenti devono sapere: procedure, FAQ, condizioni, schede prodotto, documenti di riferimento. Appartiene alla tua organizzazione; un agente la consulta nel momento in cui ne ha bisogno, tramite un tool, invece di portare tutto nella propria missione.
Cosa contiene
Tre tipi di voci:
| Tipo | Contenuto |
|---|---|
| Scheda | Un testo Markdown, scritto direttamente nell'admin |
| Documento | Un file caricato, il cui testo viene estratto automaticamente per gli agenti |
| Cartella | Un raccoglitore per organizzare schede e documenti |
Formati di documento accettati: PDF, Word (.doc, .docx), Excel (.xls, .xlsx), PowerPoint (.ppt, .pptx), testo, Markdown, HTML, CSV e immagini — fino a 50 MB per file.
L'estrazione legge il testo dei formati da ufficio e dei PDF. Per un'immagine o un PDF scansionato (quasi privo di testo), passa per il modello multimodale (visione) della tua organizzazione. Un'estrazione non riuscita può essere rilanciata dall'admin.
Ogni scrittura nella base viene registrata. Modificarla richiede l'accesso alla sezione Conoscenza e indicizzazione; la lettura è aperta ai membri dell'organizzazione.
Cosa ne fanno i tuoi agenti
Due tool, da collegare a un agente:
knowledge.search— ricerca per parole chiave, ponderata (etichette, poi nome, descrizione, contenuto). Restituisce la voce più pertinente.knowledge.semantic_search— ricerca semantica (per significato, non per parole esatte). Restituisce estratti con la loro fonte e il loro punteggio.
I risultati vengono presentati all'agente come materiale di riferimento: risponde nella lingua dell'utente e non deve affermare nulla oltre quanto dice la fonte.
Ricerca semantica
Per la ricerca semantica, le schede e il testo estratto dai documenti vengono suddivisi e indicizzati in un database vettoriale (Qdrant). Gli embedding sono calcolati dal modello bge-m3, servito da Ollama all'interno della nostra infrastruttura: il testo della tua base non viene inviato a un fornitore di embedding terzo.
La sincronizzazione è automatica: una scheda creata o modificata viene reindicizzata, una voce eliminata viene rimossa dall'indice e un'indicizzazione non riuscita viene ritentata. La ricerca semantica dipende dalla sua attivazione sull'istanza; in caso contrario, il tool indirizza l'agente verso knowledge.search.
Ambito per modello
Per impostazione predefinita, un modello cerca in tutta la base della propria organizzazione. Puoi restringere ciò che vede, dalla scheda Base di conoscenza del modello:
- selezionare una cartella dà accesso a tutto il suo contenuto, compreso ciò che vi verrà aggiunto in seguito;
- selezionare una scheda o un documento dà accesso solo a quell'elemento.
Lo stesso ambito si applica ai due tool di ricerca. È uno strumento di pertinenza (un assistente HR non deve leggere le FAQ commerciali); l'isolamento di sicurezza, invece, è quello dell'organizzazione: la base di un'organizzazione non è mai leggibile da un'altra.
Condividere un documento tramite link
Una scheda o un documento può essere pubblicato tramite link (/shared/…), per un partner o un cliente che non ha un account betool. Le cartelle non si condividono.
- Password facoltativa — richiesta anche per il download del file.
- Scadenza facoltativa, da 1 giorno a 5 anni; senza scadenza, il link resta valido fino alla sua revoca.
- Revoca in qualsiasi momento; ripubblicare crea un nuovo link e revoca il precedente; eliminare la voce revoca il suo link. Un link revocato, scaduto o sconosciuto restituisce la stessa pagina « non trovata ».
- Visualizzazione: un PDF o un'immagine viene mostrato nella pagina; un documento Markdown viene reso formattato; una pagina HTML viene mostrata in un riquadro isolato (senza script né risorse remote). Gli altri formati si scaricano, con il testo estratto mostrato quando esiste.
- Le pagine condivise non sono indicizzabili dai motori di ricerca, e il numero di consultazioni viene tracciato.
Aggiornare senza cambiare il link
Sostituire il file di un documento ne conserva l'identificativo, e quindi il link già distribuito: serve immediatamente la nuova versione. Il testo letto dagli agenti viene ri-estratto dal nuovo file, così ciò che leggono i tuoi agenti e ciò che vede il tuo partner non possono divergere.
Aggiornare tramite proposta
Un agente (o un'applicazione collegata via MCP) può proporre di far evolvere la base, con validazione umana:
knowledge_update— creare o aggiornare una scheda di testo (sostituzione completa, di una sezione, o aggiunta in coda).knowledge_document_replace— sostituire il file di un documento, sul posto, mantenendo il link pubblico.
Nulla viene applicato senza un Accetta esplicito.