Як працювати в Rozbind

Rozbind — це AI-сервіс для автоматичного створення карток товарів для маркетплейсу Rozetka. Сервіс використовує технології штучного інтелекту для збору, аналізу та структурування інформації про товар. На основі отриманих даних Rozbind автоматично формує готову картку товару відповідно до вимог каталогу Rozetka.

Робота в сервісі зазвичай проходить за таким сценарієм: вхід у Rozbind, вибір проєкту, завантаження прайсу або створення товару вручну, запуск обробки, перевірка результатів, за потреби — ручні правки та експорт готових даних у файл.

Ця інструкція описує повний робочий процес у сервісі від початку до завершення обробки товарів.

1. Вхід у сервіс

Робота починається з входу в Rozbind. Вхід виконується через доступний спосіб авторизації: Google OAuth, Tatet Auth або інший механізм, налаштований для команди.

Пароль під час створення облікового запису зазвичай не задається вручну. Якщо вхід виконується вперше або пароль не заданий, потрібно скористатися доступним способом авторизації або функцією відновлення доступу.

Після входу відкривається робочий інтерфейс Rozbind. У лівій частині розташоване основне меню навігації, а також список проєктів, до яких користувачу надано доступ.

2. Вибір проєкту

Перед початком роботи потрібно вибрати проєкт. Проєкт — це робоча область, у якій зберігаються товарні записи, результати обробки, статуси, категорії, характеристики та інші дані.

Доступні проєкти відображаються в лівому меню. У списку відображаються лише ті проєкти, до яких надано доступ керівником або адміністратором.

Після вибору проєкту відкривається головна сторінка зі списком товарних записів.

У таблиці відображаються основні дані по товарах: дата створення, дата оновлення, Rozetka ID, назва товару, категорія, увімкнені режими обробки, кількість ітерацій, статус і кількість заповнених характеристик.

У шапці сторінки поруч із назвою проєкту відображається кількість записів, сума витрат на обробку та стан черги. Натискання на стан черги відкриває панель із розбивкою записів за статусами — звідти можна одразу перейти до потрібної групи.

Якщо потрібного проєкту немає у списку, доступ до нього ще не наданий або проєкт може бути перенесений в архів.

3. Додавання товарів у проєкт

Товари можна додати в проєкт двома способами: імпортувати прайс із файлу або створити запис вручну.

Основний спосіб для роботи з великою кількістю товарів — імпорт файлу у форматі .csv, .xlsx або .xls розміром до 10 МБ. Для цього на головній сторінці проєкту потрібно натиснути кнопку “Імпорт”, вибрати файл із товарами та налаштувати параметри завантаження.

Ручне створення використовується тоді, коли потрібно додати один окремий товар. Для цього потрібно натиснути “Додати запис”, ввести назву товару та заповнити потрібні дані в картці.

Обидва способи створюють товарні записи в межах поточного проєкту. Далі ці записи можна запускати в обробку, редагувати, перевіряти та експортувати.

4. Імпорт прайсу

Під час імпорту прайсу потрібно налаштувати, як саме товари будуть додані в проєкт.

Імпорт виконується в чотири кроки: Джерело → Колонки → Параметри → Підтвердження.

Крок 1. Джерело

Дані завантажують файлом або вставляють як CSV-текст. Підтримуються формати .csv, .xlsx, .xls до 10 МБ. Файл повинен містити рядок заголовків і хоча б один рядок даних.

Крок 2. Колонки

Сервіс зчитує заголовки файлу та перетворює їх на плейсхолдери, з яких складаються шаблони запису. Налаштовуються шаблони для назви товару, зовнішнього ID, ID та назви категорії, ID товару Rozetka й окремо для content.

Назва товару — обов'язкове поле, решта опціональні. Кнопка “Авто” підбирає відповідності за заголовками автоматично (спрощений режим), кнопка “Вставити всі в content” додає всі колонки файлу в шаблон content.

Content — це додаткова інформація, яка передається моделі разом із назвою товару.

Крок 3. Параметри

Стартовий статус визначає, що буде з товарами після завантаження:

• Чорновик — товари додаються в проєкт, але не запускаються в обробку. Підходить, якщо спочатку потрібно перевірити дані, доповнити content, уточнити категорію або налаштувати режими вручну;

• Очікує (звичайний запуск) — після імпорту товари автоматично потрапляють у чергу на обробку. Підходить для підготовлених прайсів.

Тег для всіх записів допомагає знайти конкретне завантаження серед інших товарів — наприклад, за назвою партії, постачальника або датою.

