Нарисовать флоу в конструкторе
Палитра, холст и панель узла, как черновик сохраняется по ходу работы и клавиши, которые её ускоряют.
4 мин чтения
Конструктор — это место, где рисуют флоу: его узлы, связи между ними и настройки каждого узла. То, что вы рисуете, — черновик флоу, и запросы выполняют его, только когда он опубликован. Эта страница — о частях конструктора и о том, как в нём работать; статья Как устроен флоу — о том, что флоу должен содержать.
Открыть конструктор
На странице AI-флоу нажмите на строку или создайте флоу — откроется конструктор. Это вкладка Конструктор флоу. Над холстом стоят инструменты холста; справа в шапке флоу — Проверить, Опубликовать и строка, которая говорит, сохранён ли черновик.
Для изменения флоу нужно разрешение flows:write — статья Организации, проекты и роли говорит, у каких ролей оно есть. Без него конструктор открывается в режиме Вживую, режиме чтения холста, а переключение на Редактирование выключено.
Добавить узлы
Нажмите Добавить узел, чтобы открыть палитру. Она раскладывает узлы по группам из статьи Как устроен флоу, а её поле поиска находит узел по названию. Перетащите узел на холст или нажмите на него, чтобы добавить.
У флоу один входной узел, Запрос. Когда он уже на холсте, его строка в палитре выключена.
Замороженного узла — HTTP-запрос, если сервис не настроен иначе, — в палитре нет вовсе. Черновик, в котором он ещё есть, не публикуется.
Связать узлы
Протяните связь от порта узла к узлу, который идёт следующим. Порт ведёт к одному узлу: у узла с несколькими исходами есть порт на каждый, и порты — это ветки, — Порты и ветвление.
Холст отказывает в связи, которая не может работать, и говорит почему: узел, указывающий сам на себя, связь во входной узел, связь из конечного узла, вторая связь из порта, у которого она уже есть.
Настроить узел
Нажмите на узел, чтобы открыть его панель справа. У панели есть вкладки Настройки и Метрики; у узла AI-модель — ещё Подключения и Дополнительно.
Настройки начинаются с того, что проверка флоу нашла в узле неверным, затем идёт название узла, затем его собственные настройки.
Метрики показывают числа узла по выполнениям флоу.
Удалить узел удаляет узел вместе с его связями. Готово, Esc или щелчок по пустому холсту закрывают панель.
Как сохраняется черновик
Каждое изменение сохраняется само, через несколько секунд после того, как вы остановились. Строка рядом с Опубликовать говорит, в каком состоянии черновик, — Сохранение…, время последнего сохранения или Не удалось сохранить, — а не сохранено рядом с названием флоу отмечает изменения, которые не дошли до сервера.
Проверить и Опубликовать сначала сохраняют черновик. Когда его не удаётся сохранить, ничего не проверяется и не публикуется.
Когда тот же черновик тем временем сохранил кто-то другой, конструктор останавливается и спрашивает: Перезагрузить берёт их черновик и отбрасывает ваши изменения, Перезаписать кладёт ваши поверх их.
Черновик больше 256 КБ не сохраняется.
Отменить, расставить и осмотреться
| Инструмент | Что он делает |
|---|---|
| Отменить, Повторить | Шаг назад и вперёд по изменениям, включая настройки узла |
| Дублировать | Копирует выбранные узлы на месте, вместе со связями между ними |
| Автораскладка | Расставляет узлы на холсте |
| − и + | Уменьшают и увеличивают масштаб. Значение между ними показывает масштаб; нажмите на него, чтобы сбросить |
| Вместить | Помещает весь флоу в поле зрения |
| Показать статистику | Пишет под каждым узлом, сколько запросов через него прошло и сколько они потратили, по оценке |
Входной узел и замороженный узел не копируются.
Горячие клавиши
Нажмите ?, чтобы увидеть их в конструкторе.
| Клавиши | Что они делают |
|---|---|
| Ctrl/⌘ + Z, Ctrl/⌘ + Shift + Z | Отменить, повторить |
| Ctrl/⌘ + C, Ctrl/⌘ + V | Скопировать выделение; вставить его со смещением от оригинала |
| Ctrl/⌘ + D | Дублировать выделение на месте |
| Delete или Backspace | Удалить выделение вместе с его связями |
| Ctrl/⌘ + клик | Добавить узел к выделению |
| Shift + перетаскивание | Выделить всё внутри рамки |
| Ctrl/⌘ + A | Выделить все узлы |
| Esc | Снять выделение |
Клавиши ничего не делают, пока в фокусе текстовое поле.
Проверить, опубликовать и наблюдать
Проверить проверяет черновик и отмечает узлы с найденными ошибками; Опубликовать делает его следующей версией — Публикация, версии и откат. Переключатель Редактирование | Вживую превращает холст в показ идущих выполнений: Разбор выполнения.
Что читать дальше
AI-флоу — как запрос находит свой флоу и какие состояния бывают у флоу.
Как устроен флоу — что должно быть в каждом флоу и каждый узел палитры.
Публикация, версии и откат — от черновика к версии, которая выполняется.
Разбор выполнения — что опубликованный флоу сделал с запросом.
Контекст выполнения и пути — что может читать путь в настройках узла.
Проверки при публикации — все проверки графа и настроек узла с сообщением, которое показывает конструктор.