HelomiWIKI

ШІ Віктор — склад: збірка замовлень, наявність, повернення

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

9 хвОновлено 25.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Черга збірки з угод: етапи з роллю «Передали на збірку» у вибраних воронках, будь-якої давності.
  • Картка замовлення для збирача: позиції з фото, артикулом і місцем, ТТН і перевізник, документи угоди, коментар складу, попередження про чужу ТТН чи доставку за наш рахунок.
  • «Зібрано» → етап з роллю «Зібрано» + нотатка хто і коли зібрав; «Повернути менеджеру» → етап «Допомога» + причина.
  • Перевірка наявності: запити «перерахуйте» на товари із залишком від 1 до порога; записаний підрахунок стає рухом «перерахунок» у картці товару.
  • Розбір повернень: позиції повертаються на склад штатною дією угоди, часткове повернення лишає решту списаною.
  • Усе підписане «ШІ Віктор» у журналі картки угоди, товару і в «Журналі» пульта.
  • Гра для збирачів «ШІ Кіт» (вкладка СкладШІ Кіт«Склад → ШІ Кіт», кіт-король Кіктор) з балами за зібрані посилки й перевірки; кіт говорить через Ломі — окрема стаття.

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

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

ГрупаНалаштуванняЩо означаєТипово
ЗагальніЗастосовувати зміниВимкнено — кожна дія чекає підтвердження в журналітак
Черга збіркиЯк часто оновлювати чергу з угод, хвПеріод кроку циклу5
Черга збіркиБрати замовлення не старші за, днівВікно для «на підході» і спакованих; угоди на самій збірці беруться завжди30
Черга збіркиВоронки, з яких іде збірка«Усі» — кожна воронка, де є етап з роллю «Передали на збірку»усі
Черга збіркиКлюч поля «Доставка за наш рахунок»Так → попереджувальний стікер, посилка не йде в реєстрdostavka_za_nash_rakhunok_988
Черга збіркиКлюч поля «Коментар складу»Показується збирачу першим банеромkomientar_skladu_989
Перевірка наявностіЗапит «перерахуйте» для залишку від 1 доПоріг малого залишку5
Перевірка наявностіСканувати залишки раз на, годЯк часто дивитись склад3
Перевірка наявностіПісля підрахунку товар не смикати, днівТиша після перерахунку90
ШІ КітБали за посилку НП / іншої служби / перевіркуНарахування збирачам1 / 2 / 1
ШІ КітПадіння ситості, ласки, «разом» за годину; днів без їжіЖиття кота2 / 1,5 / 1; 5
ШІ КітКіт розмовляє; голос кота; як звучить кіт; історія котаРозмова з котом через Ломі (cat_talk, cat_voice, cat_voice_style, cat_story)так; Algieba; кіт-король; типова історія
ШІ КітКіт на збірці; розповідає серіал; як часто говорить сам; свої фразиКіктор на сторінці збірки замість старого кота (cat_buddy, cat_buddy_story, cat_buddy_every, cat_buddy_phrases)так; так; 45 с; порожньо
ШІ КітСкільки речей обстановки можна поставитиСкільки речей обстановки стоїть біля кота разом, 1–16 (cat_decor_max); місць кожного виду на сцені однаково не більше10
ШІ КітЗвуки гри; гучність звуків гриМуркотіння, мяукання, монетки й фанфари на сторінці кота й на збірці (cat_sfx, cat_sfx_volume, 5–100 %); кожен ще може вимкнути звуки на своєму пристроїтак; 60 %

Етапи Віктор не вгадує за номерами: у НалаштуванняВоронки й етапи«Налаштування → Воронки й етапи» у кожної воронки збірки мають бути етапи з ролями «Передали на збірку», «Зібрано» і «Допомога» (ролі ставляться в картці етапу). Нема ролі — крок повідомить про це в «Журналі».

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

2Увімкнути або вимкнути Віктора

ІнтеграціїШІ«Інтеграції → ШІ» → плитка «Віктор» → перемикач «Увімкнено». Те саме в пульті: ⋮Вимкнути«⋮ → Вимкнути». Вимкнений Віктор не робить нічого: цикл пропускається, кнопка «Запустити крок» сіра, інструменти інших ШІ відповідають «ШІ вимкнено». Черга на сторінці «Склад» лишається такою, як була на момент вимкнення.

3Як замовлення потрапляє на збірку

Менеджер (або автоматика каналу) переводить угоду на етап з роллю «Передали на збірку». На наступному кроці Віктор створює завдання збірки: позиції угоди, ТТН з блоку «Доставка» (остання активна; кілька активних — збірка блокується, поки менеджер не прибере зайву), перевізник за форматом номера, документи з розділу «Документи», файли угоди (стікер PDF), коментар складу. Збирач на сторінці «Склад» тисне «Почати збірку» і отримує наступне вільне замовлення. Угода, яку перевели далі вручну, зникає з черги на наступному кроці.

«Запустити крок» у пульті оновлює чергу зараз, не чекаючи періоду.

4Зібрано і «Повернути менеджеру»

«Зібрано» на сторінці «Склад» → Віктор переводить угоду на етап з роллю «Зібрано» своєї воронки і пише в картку угоди нотатку: скільки позицій і штук, хто збирав, час, ТТН. Усе видно в УгодикарткаНотатки«Угоди → картка → Нотатки» і «Журнал», автор — «ШІ Віктор». «Повернути менеджеру» з причиною → етап з роллю «Допомога» + нотатка з причиною. Якщо етап не перевівся (нема ролі, заборонений перехід) — завдання показує помилку, а Віктор повторює на наступних кроках.

