Docs

Engine Builder

The Engine Builder is where you design a conversation visually. You lay out phases on a canvas, fill them with cards, wire logic gates between them, and choose where the chat begins. This is the full reference.

Движок — это разговор, спроектированный как схема. Вы собираете его на холсте из нескольких деталей, тестируете в симуляторе, а затем публикуете. Эта страница описывает каждую часть конструктора. Если вы совсем новичок, сначала пробегитесь по разделу Персоны : любой движок работает от лица персоны.

Основные понятия

Несколько слов встречаются в конструкторе повсюду. Усвойте их — и остальное встанет на место.

  • Фаза: этап разговора. Фаза — это первое сообщение (то, как AI начинает этот этап) плюс колода карточек, которые он может разыграть, пока разговор находится в этой фазе. У типичного движка несколько фаз: холодное открытие, разогрев, приглашение.
  • Колода: набор карточек, прикреплённых к фазе. На каждом ходу движок разыгрывает одну карточку из колоды, выбранную взвешенным случайным броском, поэтому одна и та же фаза каждый раз звучит по-разному.
  • Карточка: один ход: поболтать, задать вопрос, отправить фото, вбросить ссылку, свернуть разговор. У каждой карточки свои настройки (см. справочник карточек ниже).
  • Шлюз / переход: правило, которое переводит разговор из одной фазы в другую или вызывает реакцию. Одни шлюзы стоят в линию между двумя фазами; другие «плавают» и наблюдают за всем разговором.
  • Факт: деталь, которую движок узнаёт о лиде (имя, город, интересы). Факты извлекаются из чата по ходу дела и могут подставляться обратно в сообщения через тег.
  • Точки старта: узлы, которые задают, с чего начинается разговор: AI пишет первым, пользователь пишет первым или срабатывает внешнее событие.
  • Плавающие наблюдатели: шлюзы, не привязанные к двум конкретным фазам. Они следят за всем разговором и срабатывают, как только выполняется их условие (например, появился факт или лид принял ссылку).

Холст

Конструктор — это масштабируемый холст из узлов, соединённых рёбрами. Вы перетаскиваете детали сбоку, бросаете карточки на фазы и проводите линии, чтобы связать поток.

Палитра узлов

  • Старт: узлы начала разговора (AI-открытие, Входящее сообщение, Триггер события).
  • Фазы: добавляет на холст новый узел фазы.
  • Правила: логические шлюзы и наблюдатели, которых вы связываете между фазами или вокруг них.

Библиотека карточек

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

Связывание рёбрами

Потяните от выходной точки одного узла к другому, чтобы создать ребро. Именно рёбра позволяют точке старта дойти до первой фазы, а шлюзам — двигать чат дальше.

Авторасклад

Схемы, собранные вручную, быстро превращаются в кашу. Кнопка Авторасклад (палочка в правом верхнем углу холста потока) заново раскладывает весь граф в аккуратную схему слева направо, без наложений, и подгоняет под экран. Новые позиции сохраняются вместе с движком. Прогоняйте её перед тем, как считать движок готовым.

Типы карточек

Карточки — это ходы, которые движок может сделать внутри фазы. Вот встроенные типы, под их названиями из библиотеки:

  • Свободный разговор (CHAT): произвольное сообщение. Это единственная карточка, которая полностью учитывает ваши собственные «Инструкции», поэтому именно она — рабочая лошадка для управления формулировками.
  • Fact Finder (PROBE): спрашивает про очередной недостающий факт, автоматически целясь в ту деталь, которой движку ещё не хватает.
  • Отправить фото (PHOTO): отправляет самое подходящее фото из хранилища персоны, выбранное автоматически по описанию каждого снимка.
  • Фото-подтверждение (VERIFICATION): просит лида прислать подтверждающее / проверочное фото себя.
  • Вбросить ссылку (LINK_DROP): вбрасывает вашу ссылку воронки. Требует URL воронки, заданный в глобальных настройках.
  • Завершить (CLOSE): подводит итог и завершает разговор.
  • Отреагировать (REACT), Подразнить / пофлиртовать (TEASE), Открыться (SHARE), Поддержать тему (RELATE): короткие встроенные ходы, благодаря которым разговор ощущается живым. См. подвох ниже: эти четыре выдают фиксированную фразу.

