Passa al contenuto principale

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​

Crea un AI Model Gemini​

Vai su Generative AI → AI Models e clicca su Nuovo Modello → Gemini.

Opzioni di configurazione​

CampoDescrizione
NomeUn nome univoco per identificare questo AI Model.
API KeyLa 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​

ParametroDefaultDescrizione
Prompt versionv3Versione del prompt di sistema applicata durante l'utilizzo del modello nei nodi Knowledge Base.
Completion modelgemini-3.8-flashIl modello Gemini usato per la generazione delle risposte. Testo libero: inserisci l'identificatore del modello fornito da Google.
Thinking LevelVuotoLivello di reasoning del modello. Testo libero, per esempio minimal, low, medium o high.
Max token completionVuotoNumero massimo di token nella risposta generata. Opzionale.
Number of extracted chunks3Quanti 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.

Argomenti correlati​