Fuse: каталог сценариев поверх чужих программных интерфейсов, или что делать, когда "просто дёрни ручку" - это не просто

Всем привет. Мы - небольшая команда, и последние несколько недель мы строили Fuse: платформу, где из любых открытых программных интерфейсов можно собрать готовый сценарий и выложить его в каталог, чтобы им пользовался человек, который слова "программный интерфейс" никогда не слышал. В этом посте расскажу, зачем мы это делаем, как оно устроено внутри, и попрошу у вас обратной связи - проект на той стадии, когда критика полезнее похвалы.

Ситуация, знакомая, наверное, каждому, кто работал в компании крупнее пяти человек. Приходит коллега из соседнего отдела: "Слушай, а можно как-то распознать вот эти сканы? Я видел, у сервиса X есть API". Можно. Нужно зарегистрироваться, получить ключ, прочитать документацию, понять, что распознавание там асинхронное - сначала загружаешь файл, потом опрашиваешь статус, потом забираешь результат. Написать скрипт. Отдать коллеге. Через неделю скрипт сломался, потому что коллега запустил его не с той версией питона.

И так каждый раз. API-сервисов вокруг сотни - распознавание документов, синтез речи, проверка контрагентов, геокодинг, что угодно. Но между "у сервиса есть API" и "обычный человек получил результат" лежит пропасть: кто-то должен написать обвязку, где-то её захостить, как-то дать к ней доступ.

Zapier и n8n эту пропасть частично закрывают, но они про автоматизацию для себя: собрал пайплайн - сам им и пользуешься. А нам хотелось другого: чтобы один человек (разработчик, интегратор, да хоть сам провайдер API) собрал сценарий один раз, а дальше им пользовались все. Через обычную веб-страницу, с формой, кнопкой "Запустить" и прогресс-баром.

Так появился Fuse.

Если коротко, Fuse - это три вещи в одном:

Ключевая идея в том, что конечный пользователь не видит ни JSON, ни токены, ни устройство пайплайна. Он видит страницу: "загрузите файл", "нажмите кнопку", "вот ваш результат".

Пользователь открывает карточку сценария - она публичная, можно посмотреть шаги и список задействованных сервисов ещё до регистрации. Нажимает "Запустить" (тут уже нужен вход, у нас OAuth через Яндекс). Дальше сценарий выполняется по шагам, и весь прогресс прилетает в браузер в реальном времени через WebSocket: какой шаг выполняется, сколько прошло, где ошибка, если она случилась.

Самое интересное - шаги типа "Страница". Это пользовательские экраны прямо внутри выполнения сценария. Автор сценария собирает их в отдельном конструкторе: сетка на 6 колонок, drag-and-drop блоков - поля ввода, селекты, дропзона для файлов, текст. Блоки ввода становятся выходами шага (то, что ввёл пользователь, уходит дальше по цепочке), блоки отображения показывают результаты уже пройденных шагов. Когда выполнение доходит до такого шага, сценарий встаёт на паузу и ждёт, пока пользователь заполнит форму.

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

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

Автор начинает с приложения - так мы называем подключённый API-сервис. Загрузил OpenAPI-спеку, получил список эндпоинтов, сгруппированный по тегам, с поиском по методу, пути и описанию.

Дальше - сценарий. Пять типов шагов:

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

Когда сценарий готов - заполняешь карточку (обложка, rich-text описание, категория) и публикуешь. Всё, он в каталоге.

Пара слов о технической части, куда же без неё.

Отдельно упомяну, что весь проект мы ведём через spec-driven подход: каждая фича сначала описывается спекой с требованиями и сценариями (используем OpenSpec), потом реализуется и проверяется против спеки. На маленькой команде это неожиданно хорошо зашло - спеки заменяют и ТЗ, и часть документации.

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

Мы видим три аудитории:

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

Если у вас есть API, который вы хотели бы обернуть в сценарий, или боль, которую такая штука могла бы закрыть - расскажите в комментариях, это для нас сейчас самое ценное.

P.S: на текущий момент проект MIT и его можно запустить самому. Только дергайте ветку develop