Usare le funzionalità di generazione di messaggi con l'IA

Nonli espone quattro helper Twig per la generazione di testo: gpt(), claude(), gemini() e mistral(). Ogni helper accetta un prompt e, facoltativamente, l'ID di un modello del provider:

1{{ gpt('Write one factual sentence.', 'gpt-5.6-luna') }}

Se ometti il secondo argomento, Nonli usa il fallback in produzione. Gli esempi facoltativi riportati sotto sono un punto di partenza selezionato, non un elenco di modelli consentiti da Nonli: accesso, prezzi, regioni, limiti di frequenza e date di ritiro effettivi dipendono dal tuo account provider e dalla tua chiave API.

1. Riferimento attuale#

I fallback descrivono il comportamento di Nonli in produzione, non la raccomandazione di ciascun provider. Se un provider ritira un fallback o la tua chiave non può usarlo, passa un modello a cui hai accesso e aggiorna il template dopo averlo testato.

2. Esempi da copiare#

2.1. OpenAI#

1{# Omitted model: Nonli uses gpt-4o #}
2{{ gpt('Return only a neutral, factual headline.') }}
3
4{# Explicit current model #}
5{{ gpt('Return only a neutral, factual headline.', 'gpt-5.6-luna') }}

Consulta il catalogo ufficiale dei modelli OpenAI.

2.2. Anthropic Claude#

1{# Omitted model: Nonli uses claude-sonnet-4-5-20250929 #}
2{{ claude('Return only a neutral, factual headline.') }}
3
4{# Explicit current model #}
5{{ claude('Return only a neutral, factual headline.', 'claude-sonnet-5') }}

Consulta la panoramica ufficiale dei modelli Anthropic.

2.3. Google Gemini#

1{# Omitted model: Nonli uses gemini-3.7-flash #}
2{{ gemini('Return only a neutral, factual headline.') }}
3
4{# Explicit stable model #}
5{{ gemini('Return only a neutral, factual headline.', 'gemini-3.6-flash') }}

Consulta il catalogo ufficiale dei modelli Gemini.

2.4. Mistral AI#

1{# Omitted model: Nonli uses mistral-large-latest #}
2{{ mistral('Return only a neutral, factual headline.') }}
3
4{# Explicit versioned model #}
5{{ mistral('Return only a neutral, factual headline.', 'mistral-medium-3-5') }}

Consulta il catalogo ufficiale dei modelli Mistral.

3. Quale ID scegliere?#

• Usa il modello omesso solo se accetti che Nonli possa aggiornare il fallback dopo il ritiro di un modello da parte del provider.
• Usa un alias stabile quando vuoi gli aggiornamenti gestiti dal provider e sei in grado di testare nel tempo la regressione dell'output.
• Usa un ID fissato o con versione quando la riproducibilità è importante, poi pianifica una migrazione ponderata prima del ritiro.
• Usa i modelli in anteprima o sperimentali solo in test controllati. Non farne una dipendenza di produzione senza un fallback.
• Seleziona solo modelli di testo o di generazione di messaggi. I modelli per immagini, audio, TTS, embedding, moderazione, OCR, video e i modelli solo per agenti non sono compatibili con questi helper.

Quando non è disponibile alcuna credenziale del provider, un helper può non restituire alcun contenuto. In contesti di esecuzione più rigorosi, un token mancante o non valido, un modello inaccessibile, un limite di frequenza o un errore del provider possono interrompere il rendering con un errore. Mantieni sempre un fallback deterministico nei template importanti e testa con lo stesso account provider usato dal tuo brand.

4. Continua il flusso di lavoro#

• Creare e testare uno Smart Message
• Quali variabili Twig sono disponibili in Nonli?, compreso come scrivere gli apostrofi in un prompt
• Creare una chiave API segreta OpenAI per Nonli
• Configurare e testare Publish Guard