Введение в Staqflow

Staqflow - облачная платформа автоматизации: CRM, мессенджеры, банки, маркетплейсы, код и AI-узлы в одном рантайме. Workflow собирается на канве или словами из вашего ИИ-клиента через MCP - это один и тот же процесс в пространстве.

Начало работы #

Отдельной установки нет: после входа вы сразу в редакторе. Личное пространство появляется при регистрации; дополнительные - когда нужна изоляция команд или проектов.

Staqflow MCP #

Подключите MCP-сервер Staqflow к Claude, ChatGPT, Cursor, Codex или GigaCode. Адрес сервера один - выберите вкладку и следуйте шагам. Ключ в файл класть не нужно: при первом обращении клиент откроет браузер, войдите в Staqflow так же, как в приложении. После входа клиент создаёт, меняет и запускает процессы в вашем пространстве.

1https://app.staqflow.ru/api/v1/mcp

Как пользоваться после подключения #

Пишите в клиенте обычным языком - инструменты Staqflow вызываются сами. Процесс появляется в пространстве, его можно открыть на канве и поправить.

Сама работа через MCP токены не тратит: собирать, менять и разбирать процессы можно на любом тарифе. Токены списываются только за запуски - в том числе за тестовые прогоны, которые клиент делает по вашей просьбе. Подробнее - в биллинге.

Два способа собрать workflow #

Результат всегда один: процесс в пространстве. Его видно в редакторе и можно править любым из двух способов.

Первый workflow за 3 минуты #

Пример: каждый час забрать новые заказы из PostgreSQL, собрать текст уведомления, отправить в Telegram.

На канве это четыре узла, соединённых линиями. Каждый узел - шаг: триггер, источник, преобразование, действие. Данные предыдущего шага можно подставить в следующий с канвы или из панели переменных. Свою логику пишут в узле Code.

1const orders = $input.all();
2
3return orders.map(o => ({
4  text: `Новый заказ № ${o.id} · ${o.total} ₽`,
5}));

Чтобы процесс ходил по расписанию сам, workflow нужно включить. Пока он выключен, доступен только ручной тестовый прогон.

Ключевые концепции #

Семь сущностей. Их достаточно, чтобы читать остальную документацию и собирать процессы - руками или из ИИ-клиента.

Пространство - контур, в котором живут workflow, подключения, переменные и команда. То, что создано в одном пространстве, в другом не видно. Роль задаёт, что вы можете делать внутри выбранного контура.

Зачем несколько пространств #

Одно пространство - одна рабочая зона. Так разделяют личные черновики, отдел продаж и прод, не смешивая процессы и ключи к сервисам.

В пространстве свои:

Текущее пространство выбирается вверху боковой панели. Дашборд, список процессов и подключения всегда относятся к нему.

Личное и общее #

Личное не мешает завести общие: переключились - и работаете в другом контуре. Список всех доступных вам пространств - на странице «Пространства».

Роли #

Роль действует только в этом пространстве. В другом у того же человека может быть другая.

Кто создал общее пространство, становится его владельцем. Владельца через приглашение назначить нельзя.

Приглашения #

В пространство коллег добавляет владелец или админ.

Пока приглашение не принято, в списке оно видно как «приглашён». Один человек может состоять в нескольких пространствах - в каждом со своей ролью.

Дашборд показывает, что сейчас происходит в пространстве: сколько процессов включено, как шли запуски, куда ушли токены. Это не список workflow и не страница оплаты.

Как открыть #

Пункт Дашборд в боковой панели. Переключили пространство - сводка другая: чужие контуры сюда не подмешиваются.

Если запусков ещё не было, вместо графика - пустой экран и кнопка Создать workflow. После первого прогона карточки и лента заполняются сами.

Мало токенов - сверху предупреждение. Что происходит при нуле - в биллинге.

Карточки #

Подзаголовок страницы напоминает: сводка по этому пространству, окно - последние 30 дней. Карточки считают по-разному.

«Активные» - включённые процессы: они сами реагируют на расписание и события. Выключенный workflow в этой карточке не считается, хотя в списке Workflow он есть.

Запуски #

График Запуски за 30 дней - сколько прогонов было в каждый день. Столбец можно выбрать: лента ниже сузится до этого дня. Повторный клик по тому же столбцу снимает фильтр.

Таблица Последние запуски: процесс, статус, время старта, длительность, расход токенов. Клик по строке открывает этот прогон на канве - как из шапки редактора, только здесь собраны запуски всех workflow пространства.

Разбор статусов и остановка прогона - в разделе запусков.

Расход #

Справа - процессы, которые за период съели больше всего токенов, и блок Потребление ресурсов (процессорное время, память, диск, сеть). Это нагрузка пространства, не счёт за тариф.

Полная картина оплаты - не здесь. Ссылка Вся статистика ведёт на биллинг: остаток, период тарифа, история начислений и платежей по аккаунту.

Наблюдатель видит сводку. Создавать процессы и пополнять баланс - роли выше, как в остальном пространстве.

Канва - визуальный редактор workflow. Процесс выглядит как узлы, соединённые линиями: слева событие, дальше шаги, справа действие. Тот же граф собирает ИИ-клиент через MCP - на холсте его можно поправить руками.

Как попасть на канву #

Редактор открывается из текущего пространства: пункт Workflow в боковой панели.

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

Из чего состоит редактор #

Пустой холст начинает с предложения поставить первый узел - обычно триггер.

Узлы и связи #

Узел - один шаг. Каталог делится на группы:

Связь тянется от точки на правом крае узла к левому краю следующего: так данные идут по цепочке. У условий появляется несколько выходов - по ним расходятся ветки.

