Agenti

La sezione Agenti permette di configurare agenti AI che combinano un modello LLM, uno o piùpiù tool MCP e, se necessario, documenti del CRM da usare come base di conoscenza. In pratica, qui definisci come l'agente ragiona, quali strumenti puòpuò usare e quali contenuti puòpuò consultare per svolgere un task.

In sintesi: un agente non èè solo un modello AI. ÈÈ una configurazione completa che unisce LLM, tool operativi e fonti documentali, cosìcosì da eseguire attivitàattività in modo piùpiù controllato e utile nel contesto di vtenext.

Prerequisito: orchestratore agenti

Per usare gli agenti èè necessario che il servizio orchestratore agenti sia installato e raggiungibile. Nella schermata elenco degli Agenti èè disponibile una scheda dedicata in cui puoi indicare l'Endpoint orchestratore, cioècioè l'URL base del servizio.

[SCREENSHOT: scheda Orchestratore agenti con campo Endpoint orchestratore e link al manuale di installazione]

Importante: se l'endpoint dell'orchestratore non èè configurato correttamente, gli agenti non possono essere eseguiti.

Quando usarla

• Per configurare agenti AI da usare nell'assistente o nei processi.
• Per associare ad un agente un LLM specifico.
• Per dare all'agente accesso a tool MCP selezionati.
• Per abilitare la capacitàcapacità RAG scegliendo documenti del CRM come fonti di conoscenza.
• Per applicare regole di controllo prima e dopo la generazione della risposta (guardrail).

La schermata elenco

Nella lista sono visibili gli agenti giàgià configurati.

[SCREENSHOT: panoramica della lista Agenti con colonne Attivo, Nome, Descrizione, Tipo, LLM e Documenti]

• Attivo: indica se l'agente èè abilitato.
• Nome: nome dell'agente.
• Descrizione: testo che spiega lo scopo dell'agente.
• LLM: mostra il modello associato.
• Documenti: indica se l'agente ha accesso a documenti RAG.

Dalla lista puoi creare un nuovo agente, modificarlo o eliminarlo.

Creare un nuovo agente

[SCREENSHOT: form principale di configurazione agente con campi Attivo, Nome, Descrizione e LLM]

1. Apri la sezione Agenti.
2. Fai clic su Aggiungi.
3. Attiva o disattiva l'agente secondo le tue esigenze.
4. Inserisci Nome e Descrizione.
5. Seleziona l'LLM da usare.
6. Valuta se mantenere il system prompt dell'LLM oppure sovrascriverlo per questo agente.
7. Seleziona i tool che l'agente potràpotrà usare.
8. Se necessario, abilita la capacitàcapacità RAG e scegli i documenti.
9. Configura eventuali guardrail.
10. Salva la configurazione.

Campi principali

[SCREENSHOT: dettaglio dei campi LLM, system prompt corrente e opzione per sovrascrivere il system prompt]

• Attivo: abilita o disabilita l'agente.
• Nome: nome interno con cui riconosci l'agente.
• Descrizione: breve descrizione interna che riassume il compito dell'agente.
• LLM: modello linguistico usato dall'agente.
• System prompt dell'LLM: mostra il system prompt attualmente configurato sul modello selezionato.
• Sovrascrivi system prompt: se attivato, l'agente usa un system prompt specifico invece di quello standard dell'LLM.
• System prompt: istruzioni specifiche dell'agente, visibili solo se scegli di sovrascrivere il prompt del modello.

Quando usare la sovrascrittura del system prompt: èè utile quando vuoi mantenere lo stesso LLM ma cambiare in modo netto comportamento, tono o responsabilitàresponsabilità di un singolo agente.

Tool disponibili per l'agente

Sotto ai campi principali trovi l'area Tool, dove scegli quali strumenti l'agente puòpuò usare.

[SCREENSHOT: sezione Tool dell'agente con gruppi per client MCP e schede selezionabili dei tool]

I tool sono mostrati per gruppi, in base ai client MCP attivi e ai tool interni disponibili.

• Kitt tools: include tool interni di base come calculator e user_manual.
• Client MCP: per ogni client MCP attivo puoi selezionare i tool sincronizzati e disponibili.

Per ogni gruppo puoi selezionare tutti i tool oppure deselezionarli rapidamente. ÈÈ disponibile anche una ricerca per filtrare i tool per nome o descrizione.

Attenzione: l'agente puòpuò usare solo i tool che selezioni in questa sezione. Se un client MCP non èè configurato o non ha tool sincronizzati, non compariràcomparirà come sorgente utilizzabile.

CapacitàCapacità RAG e documenti

Se vuoi che l'agente lavori anche su contenuti del CRM, puoi attivare la capacitàcapacità RAG.

[SCREENSHOT: scheda Documenti con checkbox CapacitàCapacità RAG, pulsante Seleziona e tabella dei documenti associati all'agente]

• CapacitàCapacità RAG: abilita l'uso di documenti come fonti di conoscenza.
• Seleziona: apre il selettore documenti per aggiungere file del CRM.
• Tabella documenti: mostra titolo, file, assegnatario e cartella dei documenti giàgià associati.

Una volta aggiunti, i documenti restano collegati all'agente e possono essere rimossi in qualsiasi momento dalla tabella.

Quando conviene usare RAG: èè utile quando l'agente deve rispondere o lavorare partendo da documentazione, file o contenuti aziendali presenti nel CRM, non solo da istruzioni generiche.

Guardrail

La sezione Agenti permette anche di definire controlli prima e dopo la generazione della risposta.

[SCREENSHOT: campi di pre-guardrail e post-guardrail con regole statiche, scelta LLM e prompt di validazione]

• Pre-guardrail statico: blocca input che contengono parole o espressioni non consentite.
• LLM pre-guardrail: usa un LLM per valutare l'input prima dell'elaborazione.
• Prompt pre-guardrail: definisce le istruzioni con cui il controllo valuta l'input.
• Post-guardrail statico: blocca output che contengono contenuti non consentiti.
• LLM post-guardrail: usa un LLM per valutare la risposta prima di restituirla.
• Prompt post-guardrail: definisce le istruzioni del controllo finale.

Le regole statiche possono includere testo semplice oppure espressioni regolari, una per riga.

Attenzione: i guardrail basati su LLM possono aumentare consumo di token e tempi di risposta, perchéperché aggiungono passaggi di verifica.

Esempi pratici

Esempio 1: agente con tool operativi

Puoi creare un agente che usa un LLM e alcuni tool MCP per interrogare dati, eseguire azioni consentite o consultare servizi esterni come la ricerca web.

Esempio 2: agente documentale

Puoi creare un agente focalizzato su documenti interni, abilitando RAG e selezionando solo i file rilevanti per uno specifico reparto o processo.

Esempio 3: agente con controlli rafforzati

Se l'agente opera su contenuti sensibili, puoi applicare pre-guardrail e post-guardrail per limitare richieste o risposte non appropriate.