Utilizar as funcionalidades de geração de mensagens com IA

A Nonli disponibiliza quatro helpers Twig para geração de texto: gpt(), claude(), gemini() e mistral(). Cada helper aceita um prompt e um ID de modelo opcional do fornecedor:

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

Se omitir o segundo argumento, a Nonli utiliza o modelo de recurso implementado. Os exemplos opcionais abaixo são um ponto de partida selecionado, não uma lista de modelos autorizados pela Nonli: o acesso efetivo, os preços, as regiões, os limites de pedidos e as datas de descontinuação dependem da sua conta no fornecedor e da sua chave API.

1. Referência atual#

Os modelos de recurso descrevem o comportamento implementado da Nonli, não a recomendação de cada fornecedor. Se um fornecedor descontinuar um modelo de recurso ou se a sua chave não o puder utilizar, indique um modelo a que tenha acesso e atualize o modelo de mensagem depois de o testar.

2. Exemplos para copiar#

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') }}

Consulte o catálogo oficial de modelos da 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') }}

Consulte a apresentação oficial dos modelos da 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') }}

Consulte o catálogo oficial de modelos 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') }}

Consulte o catálogo oficial de modelos da Mistral.

3. Que ID deve escolher?#

• Omita o modelo apenas se aceitar que a Nonli possa atualizar o modelo de recurso após uma descontinuação por parte do fornecedor.
• Utilize um alias estável quando pretender atualizações geridas pelo fornecedor e puder fazer testes de regressão aos resultados ao longo do tempo.
• Utilize um ID fixo ou com versão quando a reprodutibilidade for importante e planeie uma migração deliberada antes da descontinuação.
• Utilize modelos de pré-visualização ou experimentais apenas em testes controlados. Não os torne uma dependência de produção sem um modelo de recurso.
• Selecione apenas modelos de geração de texto ou de mensagens. Os modelos de imagem, áudio, TTS, embeddings, moderação, OCR, vídeo e os modelos exclusivos para agentes não são compatíveis com estes helpers.

Quando não existe nenhuma credencial do fornecedor disponível, um helper pode não devolver conteúdo. Em contextos de execução mais estritos, um token em falta ou inválido, um modelo inacessível, um limite de pedidos ou um erro do fornecedor podem interromper a renderização com um erro. Mantenha sempre uma alternativa determinística nos modelos de mensagem importantes e teste com a mesma conta de fornecedor utilizada pela sua marca.

4. Continuar o fluxo de trabalho#

• Criar e testar um Smart Message
• Que variáveis Twig estão disponíveis na Nonli?, incluindo como escrever apóstrofos num prompt
• Criar uma chave API da OpenAI para a Nonli
• Configurar e testar o Publish Guard