Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

Иконы схем

Шаги схемы называются иконами. Термины пришли из визуального языка ДРАКОН.

  1. Шампур — вертикальная линия, на которую «насаживаются» иконы.
  2. Икона «Действие» — отдельный шаг схемы.
  3. Макро-икона — составная икона, внутри которой есть ветки и свои шампуры (условие, цикл).
  4. Валентная точка — место, куда можно вставить новую икону.
Шампур, икона, макро-икона и валентная точка

Каждая схема — это одна главная макро-икона. У функции вверху заголовок с названием, параметрами и типом результата, внизу — завершающий блок. Функцию вызывают другие схемы иконой «Вызов функции».

У триггера вверху — интеграция и событие, на которое он срабатывает (сообщение боту, вебхук, расписание), и имя переменной, в которой лежат данные события, например message. Подробнее — Интеграции.

Функция
  • Новая переменная — объявляет переменную: имя, тип и необязательное начальное значение. Переменная видна во всех шагах ниже по схеме.
  • Действие — произвольный код: присваивание, вызов, вычисление, например total = total + item.price.
  • Вызов функции — вызывает другую функцию проекта с параметрами и при желании сохраняет результат в новую переменную.
  • Лог — пишет строку в журнал запуска. Текст — шаблон, значения подставляются через ${…}.
  • Параллельно — несколько потоков, которые выполняются одновременно. Схема идёт дальше, когда закончились все.

Операции над списком, имя которого указывается в иконе: push и unshift добавляют элемент в конец или начало, pop и shift забирают последний или первый элемент в новую переменную, вставить вставляет элементы в середину, срез копирует часть списка в новую переменную.

Если — проверяет условие и направляет выполнение по ветке «Да» или «Нет». Обе ветки потом сходятся.

Икона «Если»

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

Икона «Переключатель»

Для каждого — проходит по списку: тело выполняется для каждого элемента.

Икона «Для каждого»

Цикл (от/до) — переменная-счётчик пробегает числа от начального значения до конечного. Пока — повторяет тело, пока выполняется условие.

Икона «Пока»

Цикл (псевдоцикл) — выполняется один раз. Нужен, чтобы внутри него можно было использовать выходы «Прервать» и «Продолжить»: например, выйти из середины последовательности или повторить её с начала.

Псевдоцикл

Иконы, которые меняют прямой ход схемы. Ставятся в конце ветки (см. Основы).

  1. Прервать — выйти из цикла.
  2. Продолжить — начать следующий проход цикла.
  3. Возврат — закончить функцию. В функции с результатом у иконы есть поле с возвращаемым значением; новый «Возврат» по умолчанию возвращает returnValue — переменную результата функции.
  4. Исключение — прервать выполнение с ошибкой. Запуск завершится с ошибкой, она появится в журнале.

Во вложенных циклах у «Прервать» и «Продолжить» есть номер: 1 — ближайший цикл, 2 — внешний и так далее.

Пауза останавливает сценарий на заданное время: число миллисекунд (его можно вычислить, например «за сутки до записи») или строка вроде '30 minutes', '1 day'. Во время паузы сервер не занят, а сама пауза переживает перезапуски — так делаются напоминания и отложенные сообщения. Как посчитать время до нужного момента, показано на странице Даты и время.

Комментарий — пояснение для читающего, нарисованное как лист с загнутым углом. В нём простой текст, на выполнение он не влияет.

В меню Интеграции — действия подключённых к проекту сервисов: отправить сообщение, вызвать ИИ, создать сделку, выполнить HTTP-запрос и так далее. Шаги-вопросы («Задать вопрос» в мессенджере, «AI Choice», задача для человека) выглядят как переключатель: у каждого варианта ответа своя ветка, и сценарий ждёт, пока выбор сделан. Так же выглядит «Ждать сообщение» — с двумя ветками: пришло сообщение или истёк таймаут. Подробнее — Интеграции.

Шаг, который вы пишете словами, а ИИ-агент собирает из него настоящие иконы. См. Магический узел.