AI Alla — product cards for Allo

1Картка в Інтеграції›ШІ«Інтеграції → ШІ»

Картка «Алла» показує, чи працює вона зараз, і веде до неї: фото в ореолі, ім'я, роль «Картки товарів для Allo», пігулки стану й виду «Програма».

1. Перемикач «Увімкнено» — вимкнена Алла не оновлює товари, не кличе модель і не збирає фід: кнопки дій сірі, у вікні смуга «Аллу вимкнено». Списки й картки видно.
2. «Відкрити» — вікно «Картки для Allo» (розділ 2).
3. «WIKI» — ця стаття шторкою.

Аллу ще не додано — на картці «Додати» і «WIKI»: Інтеграції›ШІ›Алла›Додати«Інтеграції → ШІ → Алла → Додати». Нова Алла створюється вимкненою — увімкніть її перемикачем. Для генерації потрібен ключ моделі організації (Інтеграції›ШІ›ключі моделей«Інтеграції → ШІ → ключі моделей»); модель має бачити фото.

Хто бачить вікно — Налаштування›Люди›Доступи›ШІ Алла«Налаштування → Люди → Доступи → ШІ Алла» (типово відкрито всім). Затверджувати картки, публікувати партії й очищати журнал може адміністратор, людина, яка підключила Аллу, або ШІ з доступом «ШІ Алла» (через кошик підтверджень).

2Вікно

Вікно — робоче місце Алли на весь екран: бокове меню згортається в рейку ☰, розділи переїжджають на нижню панель; ☰ на краю розгортає меню назад. У шапці — ім'я, роль, кружечки «Налаштування» (розділ 10), «Журнал», «?» (ця стаття). Праворуч — пігулка стану фіду і кнопки «Оновити з CRM», «Групи», «Довідники», «Партії», «Фід», «Лог» і «Ще».

1. Пігулка «Allo: N у фіді · оновлено о …» — скільки карток у фіді й коли його зібрано. Натисніть — Алла оновить товари з CRM. Жовта «Allo не підключено» — акаунта Allo ще нема; червона — остання помилка фіду.
2. «Групи» — категорії Allo для груп товарів (розділ 4). «Довідники» — файл категорій з кабінету Allo (розділ 4).
3. «Партії» і «Фід» — що й коли піде на Allo (розділ 7). «Лог» — задачі з прогресом і журнал подій.
4. «Ще» — «Що зараз на Allo», «Прогалини», «Каталог для інших ШІ», «Про Аллу» (розділ 9).

Під шапкою — порада Алли «що далі» з однією кнопкою: наприклад, «Є 3 карток, які не пройдуть модерацію Allo» → «Показати» або «12 товарів без категорії Allo» → «Групи». Нижче — блок «Товари»: пігулки станів з числами, список «усі групи», пошук «код або назва» і таблиця (артикул, назва, група → категорія Allo, ціна Allo, залишок, фото, стан, перевірка, стан на Allo). Колонки й першу пігулку можна змінити в Налаштування›Що показувати«Налаштування → Що показувати».

Над таблицею — дії з вибраними: «Визначити категорії», чорна «Згенерувати картки», «Перевірити заново», «Затвердити вибрані», «Зібрати партію», «Не додавати на Allo» (у пігулці «Виключені» — «Повернути до роботи»). Галочка в заголовку вибирає всі рядки сторінки; «Показати ще» — наступні товари. Клік по рядку відкриває «Картку» (розділ 5).

3Оновити з CRM і джерела

Алла бере товари лише з Helomi: склад, оголошення Prom і Rozetka з «Прайс-листа» і готові картки Каті. «Оновити з CRM» зводить їх в один товар за артикулом і показує в картці, звідки що взялося.

1. Натисніть «Оновити з CRM» у шапці (або пігулку фіду). Алла поставить задачу — тост показує прогрес, підсумок з'явиться в ньому ж.
2. Відкрийте пігулку «Нема на Allo» — товари, яких ще нема на майданчику.
3. У «Картці» блок «Як зараз у CRM» показує назву, ціну складу → ціну на Allo, залишок, групу і перелік джерел.

