> Усі статті WIKI Helomi: /wiki/llms.txt

# ШІ Валентина — картки для EVA (старий фід)

Валентина — ШІ-програма, яка складає картку для маркетплейсу EVA на кожен артикул каталогу Каті, чистить назву й опис за правилами EVA і тримає постійний XML-фід, який EVA вже читає. Людина переглядає картки й затверджує — у фід ідуть лише затверджені без помилок; ціна EVA — ціна Розетки з вашим відсотком, залишок — свіжий зі складу.

Валентина — перша програма для EVA, а [ШІ Єва](ai-eva.md) — новіша за новими правилами EVA (картки моделлю, довідники, партії); Єва бере ті самі offer id і категорії, що у фіді Валентини, тож обидві працюють поруч, і фід Валентини EVA читає далі.

## Можливості
- Картка EVA на кожен артикул каталогу Каті: назва й опис українською й російською, бренд, характеристики, категорія Розетки, фото.
- Чистка тексту за правилами EVA: з опису вирізаються абзаци з контактами, цінами, акціями й посиланнями; що саме вирізано — видно в картці.
- Перевірка кожної картки: помилки EVA (червоні) не пускають картку у фід, зауваження (жовті) — підказки.
- Товар без бренду — «No Brand», як просить EVA; країну-виробника для таких товарів можна задати в налаштуваннях.
- Правка руками: назва, опис, бренд, характеристики; автоматичну версію видно поруч, повернути її — одна кнопка.
- Затвердження власником (або кожним з доступом — за налаштуванням): по одній картці або всі готові разом.
- Постійний фід за однією адресою: EVA вже її знає, адреса не міняється; ціна й залишок рахуються в момент збирання.
- Ціна EVA = ціна Розетки ± відсоток, який задає власник.
- Квадратні копії фото: EVA приймає лише квадрат — Валентина рахує розміри всіх фото й добудовує білі поля.
- Нею керують інші ШІ (Ломі, Остап) інструментами `ai_valentyna_*`; затвердження й ціна — лише через підтвердження людини.

## 1. Відкрити Валентину
Картка «Валентина» в «Інтеграції → ШІ» показує, чи вона працює, і веде у вікно програми.

1. Відкрийте «Інтеграції → ШІ» і знайдіть плитку «Валентина».
2. Перевірте перемикач «Увімкнено». Вимкнена Валентина нічого не робить: дії у вікні й інструменти інших ШІ повертають «ШІ вимкнено», читати можна. Фід для EVA при цьому працює далі.
3. Натисніть «Відкрити» — вікно «Картки для EVA (старий фід)».

Хто бачить вікно — «Налаштування → Люди → Доступи → ШІ Валентина»; стара галочка «ШІ Валентина (EVA)» теж пускає.

> [!NOTE]
> Валентина працює лише в організації, де є каталог Каті.

## 2. Оновити картки з каталогу Каті
Нові артикули каталогу стають картками, що чекають затвердження, — у фід самі не йдуть.

1. Оновіть каталог у Каті («Оновити з Розетки»).
2. У Валентини натисніть «Каталог Каті» в шапці вікна.
3. Натисніть «Оновити з каталогу Каті» й дочекайтеся повідомлення «Каталог Каті: N товарів, нових карток M».

Відкриття вікна теж підхоплює оновлений каталог. Товари, яких у каталозі більше нема, отримують стан «Зникли». Дублі артикулів і товари без артикула видно в «Не взято з каталогу».

## 3. Перевірити й виправити картку
Кожну картку Валентина перевіряє правилами EVA одразу після складання й після кожної правки.

1. Натисніть кольорову плитку стану, наприклад «З помилками».
2. Натисніть рядок картки — праворуч відкриється картка з блоком «Перевірка EVA».
3. Виправте назву, опис, бренд чи характеристики й натисніть «Зберегти картку» — перевірка пройде знову.
4. Щоб повернути автоматичну версію, натисніть «Як склала Валентина» й підтвердіть.

Блок «Вирізано з тексту» показує абзаци, які не пішли на EVA, а «Як склала Валентина» — автоматичну версію поруч із правленою. Сховати їх можна в «Налаштування → Що показувати».

> [!TIP]
> Якщо товар змінився в каталозі Каті після ваших правок, у картці з'явиться смуга «Товар змінився в каталозі Каті» — перегляньте текст.

## 4. Затвердити картки
У фід ідуть лише затверджені картки без помилок EVA.

1. Відкрийте картку й натисніть «Затвердити» — або позначте кілька галочками.
2. Щоб затвердити всі готові без помилок, натисніть чорну кнопку «Затвердити готові» й підтвердіть число.
3. Затверджені отримують стан «У фіді» й потрапляють у фід при наступному збиранні.

«Зняти з фіду» повертає картку в «Готові». «Не ставити» виводить картку з фіду назавжди (доки не натиснете «Повернути»).

Хто затверджує — «Налаштування → Картки → Хто затверджує картки для EVA»: типово власник, як було.

> [!IMPORTANT]
> Якщо в затвердженій картці з'явилась помилка EVA (наприклад, після оновлення каталогу), Валентина сама знімає її з фіду й пише чому.

## 5. Фід для EVA
Фід — XML за постійною адресою, яку EVA вже читає; кабінет EVA сам перечитує його й оновлює ціни й наявність.

1. Натисніть «Фід і ціна» в шапці вікна (або зелену пігулку «EVA: у фіді N»).
2. Подивіться, скільки товарів у фіді, скільки в наявності і що пропущено й чому.
3. Натисніть «Перебудувати», щоб зібрати фід зараз.

