22.5 Assistente Kitt

La sezione Assistente permette di definire come deve rispondere l'assistente Kitt di vtenext. In pratica, qui scegli quale motore usare per le risposte: un LLM diretto, un agente già configurato oppure un Webservice REST personalizzato.

In sintesi: l'assistente è il punto di accesso con cui l'utente interagisce. A seconda della configurazione, può rispondere direttamente con un modello, usare strumenti avanzati tramite un agente oppure delegare la risposta a un servizio esterno.

Prerequisiti

Per usare un LLM, devi prima configurare almeno un modello nella sezione LLM.
Per usare un Agente, devi prima configurare almeno un agente nella sezione Agenti.
Per usare un Webservice REST, devi prima configurare il servizio nella relativa sezione.
Per il funzionamento dell'assistente è necessario attivare il worker per le attività in background.

Creare o modificare l'assistente

~~[SCREENSHOT: form dell'Assistente con selezione del tipo tra Agente, LLM e Webservice REST]~~

Apri la sezione Assistente.
Attiva o disattiva la configurazione.
Seleziona il Tipo di assistente.
Compila il campo mostrato in base al tipo scelto.
Salva la configurazione.

Tipo: Agente

Se scegli Agente, l'assistente userà uno degli agenti già configurati in vtenext.

Selezioni un agente dall'elenco disponibile.
L'assistente eredita le capacità dell'agente scelto.
Questo include, se configurati nell'agente, tool MCP, documenti RAG, prompt specifici e guardrail.

Quando conviene usare un agente: è la scelta giusta quando vuoi che l'assistente faccia più di una semplice risposta testuale, per esempio usare tool, consultare documenti o seguire controlli più avanzati.

Tipo: LLM

Se scegli LLM, l'assistente userà direttamente un modello linguistico configurato nella sezione LLM.

Selezioni il modello LLM da usare.
Puoi visualizzare il system prompt dell'LLM attualmente configurato.
Puoi attivare l'opzione Sovrascrivi system prompt per usare un prompt specifico solo per l'assistente.

Questa modalità è più semplice rispetto all'uso di un agente, perché non coinvolge tool MCP o documenti RAG.

Sovrascrivere il system prompt

Quando l'assistente è configurato in modalità LLM, puoi decidere se mantenere il system prompt del modello oppure sostituirlo.

System prompt dell'LLM: mostra il prompt standard già presente sul modello selezionato.
Sovrascrivi system prompt: se attivato, l'assistente usa il testo specificato nella configurazione dell'assistente.
System prompt: campo in cui definisci istruzioni dedicate all'assistente.

Quando è utile: la sovrascrittura del system prompt serve quando vuoi mantenere lo stesso modello ma cambiare tono, obiettivo o comportamento dell'assistente rispetto ad altre configurazioni che usano lo stesso LLM.

Tipo: Webservice REST

Se scegli Webservice REST, l'assistente delega la risposta a un servizio REST esterno già configurato.

Selezioni un webservice REST custom dall'elenco.
Il messaggio dell'utente deve essere passato nel corpo grezzo usando il tag $content.
La risposta attesa deve essere mappata nel campo restituito message.

Limite da considerare: in questa modalità non sono supportate la modalità stream e la memoria conversazionale.

Questa opzione è utile quando vuoi collegare l'assistente a un sistema esterno già esistente o a un servizio AI personalizzato non gestito direttamente come LLM o agente in vtenext.

Esempi pratici

Esempio 1: assistente solo LLM

Puoi configurare un assistente leggero che usa direttamente un modello per rispondere a domande generali, senza tool o documenti aggiuntivi.

Esempio 2: assistente basato su agente

Puoi usare un agente quando vuoi che l'assistente abbia accesso a ricerca web, documenti aziendali o strumenti operativi del CRM.

Esempio 3: assistente con servizio esterno

Puoi collegare un webservice REST custom se il tuo flusso prevede un motore di risposta esterno o una logica già sviluppata fuori da vtenext.