Що береться звідки:

• Назва, опис і характеристики — з першого джерела, де вони є; типовий порядок картка Каті›оголошення Prom›склад«картка Каті → оголошення Prom → склад» (Налаштування›Джерела товарів›Порядок джерел тексту«Налаштування → Джерела товарів → Порядок джерел тексту»).
• Фото — з усіх джерел разом, однакові прибираються.
• Ціна й залишок — ціна за правилами «Ціни» (розділ 6), залишок — вільний залишок складу (в наявності мінус резерв).
• Які товари: папки й бренди складу, «Лише товари в наявності», «Пропускати неактуальні» — Налаштування›Джерела товарів«Налаштування → Джерела товарів».

Змінився склад чи прайс — картка стає «застарілою». Сама вона не перегенеровується (це витрачає токени), доки не ввімкнете «Перегенеровувати застарілі автоматично». Вікно саме оновлює товари з CRM при відкритті, не частіше разу на хвилину («Оновлювати з CRM при відкритті»).

4Категорії й групи

Довідник — список категорій Allo з їхніми характеристиками; без нього Алла не знає, куди класти товар і що заповнювати. Категорію визначають раз на групу товарів (папку складу або групу Prom), а підтверджує її людина — так рішень десятки, а не сотні.

Завантажити довідник:

1. Скачайте файл категорій у кабінеті продавця Allo (xlsx, xml або csv із колонками «ID категорії» і «Назва»).
2. У вікні Алли натисніть «Довідники» → «Завантажити файл категорій» і виберіть файл. Тост покаже, скільки категорій прочитано.
3. Плитки шторки показують джерело, скільки категорій і коли оновлено. Довідник старший за «Довідник свіжий, днів» (типово 7) позначається «застарів».

«Синхронізувати» з API не спрацює: Allo категорій через API не віддає, сервер так і відповість. Категорію можна вписати й вручну — з картки товару через пошук.

Підтвердити категорії груп:

1. Натисніть «Групи». Плитки: скільки груп, підтверджено, чекають підтвердження, без категорії.
2. У кожної групи — запропонована категорія з упевненістю і джерелом («з наших товарів на Allo», «з картки Каті», «запропонувала Алла», «вручну») і до п'яти кандидатів.
3. Натисніть «Підтвердити» біля запропонованої категорії або «Обрати» біля кандидата. Інша категорія — «Змінити» → впишіть слово чи id → «Знайти» → «Обрати».
4. Групам без категорії — «Запропонувати категорії для решти»: Алла підбере кандидатів моделлю (витрачає токени), підтверджуєте ви.

Без підтвердженої категорії товар стоїть у пігулці «Потрібна категорія» і не генерується. Типові характеристики групи (коли в довіднику категорії їх нема) Алла пропонує один раз — їх видно сірими пігулками під групою.

5Згенерувати, перевірити, затвердити

Генерація пише картку моделлю, перевірка звіряє її з правилами Allo без моделі, затвердження — рішення людини: лише затверджена картка без помилок іде у фід.

1. Виберіть товари галочками й натисніть чорну «Згенерувати картки». Якщо категорії чи фактів ще нема, Алла визначить і збере їх сама. Тост показує прогрес «Генерація (12): 3/12…».
2. Відкрийте пігулку «Готові» і клацніть рядок — відкриється «Картка».
3. Подивіться блок «Перевірка правилами Allo»: «помилка» (червона) не дає затвердити, «зауваження» (жовте) — до вашого розсуду; під кожною — «Що робити».
4. Натисніть «Затвердити» або «Затвердити й далі →» — наступна картка відкриється сама. Стрілки ← → гортають картки, Esc закриває.
5. Кілька карток одразу — виберіть у таблиці й «Затвердити вибрані»: Алла затвердить ті, що без помилок, і назве ті, що не пройшли.

