Глосарій термінів Slen

Слова, якими користуються консоль і цей довідник, — операція, флоу, версія, виконання, резерв, пул, клієнт, кредити — і що означає кожне.

5 хв читання

Консоль, API і цей довідник називають ті самі речі тими самими іменами. Ця сторінка каже, що означає кожне ім’я. Терміни стоять групами, у тому порядку, у якому їх зустрічає запит. У дужках — англійське слово, яким термін названо в API та в англійській версії консолі.

Запити

Термін	Що це
Операція (operation)	Один виклик моделі у флоу з усім, що з ним сталося, — спроби, резерв, вартість. Список — на екрані Операції.
Код операції (operation code)	Ім’я, яке ви даєте виду запитів, наприклад `generate_email`. Запит, який запускає флоу, називає свій код, і код вирішує, який флоу запуститься.
Прив’язка операції (operation binding)	Відповідність між кодом операції та флоу, вона задається в налаштуваннях флоу. Один код належить одному флоу проєкту, і флоу має один код. Див. AI-флоу.
Виконання (execution)	Один запуск флоу. Завершене виконання має статус `completed`, `rejected`, `failed` або `uncertain`. Незавершене — `queued`, `running` або `waiting`.
Трасування (trace)	Запис виконання — вузол за вузлом, подія за подією.

Флоу

Термін	Що це
Флоу, AI-флоу (flow)	Граф, який вирішує, скільки запиту можна витратити. Див. Як побудовано флоу.
Конструктор флоу (flow builder)	Редактор флоу — палітра вузлів, полотно й інспектор вузла.
Полотно (canvas)	Поверхня конструктора, на якій стоять вузли флоу.
Вузол (node)	Один крок флоу.
Порт (port)	Іменований вихід вузла. Див. Порти й розгалуження.
Зв’язок (connection)	Лінія від порту одного вузла до іншого вузла. Підключення провайдера — інша річ, про нього нижче.
Гілка (branch)	Шлях, який починається в порту.
Вхідний вузол (entry node)	Вузол, з якого починається флоу, — Запит. У флоу він один.
Кінцевий вузол (terminal node)	Вузол, який закінчує шлях, — Повернути відповідь або Відхилити запит.
Шаблон (template)	Готовий флоу, з якого можна почати. Галерея — на екрані Шаблони.

Версії

Термін	Що це
Версія (version)	Пронумерований стан флоу. Версія — це або чернетка, або опублікована версія, і опублікована версія ніколи не змінюється. Див. Публікація, версії та відкат.
Чернетка (draft)	Версія, яку зараз редагують. Флоу має не більше однієї чернетки, і запити її ніколи не запускають.
Опублікувати (publish)	Перевірити чернетку і, якщо в ній немає помилок, зробити її опублікованою версією. Відтоді флоу запускає цю версію.
Активна версія (active version)	Опублікована версія, яку запускають запити. До відкату це остання опублікована, після відкату — та, на яку відкотилися. Чернетка флоу починається з активної версії. Вкладка Версії флоу показує в неї статус Активна.
Відкотити (roll back)	Зробити активною іншу опубліковану версію. Виконань, які вже тривають, це не зачіпає.

Гроші

Термін	Що це
Оцінка (estimate)	Скільки очікувано коштуватиме виклик — рахується до самого виклику. Оцінка нічого не витрачає.
Резерв, холд (reservation, hold)	Гроші, відкладені під виклик до того, як його зроблено. Гроші тримає лише резерв у статусі `authorized`. Консоль називає резерв ще й словом «утримання». Чим різняться статуси, пояснює стаття Як працює резервування бюджету.
Авторизація (authorization)	Резерв у тому вигляді, у якому його записують API і консоль, — сума, статус і те, що списано. Вкладка — на екрані Операції, див. статтю Операції, авторизації та реєстр.
Списання (capture)	Закрити резерв за тим, скільки виклик коштував насправді. Залишок резерву повертається.
Повернення (release)	Повернути резерв повністю. Нічого не списується.
Реєстр (ledger)	Список рухів грошей проєкту. Записи до нього лише додаються й ніколи не змінюються.
Бюджет (budget)	Стеля витрат проєкту або організації. Вона задається в грошах або, для одного виду бюджету, у кількості резервів, які тримаються одночасно.
Політика (policy)	Правило, яке застосовується до запиту до того, як гроші зарезервовано. Воно відхиляє запит або змінює його ліміти.

Провайдери й моделі

Термін	Що це
Провайдер (provider)	Компанія, моделі якої викликаються.
Підключення провайдера (provider connection)	Облікові дані одного акаунта провайдера, через який Slen викликає моделі.
Пул провайдерів (provider pool)	Група підключень провайдерів і стратегія, за якою одне з них обирається для виклику.
Модель (model)	Модель із каталогу з цінами її токенів. Каталог — на екрані Моделі.
Влучання і промах кешу (cache hit, cache miss)	Влучання означає, що в кеші є відповідь на запит, і флоу може відповісти, не викликаючи модель. Промах означає, що відповіді в кеші немає.

Клієнти

Термін	Що це
Клієнт (customer)	Ваш кінцевий клієнт. Slen знає клієнта за ідентифікатором, який йому дає ваш застосунок, — `external_user_id`; запит, що запускає флоу, надсилає його в `context.user_id`.
Кредити (credits)	Одиниця, у якій ви рахуєте споживання своїх клієнтів. Кредити — не гроші. Виклик моделі резервує кредити до запуску, витрачає їх під час списання й отримує назад під час повернення.
Рахунок (credit account)	Кредити одного клієнта одного типу: баланс, зарезервоване й налаштування — чи може рахунок іти нижче нуля і коли він попереджає. Клієнт має по рахунку на кожен тип кредитів.
Списання (charge)	Кредити, які ваш застосунок сам знімає з клієнта за те, що продає поза флоу. Списання — не витрата виклику.
Блокування (block)	Зупинка запусків одного клієнта: його нові запуски відхиляються, а його кредити, як і раніше, можна рухати. Див. Кредити клієнтів.

Доступ

Термін	Що це
Організація (organization)	Ваша компанія в Slen. У ній містяться проєкти, учасники та спільні для них налаштування.
Проєкт (project)	Частина організації зі своїми API-ключами, флоу й операціями.
Учасник (member)	Людина в організації, яка має роль.
API-ключ (API key)	Секрет, який сервіс надсилає з кожним запитом. Ключ належить одному проєкту. Див. Керування API-ключами.
Дозвіл (scope, permission)	Те, що ключу можна робити. Див. Автентифікація.
Погодження (approval)	Рішення, на яке чекає виконання. Людина схвалює або відхиляє його на екрані Погодження.
Сповіщення (alert)	Звістка про те, що умова, для якої ви задали правило, стала істинною.
Повідомлення (notification)	Звістка, яку Slen надсилає людині або в чат команди про сповіщення чи погодження. Див. Повідомлення.
Вебхук (webhook)	Запит, який Slen надсилає вашому сервісу, коли стається подія.
Журнал аудиту (audit log)	Історія дій і змін в організації.