Flow Studio — рабочее место автора переносимых процессов поставки и связанных артефактов. Пакет может содержать Flow, навыки, платформенных агентов, подагентов, требования MCP, схемы, правила, сценарии и методы оценки.

​
Что потребуется

  • Активная учётная запись MAIster.
  • Право управления каталогом проекта для проектных операций.
  • Готовый ACP-раннер для ИИ-помощника.
Источники, установленные и локальные пакеты в Flow Studio

​
Три состояния пакета

Установленное содержимое нельзя менять на месте. Выберите Создать ответвление, чтобы скопировать пакет или поддерживаемый элемент в новый локальный пакет с сохранением связи с исходной ревизией.

​
Редактор локального пакета

Граф Flow и редакторы файлов пакета В одном черновике объединены:
  • граф узлов и переходов по исходам;
  • типизированные настройки узлов, проверок, решений и раннеров;
  • flow.yaml с подсказками и обновлением графа;
  • дерево пакета и формы для известного заголовка файлов;
  • редакторы навыков, агентов, правил, сценариев и схем;
  • ошибки проверки и Git-разница локальной рабочей копии.
Граф и YAML используют одно состояние. При ошибке YAML остаётся последний корректный граф и показывается причина. Сохранение проверяет граф, ссылки, пути, схемы и обязательные поля до записи черновика.

​
ИИ-помощник

Откройте ИИ-помощника рядом с локальным Flow, чтобы задать вопрос о пакете или запросить защищённое изменение. Ниже кратко описана его модель работы. Откройте боковую панель помощника в локальном пакете. Он отвечает на вопросы о текущем содержимом или предлагает ограниченное изменение. Сервер передаёт ему снимок состава пакета, контрольные суммы, граф и текущий фокус редактора. ACP-сессия имеет доступ только на чтение. Для изменения помощник возвращает структурированное действие с путями, исходными контрольными суммами и новым содержимым. MAIster проверяет всё действие и применяет его атомарно.
  • Помощник не пишет файлы напрямую.
  • Изменившийся исходный файл отклоняет всё действие, а не затирается.
  • Небезопасный путь, неверные YAML, заголовок, схема или граф отклоняются до изменения файлов.
  • Разница остаётся доступной для человека и обычной истории Git.
Просите одну проверяемую операцию: добавить узел, изменить слот раннера, создать схему результата или объяснить ссылку. Большую переработку делите на несколько ходов.

​
Сохранение и подключение

  1. Сохраните корректный черновик.
  2. Проверьте разницу пакета.
  3. Зафиксируйте изменения в локальном Git.
  4. Создайте неизменяемый срез выбранного коммита.
  5. Подключите его через Проект → Пакеты.
  6. Проверьте исполняемое содержимое и явно выдайте доверие.
  7. Привяжите слоты раннеров и требования MCP.
Срез, Flow, навык и инструкция платформенного агента переносятся между проектами и установками. Местные идентификаторы раннеров, секреты и привязки проектов в пакет не входят.

​
Сравнение и синхронизация

Для ответвления доступно сравнение с выбранной исходной ревизией. Синхронизация использует трёхстороннее слияние исходной точки, текущего локального содержимого и новой внешней версии. Разрешите конфликты, проверьте пакет и зафиксируйте результат. MAIster не перезаписывает историю принудительно. Публикация обратно в зарегистрированный источник создаёт обычную ветку и pull request, если узел источника настроен. Основная ветка источника напрямую не изменяется.

​
Признаки ошибки

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

​
Что дальше