Собрать флоу и опубликовать его
Начните флоу с шаблона или с пустого холста, подключите модель, опубликуйте флоу и привяжите код операции, который будут называть ваши запросы.
2 мин чтения
Флоу решает, сколько может потратить запрос и как на него ответить. Эта страница проводит через самый короткий работающий флоу — приходит запрос, модель на него отвечает, на отказ отвечают отказом — от пустого холста до первого запроса.
Сначала нужны две вещи. Проекту нужно подключение к провайдеру модели, которую вызовет флоу, — Подключения. А для сборки флоу нужно разрешение flows:write — статья Организации, проекты и роли говорит, у каких ролей оно есть.
Флоу, который вы собираете
- Запрос — По умолчанию → AI-модель
- AI-модель — Успех → Вернуть ответ
- AI-модель — Отказ → Отклонить запрос
Запрос входит в Запрос, AI-модель вызывает модель, а Вернуть ответ отвечает тем, что сказала модель. Когда бюджет или политика отклоняет вызов, AI-модель выходит через Отказ, и на отказ отвечает Отклонить запрос.
Чтобы вместо этого начать с готового правила, выберите карточку на Шаблоны и нажмите Создать черновик — Шаблоны AI-флоу, — затем прочитайте его узлы и продолжайте с шага Проверьте флоу.
Собрать и опубликовать
1. Создайте флоу
На странице AI-флоу нажмите Новый флоу, заполните Название и нажмите Создать флоу. Конструктор откроется с пустым холстом.
2. Добавьте узлы
Нажмите Добавить узел и перетащите на холст четыре узла: Запрос, AI-модель, Вернуть ответ и Отклонить запрос.
3. Свяжите их
Протяните связь от порта Запрос к AI-модель. Затем свяжите порт Успех узла AI-модель с Вернуть ответ, а его порт Отказ — с Отклонить запрос.
4. Выберите модель
Нажмите на AI-модель и выберите Модель. Поле Пул провайдеров оставьте как есть: тогда вызов идёт через пул провайдера по умолчанию или через ваше подключение к нему. Максимум выходных токенов ограничивает ответ, и под него берётся холд.
5. Сформулируйте отказ
Нажмите на Отклонить запрос и задайте Код ошибки и Сообщение, которые получит вызывающий, когда трата отклонена, например budget_exceeded.
6. Проверьте флоу
Нажмите Проверить. Проблема отмечается на её узле, а панель узла говорит, что изменить. Предупреждение не останавливает публикацию: этот флоу получит предупреждение, что у AI-модель нет ветки Ошибка, поэтому ошибка провайдера проваливает запрос.
7. Опубликуйте его
Нажмите Опубликовать. Черновик становится версией 1 — активной версией флоу.
8. Привяжите код операции
Откройте вкладку Настройки флоу. В разделе Привязка операции введите в поле Код операции код, который будет отправлять ваше приложение, например generate_email, и нажмите Сохранить привязку.
Изменения сохраняются по ходу работы, поэтому конструктор можно покинуть на любом шаге, и черновик будет на месте, когда вы вернётесь, — Конструктор флоу.
Отправить первый запрос
Запрос, который называет привязанный код операции, выполняет флоу. Быстрый старт отправляет такой запрос из PHP или Node.js. Затем его покажет вкладка Выполнения флоу, а статья Разбор выполнения объясняет, как его прочитать.
Чтобы потом изменить флоу, отредактируйте его в конструкторе и опубликуйте снова: до следующей публикации запросы продолжают выполнять активную версию — Публикация, версии и откат.
Что читать дальше
Конструктор флоу — палитра, холст и панель узла.
Как устроен флоу — каждый узел палитры и то, что должно быть в каждом флоу.
AI-флоу — как запрос находит свой флоу.
AI-модель — что узел модели делает с деньгами вызова.