Configurazione AI Model OpenAI in ConvyAI
Panoramica
L'integrazione OpenAI connette ConvyAI ai modelli GPT per la classificazione degli intent, l'estrazione di entità e la generazione di risposte all'interno del flusso bot.
Prerequisiti
- Una chiave API OpenAI con accesso al modello desiderato.
- Chiave API configurata in Impostazioni Generative AI.
Crea un AI Model OpenAI
Vai su Generative AI → AI Models e clicca su Nuovo Modello → OpenAI.
Opzioni di configurazione
| Campo | Descrizione |
|---|---|
| Nome | Un nome univoco per identificare questo AI Model. |
| API Key | La tua chiave API OpenAI. |
| Intent threshold | Punteggio di confidenza minimo affinché un intent venga considerato valido. |
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 | gpt-5.1 | Il modello usato per la generazione delle risposte. |
| Embedding model | text-embedding-3-small | Il modello usato per l'embedding durante l'indicizzazione e il retrieval della Knowledge Base. |
| Max token completion | 1000 | Numero massimo di token nella risposta generata. |
| Temperature | - | Controlla la creatività delle risposte. Valori più bassi (0.0–0.3) producono output più deterministici; valori più alti (0.7–1.0) producono risposte più varie. |
| Top P | - | Parametro di nucleus sampling. Limita la selezione dei token alla massa di probabilità più alta. |
| Frequency penalty | - | Riduce la ripetizione di token già apparsi nell'output. |
| Presence penalty | - | Incoraggia il modello a introdurre nuovi argomenti penalizzando i token già apparsi. |
| Reasoning effort | - | Il livello di reasoning del modello, in un campo a testo libero non validato. Inserisci il valore previsto dal tuo modello (ad esempio low, medium o high), oppure il valore che disattiva il reasoning (ad esempio none). Il valore vale sia per i nodi Knowledge Base sia per i nodi AI Agent, quindi lo configuri una sola volta. |
| Number of extracted chunks | 3 | Quanti chunk della Knowledge Base vengono recuperati e passati al modello come contesto durante la RAG. |
I parametri opzionali nascono vuoti sui nuovi AI Model. Un campo vuoto significa che il parametro non viene inviato e vale il default del provider; qualsiasi valore inserito viene inviato così com'è. Vedi Parametri opzionali.
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.