У «Картці» — назва й опис українською й російською поруч, характеристики (з позначкою «з CRM» чи «правило», коли значення не від моделі), «Спільне для обох мов» (ціна, бренд, категорія, Offer ID), «Фото для Allo», «Версії» і стан на Allo. Унизу — «Попередня», «Наступна», «Перегенерувати», «Перевірити заново», «Затвердити», «Затвердити й далі →», «Не додавати на Allo».

Коди перевірки: N — назва (довжина, заборонені слова, бренд), D — опис (реклама, контакти, назви майданчиків, теги), F01 — число, якого нема в джерелах, P — характеристики, B — бренд, I — фото, M — ціна, артикул, категорія, вага й габарити. Ліміти беруться з Налаштування›Назва й опис«Налаштування → Назва й опис» і «Фото» — змінили, натисніть «Перевірити заново», модель не потрібна.

«Версії»: кожна генерація і кожна правка — нова версія. «Повернути» робить стару версію поточною й перевіряє її заново.

6Фото й ціна руками

Фото, їх порядок і ціну на Allo можна задати руками в «Картці» — рішення пам'ятається за артикулом і переживає «Оновити з CRM».

Фото:

1. У «Картці» знайдіть блок «Фото для Allo (N з 15)». Перше фото — головне на Allo.
2. Перетягуйте фото, щоб змінити порядок, або стрілками «Лівіше», «Правіше», зірочкою «Зробити головним»; хрестик — «Прибрати фото».
3. «+ за посиланням» — https-адреса без кирилиці, пробілів і «+» → «Додати». «+ з комп'ютера» — JPG, PNG або WebP від 400×400, перетягніть у зону або натисніть її.
4. Нижче — «Не увійшли в картку»: фото з CRM і відкинуті з причиною; «повернути» додає в кінець.
5. «Скинути до автоматичного відбору» прибирає ручний порядок (Алла спитає підтвердження).

Ціна:

1. У блоці «Спільне для обох мов» впишіть «Ціну на Allo» і натисніть «Зберегти» (або Enter). Поруч з'явиться пігулка «вручну» і ціна, яка була б за формулою.
2. «Повернути автоматичну» — знову рахувати за Налаштування›Ціна«Налаштування → Ціна».

Автоматична ціна = база × (1 + «Націнка, %»), округлена «до гривні вгору» (типово: ціна складу + 10 %). Ціна поза межами «Мінімальна/Максимальна ціна» — помилка перевірки.

Категорію лише одного товару змінює «Змінити» біля «Категорії» — після зміни картку треба «Перегенерувати»: у кожної категорії свій набір характеристик.

7Партії, фід і публікація на Allo

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

Підключити фід (один раз):

