Configurazione AI Model Azure OpenAI in ConvyAI
Panoramica
L'integrazione Azure OpenAI consente a ConvyAI di usare modelli OpenAI deployati nella tua sottoscrizione Azure. È l'opzione consigliata se la tua organizzazione richiede che i dati rimangano all'interno dell'infrastruttura cloud Azure.
Prerequisiti
- Una risorsa Azure OpenAI con un modello deployato.
- L'URL dell'endpoint della risorsa e la chiave API.
- Credenziali configurate in Impostazioni Generative AI.
Crea un AI Model Azure OpenAI
Vai su Generative AI → AI Models e clicca su Nuovo Modello → Azure OpenAI.
Opzioni di configurazione
| Campo | Descrizione |
|---|---|
| Nome | Un nome univoco per identificare questo AI Model. |
| Key | La chiave API associata alla tua risorsa Azure OpenAI. |
| Endpoint | L'endpoint HTTPS della tua risorsa Azure OpenAI (es. https://<your-resource>.openai.azure.com/). |
| 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 nome del deployment del modello da usare. È il nome che hai assegnato al deployment in Azure, non il nome del modello sottostante. |
| 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.