Категорія застосовується до всіх записів партії, якщо колонки файлу її не перевизначають. Якщо всі товари в прайсі належать до однієї відомої категорії, її можна вказати одразу. Якщо товари з різних категорій або категорія невідома, поле залишають порожнім і вмикають режим «Пошук категорії».

Режими обробки розділені на три групи:

Підготовка — виконується першою. Якщо категорії немає, вмикається автоматично.

• Пошук категорії — визначає категорію Rozetka за назвою й описом товару. Потрібен, коли категорії ще немає: без неї підбір характеристик і генерація не мають з чим працювати.

Основні — дають результат самі по собі. Потрібен хоча б один із них.

• Підбір характеристик — зіставляє дані товару з довідником характеристик Rozetka та заповнює їх значеннями з довідника;

• Генерація SEO-назви для Rozetka — складає назву товару за правилами Rozetka, з урахуванням бренду, типу й ключових характеристик;

• Генерація структурованого HTML-опису для Rozetka — складає опис картки на основі характеристик і матеріалу товару;

• Ймовірні характеристики (raw params) — витягує з тексту пари «назва — значення» як вони є, без звірки з довідником Rozetka. Корисно, коли характеристики описані словами й потрібно побачити їх списком.

Підсилювачі — збагачують основний прохід, окремо нічого не дають. Вмикаються лише разом із одним із основних режимів.

• Пошук інформації про товар в інтернеті — шукає характеристики у відкритих джерелах і додає знайдене до матеріалу. Має сенс, коли власного опису бракує;

• Розпізнавання зображень товару — аналізує фотографії й дістає з них те, чого немає в тексті: колір, форму, комплектацію.

Крок 4. Підтвердження

Перед запуском показується підсумок імпорту. Після підтвердження записи створюються в проєкті.

5. Створення товару вручну

Якщо потрібно додати один товар без імпорту прайсу, використовується кнопка “Додати запис”.

Після натискання відкривається екран нового запису. Обов'язкове поле одне — назва товару або текстовий промпт. Додатково можна одразу задати стартовий статус (Чорновик або Очікує), категорію, теги та content.

Запис створюється кнопкою “Створити запис”. Якщо обрано статус “Чорновик”, запис не потрапляє в чергу — режими обробки вибирають уже в картці товару й запускають кнопкою “Запустити”.

6. Робота зі списком товарних записів

Після імпорту або ручного створення товари відображаються у списку записів проєкту. У таблиці можна швидко перевірити назву товару, категорію, статус і прогрес заповнення характеристик.

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

У списку товарних записів можна виконувати масові дії. Для цього потрібно вибрати потрібні товари за допомогою чекбоксів у лівій частині таблиці. Після вибору записів з’явиться панель масових дій.

Через панель масових дій можна поставити вибрані записи “В чергу”, “Призначити категорію”, “Змінити режими” або “Видалити вибрані”.

Дія “Змінити режими” має три варіанти: замінити набір режимів на новий, додати обрані режими до наявних або прибрати їх із наявних. Записи, які саме зараз в обробці, будуть пропущені.

7. Робота з карткою товару

Для детальної роботи з конкретним товаром потрібно відкрити його картку зі списку записів відповідного проєкту. Картка товару складається з кількох основних зон. Ліворуч розташовані вихідні дані товару, праворуч розташовані результати підготовки для Rozetka.

Перед запуском обробки варто перевірити блок Content. Content — це основне джерело інформації про товар. Якщо інформації достатньо, можна переходити до обробки. Якщо даних мало або вони неповні, content потрібно доповнити.

У блоці Content доступна кнопка “Збагатити контент” — вона відкриває панель із двома діями.

Пошук в інтернеті. Пошуковий запит формується автоматично на основі назви товару та категорії, але його можна відредагувати вручну. Пошук запускається кнопкою «Шукати» або клавішею Enter.

Розпізнавання зображень. Аналізує відмічені фотографії товару. Зображення відмічають у блоці “Зображення з content” ліворуч — максимум 10 за раз.

Обидві дії дописують знайдену інформацію в кінець content і не перезаписують наявний текст. Після завершення результат потрібно переглянути та натиснути “Зберегти content”.

Щоб обробити товар, потрібно вибрати потрібні режими у верхній панелі та натиснути “Запустити”.

Можна запускати один режим або кілька режимів одночасно. Якщо потрібно лише визначити категорію, обирається режим “Категорія”. Якщо потрібно заповнити характеристики Rozetka, обирається “Характеристики”. Якщо потрібно сформувати назву або опис, обираються відповідні режими “Назва” та “Опис”.

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

