Vai al contenuto

Pronto a creare con AnyBot?

Documentazione AnyBot
Agenti

Base di conoscenza

Addestra un agente sui tuoi documenti e sul tuo sito web perché risponda solo dai tuoi contenuti, mai inventando.

La base di conoscenza di un agente è il contenuto da cui risponde. Aggiungi i tuoi documenti e le pagine del tuo sito web, e l'agente fonda ogni risposta su quel materiale invece di tirare a indovinare. Abbinala al guardrail Rispondi solo dalla mia base di conoscenza e l'agente rifiuta, o passa la mano, su qualsiasi cosa i tuoi contenuti non coprano, invece di inventare una risposta. Gestisci tutto dalla scheda Base di conoscenza dell'editor dell'agente.

Aggiungere conoscenza

Due modi per aggiungere una fonte, entrambi dalla scheda Base di conoscenza:

  • Carica un file, un documento o un'immagine.
  • Importa da un URL, inserisci l'indirizzo di un sito web e AnyBot lo esplora, aggiungendo alla base di conoscenza le pagine che legge. Collega l'integrazione Website Crawler per esplorare un intero sito e, se vuoi, tenerlo aggiornato secondo una pianificazione (giornaliera, settimanale o mensile).
FonteCosa acquisisce
DocumentiPDF, Word, Excel, CSV, JSON, HTML, Markdown, testo semplice
ImmaginiJPEG, PNG, GIF, WebP, lette e descritte dall'AI di visione, poi indicizzate come testo
Sito webEsplorato per URL, estratto, suddiviso in sezioni e aggiunto alla base di conoscenza

La scansione una tantum del sito che la procedura guidata di registrazione esegue per costruire il profilo della tua attività è un passaggio separato dalla base di conoscenza dell'agente.

La pipeline di acquisizione

Aggiungere una fonte non la rende immediatamente utilizzabile per rispondere, ognuna viene elaborata in background prima che l'agente possa usarla:

   Upload a file / import a URL
              │
              ▼
        Pending ──▶ Processing ──▶ Ready
                        │        (chunked, embedded, searchable)
                        ▼
                     Failed ──▶ delete + add again
  • Pending, in coda per l'acquisizione.
  • Processing, la fonte viene suddivisa in blocchi e vettorizzata così che l'agente possa cercarla per significato; le immagini vengono prima lette e descritte dall'AI di visione.
  • Ready, ricercabile. Ora l'agente può citarla.
  • Failed, qualcosa è andato storto (un URL irraggiungibile, un file illeggibile). Elimina la fonte e aggiungila di nuovo; non esiste un pulsante di ritentativo separato.

La scheda Base di conoscenza mostra lo Status dal vivo di ogni fonte e un conteggio dei Chunks, così puoi seguire un documento voluminoso mentre attraversa la pipeline.

Libreria condivisa vs. per singolo agente

Ogni fonte ha uno scope che decide quali agenti possono raggiungerla:

ScopeChi può usarla
Libreria dello spazioCondivisa, disponibile a ogni agente nello spazio
AgentePrivata, solo l'agente a cui l'hai aggiunta

Carica un PDF di policy o un listino prezzi una sola volta a livello di libreria dello spazio invece di ricaricarlo su ogni agente. La scheda Base di conoscenza etichetta ogni riga con il suo scope, così puoi capire a colpo d'occhio se una fonte è propria dell'agente o ereditata dalla libreria condivisa. Gestisci la libreria condivisa dalla pagina Conoscenza a livello di spazio.

Risposte fondate

La conoscenza è solo metà della storia. È il guardrail Rispondi solo dalla mia base di conoscenza a mantenere onesto l'agente. Con quello attivo, l'agente risponde rigorosamente da ciò che hai aggiunto e rifiuta cortesemente le domande fuori tema; una risposta a bassa affidabilità può passare la mano a una persona. Fai le prove nella chat di test dal vivo prima di andare in produzione: chiedi qualcosa che sai essere coperto, poi qualcosa che sai non esserlo, e verifica che l'agente citi la prima e rifiuti la seconda. Regola il comportamento nella pagina Comportamento e guardrail.

Risoluzione dei problemi

  • Una fonte è bloccata su Failed. Eliminala e aggiungila di nuovo. Per un URL, controlla che la pagina si carichi pubblicamente (nessun muro di login) e che non sia un redirect.
  • L'esplorazione ha saltato alcune pagine. Le pagine dietro un login o che bloccano i crawler vengono saltate. Verifica che le pagine si carichino pubblicamente; collega l'integrazione Website Crawler per ri-esplorazioni pianificate.
  • L'agente ignora una fonte. Verifica che il suo status sia Ready, non Pending o Processing, e che sia assegnata (o condivisa) a quell'agente. Se l'agente ancora non risponde a partire da essa, controlla il guardrail rispondi-solo e la formulazione nella chat di test.

FAQ

Quali tipi di file posso aggiungere? PDF, Word, Excel, CSV, JSON, HTML, Markdown e testo semplice, più immagini (JPEG, PNG, GIF, WebP) che vengono lette dall'AI di visione. Il tuo operatore imposta il limite di dimensione e l'elenco consentito.

Può leggere tutto il mio sito web? Sì, inserisci l'URL del tuo sito e AnyBot lo esplora nella base di conoscenza. Collega l'integrazione Website Crawler per tenerla aggiornata secondo una pianificazione.

Inventerà qualcosa se non lo sa? No. Con il guardrail rispondi-solo attivo, risponde unicamente dai tuoi contenuti e rifiuta o inoltra a un livello superiore quando non può.

Tutti i miei agenti condividono un'unica base di conoscenza? Solo ciò che assegni alla libreria dello spazio. Qualsiasi cosa aggiunta a livello di agente resta privata per quell'agente.

Successivo