Gemini: сгенерировать текст

Используйте элемент Gemini: сгенерировать текст, чтобы запросить у модели Google Gemini короткий фрагмент текста в середине Journey, а затем повторно использовать его в последующих push-уведомлениях, email или SMS. Этот элемент аутентифицируется с помощью собственного ключа API Gemini. Он не использует интеграцию на уровне аккаунта, настроенную в других разделах Настроек.

Типичные варианты использования:

• Персонализация строки сообщения: создайте однострочный «крючок» на основе тегов пользователя, а затем вставьте его в следующее push-уведомление или email с помощью Dynamic Content.
• Краткое изложение перед отправкой: превратите несколько тегов, таких как последний заказ или категория просмотра, в короткую строку на естественном языке, которую сможет отобразить шаблон.
• Изменение формулировок: запрашивайте немного другую формулировку при каждом запуске, чтобы пользователи не видели одинаковый текст каждый раз, когда проходят через этот этап.

Настройка элемента

1. Перетащите элемент Gemini: сгенерировать текст из раздела Интеграции на левой панели на холст.
2. Дважды щелкните элемент и введите Название шага.
3. В поле Ключ API Gemini введите ваш ключ API Gemini. Он хранится в замаскированном виде, как секретный заголовок webhook.

4. В поле Модель выберите модель Gemini для использования. По умолчанию используется gemini-2.5-flash-lite.

   • gemini-2.5-flash-lite: модель по умолчанию.
   • gemini-2.5-flash: стоит дороже за токен, чем Flash Lite.

   Gemini 2.5 Pro здесь не предлагается: эта модель не может отключить собственный этап рассуждений, поэтому нет гарантии, что она завершит работу в течение 10-секундного тайм-аута элемента.

   Каждый вызов оплачивается с вашего ключа Gemini за каждого пользователя, который достигает этого шага.

5. В поле Промпт напишите, что вы хотите, чтобы модель сгенерировала. Поле поддерживает те же макросы, что и тело любого Webhook, например {{device:hwid}}.

6. Нажмите Сохранить.

Рассуждения отключены, а ответы ограничены примерно 300 токенами (примерно короткий абзац), чтобы запрос укладывался в тайм-аут Webhook. Запрашивайте что-то короткое. Более длинный или подробный промпт не получит больше места для ответа.

Ответ

Пользователь переходит к следующему шагу, который вы подключите на холсте.

Атрибуты после выполнения шага

Атрибут	Что содержит
llm_text	Сгенерированный текст
llm_input_tokens	Количество токенов на входе запроса
llm_output_tokens	Количество токенов на выходе запроса

Как использовать llm_text на последующих шагах

• Вставьте его в push-уведомление, email или SMS: используйте Dynamic Content.
• Создайте ветвление на его основе с помощью Condition split: сначала сохраните его в Tag с помощью Update user profile, а затем создайте ветвление по этому Tag.

Сбои и неожиданные ответы

Неудачный запрос удаляет пользователя из Journey. См. Ошибки и неудачные запросы.

Ответ, который вернулся, но не соответствует вашим ожиданиям, оставляет пользователя в Journey:

• Текст обрезан по лимиту в 300 токенов: llm_text содержит усеченный текст.
• Модель отказалась отвечать: llm_text содержит тот ответ, который она дала вместо ожидаемого.

Пример сценария: создание совета по заказу в SMS с помощью Gemini

Команда хочет, чтобы SMS с подтверждением заказа содержало короткий совет по уходу за конкретным товаром, а не просто номер заказа.

1. Добавьте элемент Gemini: сгенерировать текст сразу после шага, подтверждающего заказ. В поле Промпт напишите Напиши один короткий совет по уходу для того, кто только что купил {{tag:Last Purchased Category}}.
2. Сразу после него добавьте шаг Отправить SMS, используя Dynamic Content, чтобы вставить llm_text в текст SMS.

После запуска этой схемы каждое подтверждение заказа будет включать совет, соответствующий тому, что купил пользователь, вместо одной и той же строки для каждого заказа.