5Перевірка наявності

Раз на кілька годин Віктор дивиться залишки складу і ставить запит «перерахуйте» на товари із залишком від 1 до порога (артикули А1…А9 не рахуються ніколи). Збирач рахує те, що на полиці, і вписує число. Віктор додає до нього штуки у зібраних, ще не відправлених посилках (вони зняті з полиці, але зі складу ще не списані — у картці запиту це «спаковано N») і записує залишок рухом «перерахунок» у картку товару, від свого імені. Товар, залишок якого поповнився вище порога, знімається зі списку сам.

6Повернення на склад

Повернення, забрані з пошти (Ростік відмічає «забрали»), з'являються у СкладПовернення«Склад → Повернення». Комірник відмічає кожну позицію: «товар є» або «не повертати N шт» (загублено, пошкоджено, не наш). «Повернути товар на склад» → для кожної повернутої позиції виконується штатна дія угоди «Повернути» (залишок плюс), не повернуті штуки лишаються списаними; при частковому поверненні решта списується назад, а якщо не вийшло — менеджеру ставиться завдання в угоді. У картку угоди іде нотатка з підсумком.

Важливо

Щоб товар повертався на склад лише тут, після перевірки, етап «Повернення» має «Склад: нічого» (НалаштуванняВоронки й етапи«Налаштування → Воронки й етапи», 23.10). Інакше етап повертає товар, щойно служба написала «відмова», поки посилка ще їде назад, і маркетплейси показують «в наявності» товар, якого нема на полиці. «Угода скасована» повертає товар одразу.

7Пульт Віктора і режим на весь екран

Вікно — /crm/ai/viktor («Відкрити» на картці в ІнтеграціїШІ«Інтеграції → ШІ» чи в «Структурі»): скільки зібрати, на підході, зібрано сьогодні, перерахувати, повернення; цикл; черга збірки; перевірка наявності; нижче — «Чекають підтвердження» й «Останні дії». Налаштування (НалаштуванняШІ-співробітникиВіктор«Налаштування → ШІ-співробітники → Віктор» або кружечок у вікні) — вкладки «Налаштування» (з «Доступами й лімітами»), «API», «Огляд», «Журнал» (кожен крок: що зробив або чому впав). На комп'ютері пульт відкривається на весь екран: бокове меню згортається в рейку з кнопкою ☰, розділи переїжджають на нижню панель швидкого доступу. «Згорнути» — кружечок у шапці пульта, ☰ у рейці або ⋯Згорнути панель«⋯ → Згорнути панель». Як відкривати наступного разу — Швидкий доступПульт ШІ на весь екран: як востаннє / завжди / ніколи«Швидкий доступ → Пульт ШІ на весь екран: як востаннє / завжди / ніколи». На телефоні пульт і так на весь екран, меню — у нижньому доку.

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

Як показуєтьсяЧомуЩо зробити
У «Журналі»: «у воронці «…» нема етапу з роллю «picked»»У воронці збірки нема етапу «Зібрано» (або «Допомога») з роллюНалаштуванняВоронки й етапи«Налаштування → Воронки й етапи» → картка етапу → роль
Черга порожня, хоч угоди на збірці єВоронку не вибрано в НалаштуванняхВоронки, з яких іде збірка«Налаштуваннях → Воронки, з яких іде збірка», або Віктора вимкненоУвімкнути; поставити «усі» або додати воронку
На завданні «CRM не підтвердив оновлення — повторюю»Перехід етапу заборонений правилами воронки або угоду заархівованоПеревірити угоду; Віктор повторить сам
«склад не прийняв нову кількість: …» при перерахункуАктивна інвентаризація по товару або товар видаленоЗавершити інвентаризацію / знайти товар у складі
Інструмент ai_viktor_* → 403 «ШІ вимкнено»Віктора вимкнулиУвімкнути в ІнтеграціїШІ«Інтеграції → ШІ»

Для ШІ-співробітників

Ключ розділу в каталозі — ai-viktor (describe_section("ai-viktor"), GET /api/ai/sections/ai-viktor); доступ — галочка «ШІ Віктор (склад: збірка, наявність)» у «Доступах» співробітника (Ломі має її типово).

  • ai_viktor_status — стан, налаштування, останній крок, воронки збірки.
  • ai_viktor_summary — дашборд складу (зібрати, на підході, зібрано сьогодні, перерахувати, повернення).
  • ai_viktor_queue — черга збірки; ai_viktor_stock — запити «перерахуйте»; ai_viktor_returns — повернення; ai_viktor_journal — хто що зібрав.
  • ai_viktor_run_step — крок зараз.
  • ai_viktor_settings_save — змінити налаштування (ті самі перевірки, що в пульті); ai_viktor_enabled — увімкнути/вимкнути. Обидві — через кошик підтверджень «Керування іншими ШІ» (у «Доступах» → «спочатку запитати»).
  • ai_viktor_stock_count — записати підрахунок за запитом «перерахуйте».

Не вигадуйте id угод і запитів — беріть їх з ai_viktor_queue / ai_viktor_stock; не повторюйте дію, що вже чекає підтвердження.

Додаткова інформація

Пов'язане: Склад і товари, ШІ Кіт, Угоди, Воронки й етапи, ШІ-співробітники, Ломі.

Цю саму статтю читають ШІ-співробітники Helomi: help("ai-viktor")