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
- 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.