Собрать флоу и опубликовать его

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

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. Затем его покажет вкладка Выполнения флоу, а статья Разбор выполнения объясняет, как его прочитать.

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

Что читать дальше