Quickstart: il primo agente in 10 minuti
Tempo richiesto: circa 10 minuti.
Questa guida porta dalla creazione di una base di conoscenza a una conversazione di prova con il proprio primo agente, in cinque passi.
Prerequisiti
- Un account con permesso di gestione Knowledge Base e permesso di creazione agenti sul tenant.
- Un documento di esempio (PDF, DOCX o TXT) da caricare come primo contenuto.
Passo 1 — Creare una Knowledge Base
Aprire la sezione Knowledge Base e selezionare Nuova Knowledge Base: assegnare un nome e confermare la lingua principale dei contenuti.
Il dettaglio dei campi (KB padre, modello di embedding, vector store, strategia di chunking) è descritto in Creare una Knowledge Base; per questo quickstart sono sufficienti i valori di default.
Passo 2 — Aggiungere una sorgente
All'interno della Knowledge Base appena creata, selezionare Nuova sorgente → Documenti e caricare il documento di esempio tramite trascinamento.
Il documento passa dallo stato In attesa a Pronto una volta completata l'indicizzazione; il procedimento completo, inclusa la gestione dei documenti scansionati, è descritto in Caricare documenti (con OCR).
Passo 3 — Creare l'agente e collegare la KB
Aprire la sezione Agenti, selezionare Nuovo agente e compilare nome e descrizione.
Al termine del wizard, scrivere un system prompt sintetico (ad esempio "Rispondi alle domande dei clienti utilizzando la base di conoscenza collegata") e collegare la Knowledge Base creata al passo 1. Il dettaglio dei parametri del modello e delle sezioni di configurazione è descritto in Creare un agente.
Passo 4 — Attivare l'agente
Dal dettaglio dell'agente, impostare lo stato su Attivo. La transizione viene rifiutata se il system prompt è vuoto: vedere Gli agenti conversazionali per il ciclo di vita completo degli stati.
Passo 5 — Provarlo in Chat
Aprire la sezione Chat, avviare una nuova conversazione e selezionare l'agente appena attivato. Scrivere una domanda relativa al contenuto del documento caricato: la risposta deve citare il documento tra le fonti.
Per approfondire il pannello Dati Tecnici e la verifica delle fonti recuperate, vedere Provare un agente.
Risultato atteso
Al termine dei cinque passi è disponibile un agente attivo, collegato a una Knowledge Base con almeno un documento indicizzato, che risponde nella console Chat citando le fonti consultate.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| L'agente non passa allo stato Attivo | Il system prompt è vuoto | Compilare il system prompt prima di cambiare stato |
| La risposta non cita alcuna fonte | Il documento non ha ancora completato l'indicizzazione, oppure la KB non è collegata all'agente | Verificare lo stato del documento e la KB collegata in Collegare le Knowledge Base (RAG) |
| Il documento resta a lungo in stato "In elaborazione" | File di grandi dimensioni o contenuto scansionato da elaborare in OCR | Attendere il completamento; vedere Caricare documenti (con OCR) |