Зібрати флоу й опублікувати його
Почніть флоу із шаблону або з порожнього полотна, підключіть модель, опублікуйте флоу й прив’яжіть код операції, який називатимуть ваші запити.
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-модель — що вузол моделі робить із грошима виклику.