🇮🇹 IT

⚙️ Model Config

Un nodo di configurazione — non eseguito — che specifica quale modello AI e provider un nodo Agent utilizza in modalità grafo. Collega il suo arco di output alla porta model_in di un nodo Agent. Ogni nodo Agent in modalità grafo richiede esattamente una connessione Model Config.

Categoria: AI & Agenti · Identificatore tipo: model_config · Solo modalità grafo

Panoramica

In modalità grafo, il modo in cui un nodo Agent ottiene le impostazioni del modello è diverso dalla modalità lineare. Invece di configurare provider, modello, temperatura e limite di token direttamente nel pannello del nodo Agent, crei un nodo Model Config separato e disegni un arco da esso all'Agent.

Questa separazione ha diversi vantaggi:

Chiarezza — il canvas del grafo mostra a colpo d'occhio quale modello usa ogni agente, senza dover aprire il pannello di ogni nodo.
Riutilizzabilità — puoi collegare lo stesso Model Config a più nodi Agent, assicurandoti che usino tutti le stesse impostazioni senza duplicare la configurazione.
Intercambiabilità — cambiare il modello per tutti gli agenti collegati è una singola modifica in un solo punto.

Il nodo Model Config non porta stato e non produce output a runtime. È puramente un contenitore di configurazione. Quando il workflow viene eseguito, Flusso legge le impostazioni del modello dal nodo Model Config collegato e le applica all'Agent prima della sua esecuzione.

Requisito modalità grafo: Ogni nodo Agent in modalità grafo deve avere esattamente un nodo Model Config collegato alla sua porta model_in. Se questa connessione manca, il workflow fallirà la validazione pre-esecuzione prima che qualsiasi step venga eseguito.

Configurazione

Campo	Stato	Descrizione
Provider	Obbligatorio	Seleziona uno dei tuoi Provider AI configurati. Puoi aggiungere provider in Impostazioni → Provider AI. Il provider deve supportare il modello che inserisci qui sotto.
Modello	Obbligatorio	La stringa identificativa del modello, ad esempio `gpt-4o`, `claude-sonnet-4-6`, `llama3.2` o `mistral-large`. Deve corrispondere esattamente al nome del modello accettato dal tuo provider.
Temperatura	Opzionale	Controlla la casualità della risposta su una scala da 0 a 2. Valori bassi (0–0.3) producono output coerenti e precisi. Valori più alti (0.7–1.5) producono risposte più varie e creative. Il valore predefinito è 0.7.
Max Token	Opzionale	Il numero massimo di token che il modello può generare nella sua risposta. Lascia vuoto per usare il valore predefinito del modello. Impostare un valore aiuta a controllare la lunghezza della risposta e a gestire i costi API.

Dati di Output

Nessun output a runtime. Il nodo Model Config non viene eseguito e non produce alcun campo di output. Trasporta solo dati di configurazione. Non puoi fare riferimento a {{ model_config.output.* }} in altri step.

Esempio di Utilizzo

Collegare un Model Config a un Agent in modalità grafo

Apri l'editor grafo e aggiungi un nodo Model Config. Trovalo nella barra laterale dei nodi sotto AI & Agenti. Trascinalo sul canvas vicino al nodo Agent che servirà.
Configura il nodo. Apri il pannello del Model Config cliccando sul nodo. Seleziona il tuo Provider (es. OpenAI), inserisci il Modello (es. gpt-4o) e imposta la Temperatura su 0.2 per un assistente fattuale e coerente.
Disegna il collegamento. Clicca sulla porta di output del nodo Model Config e trascina fino alla porta model_in (M) del nodo Agent. La porta è contrassegnata con un piccolo indicatore M sulla scheda dell'agente.
Salva il workflow. Il nodo Agent utilizzerà ora le impostazioni del Model Config collegato a runtime. Se cambi il modello nel nodo Model Config, tutti gli agenti collegati vengono aggiornati.

Condividere un Model Config tra più agenti

Se il tuo workflow ha diversi nodi Agent che devono tutti usare lo stesso modello, ti basta un solo nodo Model Config. Disegna archi da quel singolo Model Config alla porta model_in di ogni Agent. Cambiare la temperatura o il modello in un solo punto li aggiorna tutti simultaneamente.

Suggerimenti e Note

Un Model Config per Agent. Ogni nodo Agent accetta esattamente una connessione model_in. Non puoi collegare due nodi Model Config diversi allo stesso agente. Se vuoi che due agenti usino modelli diversi, crea due nodi Model Config separati.
Gli identificatori dei modelli sono case-sensitive. Inserisci il nome del modello esattamente come il tuo provider lo richiede. Consulta la documentazione del tuo provider per le stringhe identificative corrette.
Questo nodo è l'equivalente della modalità lineare. In modalità lineare, i campi provider, modello, temperatura e max token appaiono direttamente nel pannello del nodo Agent. Model Config è l'equivalente in modalità grafo di quei campi — stesse impostazioni, formato diverso.

Nodi Correlati

Agent — il nodo che questo Model Config configura.
Memory — collega un backend di memoria a un nodo Agent in modalità grafo.
MCP Tool — collega strumenti esterni a un nodo Agent in modalità grafo.