1входящий запрос → http → условие
2                         ├ да → почта
3                         └ нет → telegram

Карточка узла #

Двойной клик по узлу открывает карточку.

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

Несохранённые правки на холсте остаются до «Сохранить». Если уйти со страницы без сохранения, редактор предупредит.

Сохранить и включить #

Это разные действия.

Включить может участник и выше. Наблюдатель видит холст, но не меняет и не запускает.

Запуски и история #

В шапке редактора две кнопки: Запуски - лента прогонов этого процесса, История - сохранённые версии схемы. Статусы, откуда берётся прогон и чем история отличается - в разделе запусков.

Файл #

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

Учётные данные - сохранённый вход во внешний сервис: бот, CRM, база, почта. Узел на канве не хранит пароль в своих полях: он ссылается на подключение пространства. Одно подключение можно повесить на несколько workflow.

Зачем они отдельные #

Ключ живёт в пространстве, а не в каждом узле. Сменили токен бота в одном месте - все процессы, которые на него ссылаются, ходят уже с новым.

Это не переменные. Переменные - общие значения вроде ставки НДС, их читают выражениями. Учётные данные - именно вход в сервис.

Как завести #

Два входа - результат один.

Дальше одинаково:

На узле #

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

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

В списке учётных данных колонка «Используется» показывает, в каких workflow висит это подключение - перед удалением её стоит посмотреть.

Системные #

Некоторые подключения помечены как системные: ими пользуются встроенные узлы. Их нельзя изменить или удалить. Для своих ботов и баз заводят обычные учётные данные.

Переменная - общее значение пространства: ставка, чат команды, порог суммы. Её один раз задают на странице «Переменные», а в любом workflow читают выражением. Поменять число в одном месте - и все узлы берут уже новое.

Зачем отдельно от узлов #

Один и тот же чат или лимит встречается в нескольких процессах. Если зашить его в каждый узел, правки разъедутся. Переменная общая на пространство: сменили здесь - видят все workflow этого контура. В соседнем пространстве своих переменных нет.

Это не учётные данные. Подключение входит в сервис. Переменная просто отдаёт значение в выражение.

Как завести #

Создают только на странице Переменные. С канвы новое значение не заводят - только подставляют уже существующее.

Тип выбирают сразу: от него зависит, как значение ведёт себя в выражениях (число складывается, строка склеивается).

В узле #

Откройте узел и в поле, куда нужно подставить значение, напишите $vars. и ключ - например $vars.vat. Если у поля есть переключатель «Выражение» - включите его, иначе это будет обычный текст, а не переменная. В узле Code пишут то же самое.

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

Если переменную удалить, выражения с её ключом перестанут её видеть: процесс сохранится, но на этом месте будет пусто.

Секрет #

У переменной можно включить «Секрет»: в списке значение прячут звёздочками. На запуске узлы всё равно читают его через $vars. Это чтобы не светить строку на экране, а не замена учётным данным.

Запуск - один прогон workflow: что пришло на каждый узел и чем закончилось. Это не версия схемы (она в «Истории»), а конкретный проход данных.

Откуда берётся прогон #

Выключенный workflow руками прогнать можно, сам он не стартует. Тестовый прогон с холста в списке помечен как «тест»: это проверка цепочки на ваших данных, не замена включению.

Где смотреть #

Клик по запуску открывает его на холсте: узлы подсвечены по этому прогону, схема не редактируется.

«История» рядом в шапке - сохранённые версии процесса. Их путают: история отвечает на «как выглядел граф», запуски - на «что произошло в этот раз». В режиме истории холст тоже только для просмотра.

В обоих случаях вернуться к правке - «Редактор» в шапке.

Статусы #

Пока статус «выполняется» или «в ожидании», в карточке запуска есть Остановить.

Токены #

Каждый прогон расходует токены: в ленте запуска видно, сколько ушло. Если баланс пуст, процессы не стартуют. Подробнее - в биллинге.

Наблюдатель видит запуски. Запускать и останавливать может участник и выше.

Биллинг - тариф, остаток и история в меню профиля. Запуски workflow оплачиваются токенами. Остаток виден и в боковой панели.

Токены #

Токен - единица расхода. Сколько ушло на прогон, видно в запусках, на дашборде пространства и на странице биллинга.

Баланс состоит из двух частей:

Сначала тратится начисление тарифа, потом купленный пакет - чтобы оплаченное не сгорело раньше бесплатного остатка.

Тарифы и пакеты #

Тариф выбирают на странице биллинга. Сейчас в каталоге: Старт (без оплаты), Про, Команда, Макс. Сколько токенов в месяц и цена - на этой же странице.

Не хватает внутри периода - докупают пакет S, M или L. Пакет сразу попадает на баланс и не привязан к дате сгорания тарифа.

Платную подписку можно отключить: тариф действует до конца уже оплаченного периода, дальше автосписаний не будет.

Если токенов мало #

Собрать и сохранить схему при нуле можно. Сами прогоны - нет, пока на балансе владельца снова не появятся токены.

Статистика и история #

На странице биллинга:

Поддержка - обращения в приложении: слева список, справа переписка. Ответ приходит в тот же чат, отдельная почтовая ветка не нужна.

Как написать #

Номер обращения появляется в списке. По нему и по теме можно искать.

Переписка #

Открытое обращение - чат. Сообщения поддержки приходят сюда же. Enter отправляет, Shift+Enter - новая строка.

Закрыть может и поддержка, и вы кнопкой «Закрыть обращение». Если тема всплыла снова - создайте новое, к закрытому чат не возвращается.

Чьи это обращения #

Список ваш: видны только тикеты, которые открыли вы, во всех пространствах сразу. Участники одного пространства чужие обращения не видят.