Gemini: gerar texto

Use o Gemini: gerar texto para pedir a um modelo Google Gemini um pequeno trecho de texto no meio da jornada e depois reutilizá-lo em um push, e-mail ou SMS posterior. Este ponto se autentica com sua própria chave de API do Gemini. Ele não usa nenhuma integração em nível de conta configurada em outro lugar nas Configurações.

Usos típicos:

• Personalizar uma linha de mensagem: elabore um gancho de uma linha a partir das tags de um viajante e depois insira-o no próximo push ou e-mail com Conteúdo Dinâmico.
• Resumir antes de enviar: transforme algumas tags, como último pedido ou categoria de navegação, em uma linha curta em linguagem natural que um modelo possa exibir.
• Variar a redação: peça uma formulação ligeiramente diferente em cada execução para que os viajantes não vejam o mesmo texto todas as vezes que passarem por aqui.

Configurar o ponto

1. Arraste o Gemini: gerar texto da seção Integrações do painel esquerdo para a tela.
2. Clique duas vezes no ponto e insira um Nome da Etapa.
3. Em Chave de API do Gemini, insira sua chave de API do Gemini. Ela é armazenada mascarada, como um cabeçalho secreto de webhook.

4. Em Modelo, escolha o modelo Gemini a ser usado. O padrão é gemini-2.5-flash-lite.

   • gemini-2.5-flash-lite: o padrão.
   • gemini-2.5-flash: custa mais por token do que o Flash Lite.

   O Gemini 2.5 Pro não é oferecido aqui: ele não pode desativar sua própria etapa de raciocínio, portanto, não há garantia de que terminará dentro do tempo limite de 10 segundos do ponto.

   Cada chamada cobra sua própria chave do Gemini para cada viajante que chega a esta etapa.

5. Em Prompt, escreva o que você quer que o modelo gere. Ele aceita as mesmas macros que qualquer corpo de Webhook, por exemplo, {{device:hwid}}.

6. Clique em Salvar.

O raciocínio é desativado e as respostas são limitadas a cerca de 300 tokens (aproximadamente um parágrafo curto) para manter a solicitação dentro do tempo limite do Webhook. Peça algo tão curto. Um prompt mais longo ou mais detalhado não terá mais espaço para responder.

Resposta

O viajante continua para qualquer etapa que você conectar a seguir na tela.

Atributos após a execução da etapa

Atributo	O que contém
llm_text	O texto gerado
llm_input_tokens	Contagem de tokens para a entrada da solicitação
llm_output_tokens	Contagem de tokens para a saída da solicitação

Como usar llm_text em etapas posteriores

• Inseri-lo em um push, e-mail ou SMS: use Conteúdo Dinâmico.
• Ramificar com base nele com Divisão de condição: salve-o primeiro em uma Tag com Atualizar perfil do usuário e depois divida com base nessa Tag.

Falhas e respostas inesperadas

Uma solicitação com falha remove o viajante da jornada. Consulte Erros e solicitações com falha.

Uma resposta que retorna, mas não é o que você esperava, mantém o viajante na jornada:

• Texto cortado no limite de 300 tokens: llm_text contém o texto truncado.
• Modelo se recusou a responder: llm_text contém o que quer que ele tenha respondido em vez disso.

Cenário de exemplo: Elaborando uma dica de acompanhamento de pedido em SMS com o Gemini

Uma equipe deseja que um SMS de confirmação de pedido inclua uma dica curta e específica do produto sobre cuidados, em vez de apenas o número do pedido.

1. Adicione o Gemini: gerar texto logo após a etapa que confirma o pedido. Em Prompt, escreva Write one short care tip for someone who just bought {{tag:Last Purchased Category}}.
2. Adicione uma etapa Enviar SMS logo depois, usando Conteúdo Dinâmico para inserir llm_text no texto do SMS.

Depois que isso for executado, cada confirmação de pedido incluirá uma dica relevante para o que o viajante comprou, em vez da mesma linha para todos os pedidos.