Assistente

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]

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

Tipo: Agente

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

[SCREENSHOT: configurazione Assistente in modalità Agente con campo di selezione dell'agente disponibile]

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

[SCREENSHOT: configurazione Assistente in modalità LLM con selezione del modello e visualizzazione del system prompt corrente]

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

[SCREENSHOT: opzione per sovrascrivere il system prompt dell'LLM con un prompt specifico per l'assistente]

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

[SCREENSHOT: configurazione Assistente in modalità Webservice REST con selezione del webservice esterno]

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