Nonli tarjoaa neljä Twig-apufunktiota tekstin tuottamiseen: gpt(), claude(), gemini() ja mistral(). Jokainen apufunktio ottaa vastaan kehotteen ja valinnaisen palveluntarjoajan mallitunnuksen:
1{{ gpt('Write one factual sentence.', 'gpt-5.6-luna') }}Jos jätät toisen argumentin pois, Nonli käyttää käyttöön otettua varamalliaan. Alla olevat valinnaiset esimerkit ovat harkittu lähtökohta, eivät Nonlin sallittujen luettelo: todelliset käyttöoikeudet, hinnat, alueet, käyttörajat ja käytöstä poistamisen päivämäärät riippuvat palveluntarjoajatilistäsi ja API-avaimestasi.
1. Nykyinen viitetaulukko#
| Palveluntarjoajan apufunktio | Nonlin käyttöön otettu varamalli, kun argumentti jätetään pois | Ajantasaiset yhteensopivat esimerkit | Elinkaariohje |
|---|---|---|---|
gpt() | gpt-4o | gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna | gpt-5.6 on liikkuva malliperheen alias; käytä nimettyä varianttia, kun tarvitset selkeämmän valinnan kyvykkyyden ja kustannusten välillä. |
claude() | claude-sonnet-4-5-20250929 | claude-fable-5, claude-opus-5, claude-sonnet-5, claude-haiku-4-5-20251001 | Anthropicin päiväyksettömät Claude 5 -tunnukset ovat kiinnitettyjä mallitunnuksia; päivätty Haiku-tunnus on nimenomainen tilannevedos. |
gemini() | gemini-3.7-flash | gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash | Suosi tuotannossa vakaita vaihtoehtoja. Esiversio- ja kokeelliset tunnukset voivat muuttua tai kadota lyhyemmällä varoitusajalla. |
mistral() | mistral-large-latest | mistral-medium-3-5, mistral-small-2603, mistral-large-2512 | latest on liikkuva alias; päivätyt tai versioidut tunnukset sopivat paremmin toistettavaan toimintaan. |
Varamallit kuvaavat Nonlin käyttöön otettua toimintaa, eivät kunkin palveluntarjoajan suosituksia. Jos palveluntarjoaja poistaa varamallin käytöstä tai avaimellasi ei voi käyttää sitä, anna malli, johon sinulla on pääsy, ja päivitä Smart Message -malli testauksen jälkeen.
2. Kopioitavat esimerkit#
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') }}Katso OpenAI:n virallinen mallikatalogi.
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') }}Katso Anthropicin virallinen mallien yleiskatsaus.
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') }}Katso Geminin virallinen mallikatalogi.
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') }}Katso Mistralin virallinen mallikatalogi.
3. Minkä tunnuksen kannattaa valita?#
- Jätä malli pois vain, jos hyväksyt sen, että Nonli saattaa päivittää varamallin, kun palveluntarjoaja poistaa mallin käytöstä.
- Käytä vakaata aliasta, kun haluat palveluntarjoajan hallinnoimat päivitykset ja pystyt regressiotestaamaan tuloksia ajan mittaan.
- Käytä kiinnitettyä tai versioitua tunnusta, kun toistettavuus on tärkeää, ja suunnittele sitten harkittu siirtymä ennen mallin käytöstä poistamista.
- Käytä esiversio- tai kokeellisia malleja vain hallituissa testeissä. Älä tee niistä tuotantoriippuvuutta ilman varamallia.
- Valitse vain teksti- tai viestinluontimalleja. Kuva-, ääni-, puhesynteesi-, upotus-, moderointi-, tekstintunnistus-, video- ja pelkästään agenteille tarkoitetut mallit eivät ole yhteensopivia näiden apufunktioiden kanssa.
Kun palveluntarjoajan tunnistetietoa ei ole saatavilla, apufunktio voi palauttaa tyhjän sisällön. Tiukemmissa suoritusympäristöissä puuttuva tai virheellinen token, mallin käyttöoikeuden puute, käyttörajan ylittyminen tai palveluntarjoajan virhe voi pysäyttää renderöinnin ja aiheuttaa virheen. Pidä tärkeissä Smart Message -malleissa aina deterministinen varavaihtoehto ja testaa samalla palveluntarjoajan tilillä, jota brändisi käyttää.
4. Jatka työnkulkua#
- Näin luot Smart Message -viestin
- Mitkä Twig-muuttujat ovat käytettävissä Nonlissa?, mukaan lukien se, miten kirjoitat heittomerkit kehotteessa
- Näin luot OpenAI-palvelun salaisen API-avaimen Nonlia varten
- Näin määrität ja testaat Publish Guard -ominaisuuden