Configurazione AI Model Google Gemini in ConvyAI
Panoramica
L'integrazione Google Gemini connette ConvyAI ai modelli multimodali fondazionali di Google per la classificazione degli intent, l'estrazione di entità e la generazione di risposte all'interno del flusso bot.
Prerequisiti
- Una chiave API Google Gemini.
- Chiave API configurata in Impostazioni Generative AI.
Crea un AI Model Gemini
Vai su Generative AI → AI Models e clicca su Nuovo Modello → Gemini.
Opzioni di configurazione
| Campo | Descrizione |
|---|---|
| Nome | Un nome univoco per identificare questo AI Model. |
| API Key | La tua chiave API Google Gemini. |
ConvyAI supporta i modelli Gemini 3.5 e successivi accessibili tramite la Google AI API. I modelli Gemini 2.5 sono deprecati da Google e non sono più censibili. Il modello viene specificato per nome nel parametro avanzato Completion model (per esempio gemini-3.8-flash). Consulta la documentazione dei modelli Google AI per la lista completa dei modelli disponibili e i relativi identificatori.
Parametri avanzati
| Parametro | Default | Descrizione |
|---|---|---|
| Prompt version | v3 | Versione del prompt di sistema applicata durante l'utilizzo del modello nei nodi Knowledge Base. |
| Completion model | gemini-3.8-flash | Il modello Gemini usato per la generazione delle risposte. Testo libero: inserisci l'identificatore del modello fornito da Google. |
| Thinking Level | Vuoto | Livello di reasoning del modello. Testo libero, per esempio minimal, low, medium o high. |
| Max token completion | Vuoto | Numero massimo di token nella risposta generata. Opzionale. |
| Number of extracted chunks | 3 | Quanti chunk della Knowledge Base vengono recuperati e passati al modello come contesto durante la RAG. |
Parametri opzionali
Thinking Level e Max token completion sono opzionali. Se lasci un campo vuoto, il parametro non viene inviato e il modello usa il suo default. Se inserisci un valore, viene inviato al provider così com'è, senza controlli: assicurati che sia valido per il tuo modello. Se il provider lo rifiuta, la console di test mostra il suo errore. Vedi Parametri opzionali.
Configura il Thinking Level una sola volta sull'AI Model: lo usano i nodi AI Agent sia del FlowDesigner sia dell'Agentic Designer.
Parametri rimossi
Thinking budget, Temperature, Top P, Frequency penalty e Presence penalty non sono più disponibili sugli AI Model Gemini, perché i modelli Gemini 3.5 e successivi non li supportano. Non vengono inviati al provider anche se presenti in un AI Model salvato in precedenza.
Aggiornamento da Gemini 2.5
Gli AI Model già configurati su modelli Gemini 2.5 smettono di funzionare: la console di test mostra l'errore restituito dal provider e i flussi non vanno in crash. Per ripristinarli, indica un modello 3.5 o successivo in Completion model e, se necessario, imposta il Thinking Level. Gli AI Model già su 3.5 o successivi continuano a funzionare senza riconfigurazione.
Intent, entità e test
La configurazione di intent ed entità e il test del modello sono funzionalità condivise tra tutti i provider di AI Model. Consulta Intent, Entità & Test per la documentazione completa.