1. Натисніть «Фід» у шапці вікна.
2. Натисніть «Копіювати» біля адреси фіду (адреса з'являється після першого збирання).
3. У кабінеті продавця Allo відкрийте розділ, де товари завантажуються файлом за посиланням (прайс-лист), і вставте адресу.
4. Далі нічого натискати не треба: затверджені картки потрапляють у фід самі, Allo забирає їх при наступному читанні й відправляє на модерацію.

У шторці «Фід» — скільки товарів у фіді, коли зібрано, помилки, «Зміни при останньому збиранні» (артикул, що, було, стало), «Перевірити без відправки» (показує, що змінилося б) і «Перезібрати». У фід потрапляють лише затверджені картки без помилок перевірки, не виключені і з фото (Налаштування›Allo і публікація«Налаштування → Allo і публікація»).

Партії — коли хочете відправити певний набір карток:

1. Виберіть затверджені товари в таблиці й натисніть «Зібрати партію» (або «Партії» → «Нова партія з вибраних»). Тост покаже, скільки рядків і що пропущено й чому.
2. «Партії» → «Скачати XML» — файл партії в тому самому форматі, що читає Allo.
3. «Опублікувати» — Алла спитає підтвердження і покладе партію у фід; картки стануть «У фіді / на модерації».
4. «Стан» — що відомо про модерацію товарів партії.

8Залишки й ціни: Прайс-лист і Публікації

Залишки й ціни на Allo йдуть тим самим фідом, що й картки, тож окремого циклу в Алли нема: їх видно й можна оновити в «Прайс-листі» і «Публікаціях», як для інших каналів.

1. Затвердили картку — Алла сама створює чи оновлює позицію каналу «Allo» в «Прайс-листі» (папка «Allo»): назва, ціна Allo, фото, характеристики, зв'язок зі складом за артикулом.
2. Відкрийте Склад›Публікації на площадки«Склад → Публікації на площадки» і знайдіть картку «Allo (фід Алли)».
3. Натисніть «Оновити зараз», позначте «Allo» і натисніть «Показати, що зміниться» — список Було›Стане«Було → Стане» (ціна, залишок); у фіді ще нічого не змінено.
4. Натисніть «Підтвердити й оновити» — Алла перезбере фід. Allo читає фід сам — зміни з'являться після наступного його оновлення.
5. Щоб без кнопки — перемикач «автоматично» і «кожні N хв» на картці «Allo (фід Алли)» (типово вручну, 60 хв).

Залишок у фіді — вільний залишок складу; ціна — ціна Allo з картки Алли (ручна або за формулою). Якщо фід раптом коротший за «Неповний склад: менше товарів у фіді» (типово 150) — «Публікації» зміни не застосовують: це схоже на збій складу, а не на розпродаж. Відправити попри це можна галочкою «Запобіжник» у переліку змін.

9Що зараз на Allo, прогалини, каталог для інших ШІ

Ці шторки — у кнопці «Ще» шапки вікна. Вони потрібні рідше: звірити, що вже на майданчику, чого бракує зі складу, і віддати готові картки іншим ШІ.

«Що зараз на Allo» — опубліковане фідом і статуси модерації з кабінету:

1. Скачайте в кабінеті продавця Allo вивантаження товарів (xlsx або csv із колонкою «Артикул»; id товару, статус і причина — якщо є).
2. Натисніть «Ще» → «Що зараз на Allo» → «Завантажити файл з кабінету».
3. Плитки покажуть, скільки товарів, активних і відхилених; «Причини відхилення» — згруповано; галочка «лише відхилені» — фільтр.
4. «Оновити знімок Allo» звіряє опубліковане фідом з товарами Алли.

API Allo списку товарів не віддає — тому статуси приходять файлом. Відхилені картки видно в пігулці «Відхилені».

«Прогалини» — товари складу, яких нема на Allo:

1. Натисніть «Ще» → «Прогалини». Плитки: скільки нема на Allo і скільки з них у наявності.
2. Галочки «лише ті, яких нема на Allo», «лише в наявності» звужують список; «Картка» відкриває товар Алли.
3. «Не рахувати» — товар не рахується в «нема на Allo» і не додається на Allo; «Повернути» — знову рахується.
4. «Оновити зі складу» перечитує склад і звіряє з Allo за артикулом.

«Каталог для інших ШІ» — усі затверджені картки: назви й описи двома мовами, характеристики, фото, ціна, залишок, категорія. Пошук «код або назва», «Усе про товар» — картка цілком, «Скачати весь каталог (JSON)» — одним файлом. Звідси беруть дані ШІ інших майданчиків.

«Про Аллу» — хто вона й її правила: «Не знаю — не пишу», дві мови поруч, назви іншого маркетплейсу в картці не буває, затверджуєте ви.

10Налаштування

Відкриваються тут же, у вікні: кружечок «Налаштування» праворуч угорі — меню лишається в рейці, «Назад до роботи» повертає товари. Чотири вкладки: Налаштування · API · Огляд · Журнал. Кожне поле має рядок-підказку; «Для мене» — своє (вигляд вікна, доповнення до інструкції). Типові значення — як працювала Катя.

Нижче в «Налаштуваннях» — «Доступи й ліміти» (бюджет токенів); вкладка «API» — модель Алли, «Вхід для ШІ» (картка /api/ai/sections/ai-alla, інструменти ai_alla_*) і токени; «Огляд» — дій сьогодні, токени за місяць; «Журнал» — дії Алли з автором і токенами.