Старт и обзор
Глоссарий
Термины платформы — краткие определения.
Краткий словарь: незнакомые термины в других статьях можно сверить здесь; подробности — в соседних разделах.
| Термин | Значение |
|---|---|
| Диаграмма, флоу | Сохранённая схема: ноды, связи, настройки. Открывается в редакторе. |
| Нода (узел) | Один блок на схеме. У неё есть тип (nodeType) — исполнитель из библиотеки. |
| Исполнитель | Реализация одного шага: что делает нода. В каталоге у типа — описание и поля настройки. |
| Порт | Точка входа или выхода данных на ноде. Стрелки соединяют выход одной ноды со входом другой. Формат данных на линии связи задаёт контракт порта и тип исполнителя (в том числе структурированные объекты); это не обязательно сериализованный JSON-текст. |
| Контракт | Соглашение о структуре данных на порту или у триггера (часто задаётся схемой, в т.ч. JSON Schema). Несовпадение с фактическими данными даёт ошибку при запуске. |
| Триггер | Способ стартовать флоу. Значения: manual, webhook, cron, mcp_tool и др. Задаётся в настройках процесса. |
| Ран (run) | Один прогон схемы от начала до конца или до ошибки. |
runId | Уникальный идентификатор прогона (UUID). Передают в поддержку и используют в API для запроса статуса и результата. |
system.trigger.input | Системная нода входа: структура данных для webhook, cron, MCP и публичной формы; для ручного запуска нужна, если в интерфейсе задают поля ввода. |
system.output | Узел для явной передачи результата наружу; в интеграциях выход этого узла читают как итог. |
| Webhook | HTTP-запуск флоу: в ответ приходит runId, результат запрашивают отдельно. Пути начинаются с /webhook/v1/. |
Ключ API (afk_…) | Токен для вызовов webhook и/или MCP от вашего аккаунта. У ключа — области (webhook, mcp) и список разрешённых диаграмм. |
| Секрет | Именованное значение в разделе «Секреты»: пароли и токены для настроек нод, не для входящих вызовов к платформе. |
| MCP | Model Context Protocol: JSON-RPC на POST /mcp/v1, вызов процессов из IDE и агентов как инструментов. |
| Slug | Имя в ссылке на гостевую форму: /public/flow/<slug>. Доступ по ссылке эквивалентен знанию секрета. |
Проектирование и запуск
Проектирование — работа в редакторе: библиотека, связи, триггеры, секреты.
Запуск — создаётся ран: вручную, по HTTP, по расписанию, через MCP или форму.