🇬🇧 EN
🇮🇹 IT
Guida Utente / Impostazioni / Provider AI

3.1 Provider AI

I Provider AI sono le connessioni ai servizi di modelli linguistici di grandi dimensioni che alimentano i nodi Agent, Schema Extractor, Image Generation e i questionari AI Voice Call. Devi configurare almeno un provider prima di utilizzare qualsiasi nodo basato sull'AI nei tuoi workflow.

Pagina impostazioni Provider AI
Impostazioni → Provider AI — stato iniziale con il messaggio "Aggiungi il primo Provider". Una volta configurati, i provider appaiono come elenco in questa pagina.

Provider Supportati

Provider Nome driver Note
OpenAI openai GPT-4o, GPT-4 Turbo, o1 e tutti i modelli API di OpenAI.
Anthropic anthropic Famiglie di modelli Claude 3, Claude 3.5, Claude 4.
Ollama ollama Modelli locali self-hosted. Punta il Base URL alla tua istanza Ollama.
Qualsiasi API compatibile con OpenAI openai Funziona con Groq, Together AI, LM Studio, ecc. Imposta il Base URL sull'endpoint desiderato.

Aggiungere un Provider

  1. Apri le impostazioni Provider AI Naviga su Impostazioni → Provider AI nella barra laterale.
  2. Clicca "Nuovo Provider" Si apre un modulo modale sul lato destro dello schermo.
  3. Compila i dettagli del provider Completa i campi come descritto nella tabella seguente.
  4. Salva Clicca Salva Provider. Il nuovo provider apparirà immediatamente nell'elenco.
Modulo di aggiunta Provider AI
Modulo Aggiungi Provider AI — Nome visualizzato, Driver, Modello predefinito, Base URL, API Key, checkbox Funzionalità e opzione "Imposta come provider predefinito".

Riferimento Campi Provider

Campo Obbligatorio Descrizione
Nome Provider Obbligatorio Un'etichetta leggibile per questo provider (es. "OpenAI Produzione", "Ollama Locale"). Questo nome appare nei menu a tendina di configurazione dei nodi.
Driver Obbligatorio Il formato API utilizzato da questo provider. Scegli openai per OpenAI e API compatibili, anthropic per Anthropic, oppure ollama per Ollama.
Base URL Opzionale Sovrascrive l'endpoint API predefinito. Obbligatorio per modelli self-hosted (Ollama) o API compatibili di terze parti (es. http://localhost:11434 per Ollama). Lascia vuoto per gli endpoint standard di OpenAI o Anthropic.
API Key Condizionale La tua API Key segreta. Obbligatoria per i provider cloud (OpenAI, Anthropic). Non richiesta per istanze Ollama locali senza autenticazione. La chiave viene memorizzata in modo crittografato.
Modello Predefinito Obbligatorio L'identificativo del modello che verrà pre-selezionato quando aggiungi un nuovo nodo AI e scegli questo provider. Esempi: gpt-4o, claude-sonnet-4-6, llama3.2.
Imposta come Predefinito Opzionale Quando selezionato, questo provider viene automaticamente scelto nei nuovi nodi Agent. Solo un provider alla volta può essere predefinito; impostare un altro provider come predefinito deselezioni il precedente.

Funzionalità

Ogni provider può dichiarare le funzionalità che supporta. Le funzionalità appaiono come checkbox nel modulo del provider e come badge sulle schede dei provider.

Funzionalità Descrizione
Tool Calling Il modello può invocare strumenti/funzioni esterne. Necessario per i nodi Agent che utilizzano tool.
JSON Mode Il modello può produrre output JSON strutturato. Utilizzato da Schema Extractor e alcuni nodi Agent.
Vision Il modello può elaborare immagini. Necessario per i workflow che gestiscono immagini.
Voice Il modello è adatto ai questionari vocali. Quando selezionato, appaiono campi di configurazione aggiuntivi specifici per la voce (vedi sotto).

Impostazioni Voce

Quando la funzionalità Voice è abilitata, appare una sezione di configurazione aggiuntiva nel modulo del provider. Queste impostazioni controllano il comportamento del provider quando viene utilizzato per i questionari AI Voice Call.

Campo Descrizione
Voice Model Il modello da utilizzare per la classificazione delle risposte vocali. Se lasciato vuoto, utilizza il modello predefinito del provider. Considera l'uso di un modello veloce (es. gpt-4o-mini) per una latenza inferiore.
Supports Realtime Indica se il provider supporta I/O audio nativo (es. OpenAI Realtime API). Per uso futuro — attualmente tutta l'elaborazione vocale utilizza Twilio.
Transcription Strategy twilio (predefinito) — Twilio gestisce la conversione da parlato a testo. provider — riservato per la trascrizione nativa futura.
Synthesis Strategy twilio (predefinito) — Twilio gestisce la conversione da testo a parlato. provider — riservato per la sintesi nativa futura.
Parsing Mode Come l'AI classifica le risposte parlate: classifier_prompt (predefinito, usa un prompt di classificazione), direct_structured, oppure hybrid.
Default Turn Timeout Secondi predefiniti di attesa per la risposta del chiamante prima di riproporre la domanda. Può essere sovrascritto per questionario nelle impostazioni del canale Voice Call.
Provider AI con funzionalità voce
Pagina impostazioni Provider AI — mostra le schede dei provider con badge delle funzionalità, inclusa Voce.

Modifica ed Eliminazione dei Provider

Per modificare un provider, clicca l'icona Modifica (matita) accanto ad esso nell'elenco. Si apre lo stesso modulo con i valori esistenti pre-compilati. Modifica qualsiasi campo e clicca Salva Provider.

Per eliminare un provider, clicca l'icona Elimina (cestino). Apparirà un messaggio di conferma. Nota che l'eliminazione di un provider non lo rimuove dalle configurazioni dei nodi dei workflow esistenti — quei nodi semplicemente falliranno nell'esecuzione fino a quando non li aggiorni con un provider valido.

Prima di eliminare un provider: Cerca nei tuoi workflow eventuali nodi Agent, Schema Extractor, Image Generation o Voice Call configurati per usare quel provider, e aggiornali prima.

Esempi di Configurazione Comuni

OpenAI

Anthropic Claude

Ollama Locale

Suggerimento: Puoi registrare più provider e passare dall'uno all'altro per ogni nodo. Ad esempio, usa GPT-4o per gli agenti critici e un modello Ollama locale per attività di classificazione leggere, riducendo così i costi.
← Impostazioni Posta SMTP →