Режим “Ймовірні характеристики” створює окремий набір характеристик товару в блоці джерела. Ці характеристики не є заповненими параметрами Rozetka, але можуть використовуватися як окремий структурований набір даних.

У шапці картки доступний перегляд “Вигляд на Rozetka” — він показує, як картка виглядатиме на сайті маркетплейсу.

Кнопка “Гід” запускає інтерактивну підказку по елементах екрана.

8. Перевірка підготовленого товару для Rozetka

Параметри Rozetka відображаються в правій частині картки товару. У цьому блоці видно список характеристик категорії, заповнені значення та прогрес заповнення. Заповнені характеристики відображаються зі значеннями, а незаповнені мають позначку “Не заповнено” або залишаються порожніми.

Якщо значення підібране некоректно або характеристика не заповнилася, її можна відкрити й відредагувати вручну.

Якщо запускалися режими “Назва” або “Опис”, результат потрібно перевірити в блоці “Назва та опис”. Назва має відповідати товару, містити правильний бренд, модель і ключові характеристики. Коротка назва має бути стислою, але зрозумілою. Опис має бути фактично точним і не повинен містити вигаданих характеристик або даних про інший товар.

За потреби назву та опис можна відредагувати вручну. Після редагування потрібно зберегти запис.

9. Повторна обробка після редагування

Повторний запуск обробки потрібен, якщо після першого результату були змінені важливі дані. Наприклад, повторна обробка може знадобитися після зміни категорії, доповнення content, ручного редагування назви, додавання характеристик або розпізнавання зображень.

Для повторного запуску потрібно вибрати потрібні режими та натиснути “Запустити”. Якщо потрібно повторно обробити кілька товарів, їх можна вибрати у списку записів і поставити в чергу масово. Перед повторним запуском потрібно враховувати, що нова обробка може змінити попередні результати.

10. Завершення підготовки товарів

Товар можна вважати підготовленим, коли виконані основні перевірки: категорія відповідає товару, важливі характеристики заповнені коректно, назва й опис не містять помилок, а всі ручні зміни збережені.

Перед експортом варто переглянути кілька товарів із партії, особливо якщо обробка виконувалася масово. Це допоможе переконатися, що обрані режими спрацювали правильно, а результати мають потрібну якість.

11. Експорт готових товарів

Експорт запускається з меню «⋮» → “Експорт у файл” у шапці проєкту або з панелі “Фільтри та експорт”. Якщо потрібно вивантажити лише частину товарів, їх спершу відмічають чекбоксами в таблиці.

Експорт виконується в три кроки: Обсяг → Колонки → Перевірка.

Крок 1. Обсяг

Обирається формат файлу: Excel (.xlsx) — зручний для перегляду, CSV (.csv) — для подальшого імпорту в інші системи.

Тут же показано область даних. Якщо записи відмічені чекбоксами, експортуються лише вони; якщо ні — усі записи за поточними фільтрами таблиці.

Крок 2. Колонки

Колонки поділені на три групи:

• Базові поля — поля самого запису: ID, назва, статус, теги, посилання на товар Rozetka, дати створення й оновлення та інші;

• Result JSON — дані з результату обробки: категорія, виробник, модель, EAN, кількість характеристик, назви та значення параметрів. Можна додати власний JSON path;

• Параметри як колонки — окрема колонка для кожного параметра поточного фільтра.

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

Перемикач “Зберегти експорт” додатково зберігає файл на сервері: він з'явиться в розділі “Експорт” у лівому меню.

Крок 3. Перевірка

Показується підсумок — кількість записів, кількість колонок і формат — та прев'ю перших 10 рядків. Після перевірки натискають “Експортувати”; у назві кнопки відображається кількість записів, які будуть вивантажені.

12. Рекомендований повний сценарій роботи

Рекомендований порядок роботи на початку виглядає так:

1. Увійти в Rozbind.

2. Вибрати потрібний проєкт у лівому меню.

3. Натиснути “Імпорт” і завантажити файл CSV або XLSX з товарами.

4. Завантажити товари в проєкт.

5. Перевірити список створених записів.

6. За потреби відкрити картку товару та доповнити content.

7. Запустити обробку одного товару або групи товарів.

8. Дочекатися завершення обробки.

9. Перевірити категорію, характеристики, назву й опис.

10. Внести ручні правки, якщо це потрібно.

11. Повторно запустити обробку для товарів, які потребують доопрацювання.

12. Вибрати готові записи або підготувати весь список до експорту.

13. Експортувати готовий файл у форматі Excel або CSV.

Основні етапи роботи в Rozbind — від додавання товарів і запуску обробки до перевірки та експорту готових результатів — наочно показані у відеоогляді.