Залишок у фіді — вільний залишок складу Helomi (є мінус резерв) товару з тим самим артикулом, так само як у фіді Єви. Набір «А000002-N2» — залишок базового товару, поділений на 2 один раз (10 шт → 5). Артикула на складі нема — 0. Склад не прочитано — фід не перезбирається, EVA отримує попередній.

Фід живе 30 хвилин: старший Валентина перезбирає, коли EVA приходить по нього. Змінити — «Налаштування → Фід для EVA → Фід живе, хв».

> [!WARNING]
> Адресу фіду не міняйте в кабінеті EVA: за нею EVA вже зіставила товари й категорії.

## 6. Змінити ціну EVA
Ціна EVA — ціна Розетки з вашим відсотком, наприклад −4 %. Правило Розетки «не дорожче за інші канали» діє в обидва боки.

1. Натисніть «Фід і ціна».
2. У блоці «Ціна EVA = ціна Розетки ± %» впишіть відсоток від −50 до +100.
3. Натисніть «Змінити ціну» й підтвердіть — фід перебудується одразу.

Змінює ціну лише власник; хто й коли змінив востаннє — видно під полем.

## 7. Квадратні фото
EVA приймає лише квадратні фото, тому Валентина робить квадратні копії з білими полями.

1. Натисніть «Фото» в шапці вікна.
2. Натисніть «Перевірити фото й зробити квадрати».
3. Стежте за смугою: «розміри», далі «квадратні копії», потім «готово».

Плитки показують, скільки фото перевірено, скільки квадратних копій, скільки замалих і скільки не відкрилось.

## 8. Налаштування
Налаштування відкриває кружечок «Налаштування» в шапці вікна. Порожнє поле — як було раніше, тож фід не міняється, доки ви самі щось не зміните.

| група | що налаштовується |
| --- | --- |
| Характер | інструкція, тон, звертання, мова |
| Фід для EVA | назва магазину, компанія, адреса магазину у фіді, скільки живе фід, відповідність категорій Розетки категоріям EVA |
| Картки | як позначати товар без бренду, країна-виробник для «No Brand», хто затверджує |
| Фото | скільки фото перевіряти одночасно |
| Що показувати | що відкривати першим, колонки таблиці, карток на сторінці, вирізане з тексту й автоматична версія (для вас) |
| Доручення | завдання з «Завдань», де відповідальна — Валентина |

## Можливі помилки

| що бачите | чому | що зробити |
| --- | --- | --- |
| «Валентини як ШІ-співробітника ще нема» | Валентину не додано в організацію | «Інтеграції → ШІ» → «Валентина» → «Додати» |
| «ШІ вимкнено» | перемикач вимкнено | увімкніть Валентину в «Інтеграції → ШІ» |
| «Затверджувати картки для EVA може лише власник» | затверджує власник | попросіть власника або змініть «Хто затверджує» |
| «У картці є помилки EVA — спершу виправте» | картка не пройшла перевірку | виправте картку й «Зберегти картку» |
| «Готових карток уже N, а не M» | поки ви підтверджували, готових стало інше число | оновіть вікно й натисніть «Затвердити готові» ще раз |
| «Відсоток має бути від −50 до +100» | відсоток поза межами | впишіть число від −50 до +100 |
| «Фото вже обробляються» | прогін фото ще йде | дочекайтеся кінця на смузі «Фото» |
| «склад Helomi не прочитано … фід EVA не перезібрано» | склад не відповів, у ньому замало товарів або в усіх 0 | перевірте «Склад → Товари»; EVA поки бачить попередній фід |
| Товар у фіді з залишком 0, хоча є | артикула картки нема на складі Helomi | додайте товар на склад з тим самим артикулом і натисніть «Перебудувати» |
| «Фід не зібрано: …» | збій під час збирання | натисніть «Перебудувати» ще раз; повторюється — напишіть адміністратору |

## Для ШІ-співробітників
- Ключ статті: `help("ai-valentyna")`; картка розділу — `/api/ai/sections/ai-valentyna`, доступ «ШІ Валентина».
- Читати: `ai_valentyna_status`, `ai_valentyna_cards` (status, q, сторінки), `ai_valentyna_card`, `ai_valentyna_feed`.
- Змінювати без підтвердження: `ai_valentyna_sync`, `ai_valentyna_card_edit`, `ai_valentyna_feed_rebuild`, `ai_valentyna_photos_run`.
- Через кошик підтверджень людини: `ai_valentyna_card_status` (затвердити, зняти, не ставити, повернути), `ai_valentyna_approve_ready` (з `expected` — скільки готових бачили), `ai_valentyna_card_reset`, `ai_valentyna_price`, `ai_valentyna_settings_save`, `ai_valentyna_enabled`. Затвердження й ціна проходять, лише коли підтвердила людина з цим правом.
- Не вигадуйте фактів про товар і не міняйте адресу фіду чи offer id: EVA вже зіставила товари.

## Додаткова інформація
- Новіша програма для EVA — [ШІ Єва](ai-eva.md); замовлення EVA в угодах — [EVA](int-eva.md); звідки товари — каталог Каті.
- У «Структурі» Валентина — та сама картка, що й була: «Відкрити» веде у вікно програми.
- Стара сторінка Валентини (адреса /apps/valentyna/) тепер відкриває це вікно. Попередня версія лишилась за адресою /apps/valentyna/v1.html; фід для EVA працює як раніше.