Обратите внимание

«Отреагировать», «Подразнить / пофлиртовать», «Открыться» и «Поддержать тему» выдают фиксированную встроенную фразу и игнорируют поле «Инструкции». Всё, что вы впишете в эти четыре карточки (и любые теги), не используется. Если нужна своя формулировка, возьмите вместо них карточку Свободный разговор .

Шлюзы и переходы

Шлюзы решают, когда разговор идёт дальше или реагирует. Есть две формы: линейные счётчики , вставленные между двумя фазами, и плавающие наблюдатели , которые следят за всем чатом.

Линейный счётчик

  • После N сообщений (MESSAGE_COUNT): включается по схеме фаза → шлюз → фаза. Он считает ходы и двигает разговор дальше, как только порог достигнут. Порог — 1–20. Это стандартный способ провести чат через его фазы.

Плавающие наблюдатели

  • Проверка факта (FACT_EXISTS): срабатывает, когда из разговора извлечён конкретный факт.
  • Проверка конверсии (CONVERSION_CHECK): срабатывает в зависимости от того, принял лид последнюю вброшенную ссылку или отверг.
  • Детектор сигнала (DETECTOR): внутренний наблюдатель, на котором держится защита от обвинений в том, что это бот. В палитре его нет; вы не размещаете его сами.

Точки старта

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

  • AI-открытие / первый контакт: AI отправляет первое сообщение (холодный контакт). Подходит для воронок, где вы выходите на связь первыми.
  • Входящее сообщение / По умолчанию: пользователь пишет первым (обычное входящее личное сообщение). У движка должен быть ровно один старт типа «Входящее сообщение / По умолчанию».
  • Триггер события: начинает чат, когда срабатывает конкретное внешнее событие. Ему нужен id события (например, story_reaction).
  • Напоминание: возвращает в разговор лида, который замолчал.

Обратите внимание

В AI-открытии теги промптов не подставляются. Набранный там {name} отобразится лиду буквально. Пишите AI-открытие обычными словами.

Факты и вкладка «Знания»

На вкладке Знания вы управляете фактами, которые собирает движок. Их два вида:

  • Системные факты: встроенные детали, которые движок всегда старается выяснить (например, имя и местоположение лида).
  • Свои факты: ваши собственные поля, специфичные для вашей воронки.

Каждый факт привязан к фазе: то есть к этапу, на котором движок должен постараться его выяснить. Карточка Fact Finder затем гонится за тем фактом, которого в текущей фазе всё ещё не хватает.

Обратите внимание

Каждый факт принадлежит ровно одной фазе. Если вы хотите, чтобы движок узнавал что-то на другом этапе, перенесите факт. Назначить его сразу двум фазам нельзя.

Инспектор узла

Нажмите на любой узел, чтобы открыть инспектор справа. Что именно можно править, зависит от узла, но общие поля такие:

  • Инструкции / директива: указания обычным языком о том, что должен сделать AI. На карточке они управляют сообщением; на фазе описывают её назначение. (Помните: четыре быстрые карточки их игнорируют.)
  • Открытие фазы: первое сообщение фазы: как AI начинает разговор, попадая на этот этап.
  • Лимит использований (0–20): максимальное число раз, которое карточку можно сыграть за разговор. 0 означает без ограничений.
  • Пауза между использованиями: сколько ходов подождать, прежде чем карточку можно сыграть снова, чтобы она не повторялась подряд.

Теги для промптов

Внутри «Инструкций» карточки можно набрать тег , и движок подставит настоящее значение перед отправкой сообщения. Доступные теги:

Детали персоны

  • {name}: имя персоны
  • {age}: возраст персоны
  • {origin}: откуда персона родом
  • {city}: город персоны
  • {job}: работа персоны
  • {hobbies}: хобби и интересы персоны
  • {bio}: биография персоны
  • {style_tags}: черты манеры письма персоны
  • {time}: текущее время суток, чтобы персона звучала по-утреннему или по-вечернему

Ваша воронка

  • {platform}: приложение, в котором идёт переписка
  • {funnel_platform}: ваша площадка воронки или назначения

Действия

  • {photo}: отправляет самое подходящее фото из хранилища, выбранное автоматически по описанию
  • {link}: вставляет вашу ссылку конверсии с обходом фильтров

Зависит от карточки

  • {fact}: на карточке Fact Finder: следующая деталь, которую нужно выяснить о лиде
  • {vibe}: на карточке «Отправить фото»: текущее настроение фото, спокойное или дерзкое
  • {context}: на карточке входа / открытия: входящее первое сообщение, на которое реагирует открытие

Глобальные настройки и «Личность»

Настройки, действующие на весь движок, находятся на вкладке «Личность / глобальные настройки»:

  • Платформа для сообщений: приложение, в котором идёт разговор (питает тег {platform} ).
  • Лимит ходов (1–100, по умолчанию 60): максимальное число ходов, после которого разговор останавливается.
  • Максимум пузырей сообщения (1–5): на сколько отдельных пузырей можно разбить один ответ.
  • Площадка воронки: ваша целевая площадка (питает {funnel_platform}).
  • URL воронки: ссылка, которую отправляет карточка «Вбросить ссылку».
  • Маскировка ссылки: применяется автоматически при вбросе ссылки, чтобы обойти фильтры ссылок.
  • Ценность лида: сколько стоит сконвертированный лид; аналитика использует это, чтобы оценить выручку.

Отказы и защита от «ты бот»

Вы можете прописать, как движок ведёт себя в неловкие моменты: когда лид упирается или обвиняет AI в том, что это бот. Каждый сценарий связывает триггер с ответом, которым может быть текст или картинка, чтобы разговор красиво выкрутился, а не встал.

Проверка и публикация

Конструктор проверяет ваш движок по ходу работы и показывает замечания в панели «Проблемы». Важны два уровня:

  • Ошибки блокируют публикацию. Опубликовать движок, не прошедший проверку, нельзя.
  • Сохранение блокируют только ошибки жёстких лимитов. Незаконченную работу с более мягкими замечаниями можно сохранить и вернуться к ней позже.
  • Панель «Проблемы» перепрыгивает к узлу , когда вы нажимаете на замечание, чтобы исправить его на месте.

Обратите внимание

У фазы должна быть хотя бы одна карточка и первое сообщение. Пустая фаза не пройдёт проверку.

Обратите внимание

Шлюзы и стартовые узлы переименовать нельзя. Своё имя принимают только фазы и триггеры событий : всё остальное пусть конструктор называет сам.

Обратите внимание

Для публикации в Marketplace проверка должна быть полностью чистой: это строже, чем сохранение. Устраните каждую ошибку в панели «Проблемы», прежде чем публиковать.

Операции с движками и Marketplace

  • Новый: начать новый движок с чистого холста.
  • Копировать (клонировать): продублировать существующий движок, чтобы дорабатывать, не трогая оригинал.
  • Переименовать: переименовать один из своих движков.
  • Удалить: убрать движок, которым вы владеете.
  • Опубликовать / снять публикацию: поделиться чистым движком в Marketplaceили забрать его обратно.

Дальнейшие шаги

Движок собран — можно пускать его в дело. Почитайте про персону, от лица которой он работает, в разделе Персоны, начните с проверенной воронки в шаблонах Marketplace, прогоните вхолостую в разделе Тестирование и симулятори подключите в бою по инструкции Запуск.

Engine Builder: FluidTalk Documentation | FluidTalk