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

# ШІ Олесь — обробка замовлень: перевірки, ТТН, на збірку, «Допомога»

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

## Можливості
- Нові й прийняті угоди (етапи з ролями «Створено» і «Прийнято») не старші за кілька днів — під наглядом; жодних звернень до KeepinCRM.
- Перевірки ті самі, що були: дані одержувача, склад, інші угоди клієнта (дублі, активні, скасовані в історії), BlackBox, рейтинги
  Prom і Rozetka, коментар клієнта, оплата, велике замовлення, самовивіз, служба доставки.
- ТТН: Нова Пошта, Укрпошта, Meest, Rozetka Delivery — через налаштування перевізників («Інтеграції → перевізник»); Kasta — лише
  через кабінет hub.kasta.ua; «Магазини Rozetka» на Prom — через кабінет Prom; ROZETKA Delivery із замовлення Rozetka — на боці Rozetka.
- ТТН у замовлення маркетплейсу (Prom, Rozetka), вітальне «прийнято + ТТН» через Люду, етап «Передали на збірку» від імені «ШІ Олесь».
- «Допомога»: етап + нотатка з причинами й діями; «Все ок» в угоді — Олесь продовжує по позитивному сценарію.
- Правила окремо для кожного джерела (Prom, Rozetka, Kasta, Епіцентр, ОЛХ, Telegram, сайти, дропери…).
- Під себе: свій текст нотаток з полями угоди, кому задача «Допомоги» і з яким терміном, які черги й колонки бачите саме ви.
- Вікно на весь екран: скільки угод чекає допомоги й чому, що чекає оплати, що передано на збірку, «Запустити крок».

## 1. Увімкнути й відкрити Олеся: картка в «Інтеграції → ШІ»
Картка Олеся — це місце, де його вмикають, відкривають і читають про нього. Олесь з'являється сам: картка «Олесь» з пігулками стану («працює», «спить», «помилка», «вимкнено») і виду «Агент»; на ній рівно три дії — перемикач «Увімкнено», «Відкрити» і «WIKI».

1. Відкрийте «Інтеграції (головне меню) → ШІ».
2. Знайдіть картку «Олесь» і натисніть «WIKI», щоб прочитати цю статтю шторкою.
3. Увімкніть перемикач «Увімкнено» — з наступного кроку Олесь бере нові угоди.
4. Натисніть «Відкрити» — відкриється вікно Олеся з чергою «Потрібна допомога».

> [!NOTE]
> Вимкнений Олесь не робить нічого: крок пропускається, «Запустити крок» і «Все ок» сірі, інструменти інших ШІ відповідають
> «ШІ вимкнено». Вимкнути можна й у налаштуваннях Олеся: «⋮ → Вимкнути».

## 2. Розібрати «Допомогу» у вікні Олеся
Вікно — робоче місце менеджера, який розбирає «Допомогу»: що чекає людину, чому і що зробити. Ведуть туди «Відкрити» на картці в «Інтеграції → ШІ», картка «ШІ Олесь» у «Структурі» і рядок «Олесь» у «Налаштування → Команда → ШІ-співробітники».

1. Відкрийте вікно Олеся — першою стоїть черга «Потрібна допомога» з чорним числом угод.
2. Прочитайте в рядку угоди причину й «Що зробити».
3. Виправте причину в угоді (натисніть «Угода») або вирішіть на місці.
4. Натисніть «Все ок» — Олесь створить ТТН і передасть угоду на збірку; «Скасувати» — угода стане «Програно».

У шапці — ореол Олеся, ім'я, стан і кружечки «Налаштування», «Журнал», «?» (ця стаття) і «Згорнути»; «Налаштування» й «Журнал» відкриваються тут же, у вікні, — натиснутий кружечок «Назад до роботи» повертає чергу в тому самому стані. Під шапкою:
- показники: «Потрібна допомога» (чорна плитка — головне), «Чекають», «На збірку сьогодні» (за 7 днів і скільки Олесь зробив сам),
  «Повтори й помилки»;
- «Цикл»: як часто, коли був останній крок, режим перегляду, остання помилка, кнопка «Запустити крок», пігулки категорій допомоги
  («Оплата не зайшла · 3»);
- черга з вкладками «Потрібна допомога», «Чекають», «На збірку сьогодні», «Передати на маркетплейс»: назва угоди веде в картку,
  поряд джерело, клієнт, сума, товари, причина, «Що зробити»; дії «Все ок», «Скасувати», «Угода»;
- «Правила за джерелами» — посилання на таблицю в налаштуваннях і рядок, чи ставить Олесь задачі;
- «Чекають підтвердження» і «Останні дії» — спільні для всіх ШІ.

Результат кожної дії — повідомлення поверх сторінки: «Крок виконано…», «Прийнято — Олесь обробляє угоду…». Помилка не зникає сама, поки ви її не закриєте. Поки дія триває, кнопка сіра, і другий натиск нічого не надсилає. «Все ок» і «Скасувати» спершу питають підтвердження: вони створюють ТТН або закривають угоду «Програно». Що саме показувати у вікні, налаштовує кожен для себе («Налаштування», група «Що показувати»). На телефоні — ті самі блоки стовпцем, показники по два в ряд, кнопки 44 px.

## 3. Налаштувати Олеся під себе
Налаштування — це все, що Олесь робить інакше в різних компаніях: як часто, що перевіряти, кому писати й що показувати. Зміна діє з наступного кроку без перезапуску, «Скинути до типових» — на кожну групу.

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

«Для всіх» — налаштування організації, «Для мене» — ваші особисті (тон, своє доповнення до інструкції, «Що показувати»). Типові значення — це те, як Олесь працював до появи поля: нове налаштування нічого не змінює, поки ви його не чіпали. Під кожним полем — рядок, що станеться, якщо його змінити.

| Група | Налаштування | Що означає | Типово |
| --- | --- | --- | --- |
| Характер | Інструкція для ШІ (персона, промпт) | Персона Олеся для чату, MCP і файлу сесії (коли через його ключ працює ваш Claude чи ChatGPT); перевірки й рішення циклу від неї не залежать | інструкція шаблону |
| Характер | Моє доповнення до інструкції | Дописується в кінець, коли з Олесем працюєте ви («Для мене») | порожньо |
| Характер | Тон · Звертання · Мова відповідей | Як Олесь відповідає в чаті й через інших ШІ | як в інструкції · як в інструкції · українська |
| Характер | Застосовувати зміни | Вимкнено — Олесь лише вирішує й пише рішення в журнал пульта, угоди, ТТН і нотатки не чіпає | так |
| Цикл | Як часто перевіряти нові угоди, хв | Період кроку | 3 |
| Цикл | Брати угоди не старші за, днів | Старші угоди Олесь не чіпає | 7 |
| Цикл | Новій угоді дати хвилин | Пауза після створення, щоб приймання дописало поля | 3 |
| Цикл | Макс. угод за один крок | Запобіжник | 60 |
| Перевірки | Наявність на складі | Товару нема → «Допомога» (списане під цю угоду не рахується) | так |
| Перевірки | BlackBox / чекати перевірку не довше, хв | Потрібен ключ «Інтеграції → BlackBox»; сервіс лежить — відправляємо без перевірки | так / 60 |
| Перевірки | Рейтинги покупця | Prom < 95 і Rozetka не «високий» — фактор ризику (з наложкою → допомога) | так |
| Перевірки | Інші угоди клієнта | Будь-яка інша угода клієнта, крім «Отримано» і «Угода скасована», → допомога; скасовані в історії — фактор ризику | так |
| Перевірки | Коментар клієнта | Клієнт щось просить → людина має прочитати | так |
| Повідомлення менеджерам | Писати в угоду нотатку з причинами | Нотатка «Допомога» в картці угоди (текст — у групі «Тексти») | так |
| Повідомлення менеджерам | Задача в угоді при «Допомозі» | «не ставити» — черга у вікні; «одна на угоду» — Олесь сам закриває, коли угода поїхала чи скасована | не ставити |
| Повідомлення менеджерам | Кому ставити задачу «Допомоги» | Відповідальному угоди; його керівнику зі «Структури»; людині, вибраній нижче. Нема кого — відповідальному | відповідальному угоди |
| Повідомлення менеджерам | Людина для задач «Допомоги» | Наприклад, старший менеджер, що розбирає всю «Допомогу» | не вибрано |
| Повідомлення менеджерам | Термін задачі, год | Через скільки годин задача стане простроченою; 0 — без терміну | 0 |
| Повідомлення менеджерам | Позначати задачу «Важлива» | Задача вгорі списку завдань | ні |
| Тексти | Нотатка «Допомога» | Текст з підстановками `{джерело}`, `{угода}`, `{клієнт}`, `{сума}`, `{що_виправити}`, `{що_зробити}`, `{перевірено}` | текст, який Олесь писав завжди |
| Тексти | Писати нотатку «відправляємо» | Після ТТН і «Передали на збірку» — що зроблено; вимкнено — лише журнал картки | так |
| Тексти | Нотатка «відправляємо» | Підстановки `{джерело}`, `{угода}`, `{клієнт}`, `{сума}`, `{ттн}`, `{що_зроблено}`, `{перевірено}` | «ШІ Олесь · відправляємо» + що зроблено + перевірено |
| Тексти | Нотатка «скасоване, але лишаю людині» | Площадка скасувала велике замовлення чи з коментарем. Підстановки `{джерело}`, `{угода}`, `{клієнт}`, `{сума}`, `{причина}` | «…АЛЕ не переводжу в «Програно»: {причина}. Гляньте, будь ласка.» |
| Відправка | Заповнювати «Тип оплати checkbox» | Лише порожнє поле, за правилами власника (готівка, Rozetkapay, UAPay, карта, рахунок, NovaPay, еквайринг) | так |
| Відправка | Скасоване на площадці → «Програно» / лишити людині від, грн | Велика сума чи коментар — нотатка людині | так / 1000 |
| Відправка | ТТН Укрпошти передавати на маркетплейс через, хв | Угода на збірку йде одразу, номер Олесь передає сам (черга «Передати на маркетплейс») | 30 |
| Відправка | Площадка не приймає ТТН довше, хв | Після цього — нотатка «передайте вручну», угоду зі збірки не чіпає | 180 |
| Відправка | Спроб створити ТТН, коли служба тимчасово недоступна | Стільки кроків поспіль Олесь повторює; далі — «Допомога»; 0 — одразу | 3 |
| Вітальне через ШІ Люду | Слати вітальне; і постійним; канал; папки без вітального; «Дія зроблена»; вебхук Люди; коди джерел | Лише коли ТТН уже є; «Товари для авто» — без вітального | так / так / Telegram |
| Правила за джерелами | Таблиця | Що робити з угодами кожного джерела: режим, наложка, передоплата, самовивіз, рахунок, ТТН, вітальне | типові рядки нижче |
| Що показувати («Для мене») | Черга, що відкривається першою | Яку вкладку вікно показує при відкритті | «Потрібна допомога» |
| Що показувати | Черги у вікні | Зайві можна сховати | усі чотири |
| Що показувати | Що показувати в рядку черги | Джерело, клієнт, сума, товари, причина, «Що зробити», нотатка, ТТН, категорія / час; назва угоди й кнопки — завжди | усе |
| Що показувати | Порядок у черзі | Як зараз («Допомога» — найдовше чекають зверху, решта — свіжі зверху), новіші, старіші, більша сума | як зараз |
| Що показувати | Скільки рядків у черзі | Решта — у розділі «Угоди» з фільтром за етапом | 60 |
| Що показувати | «На збірку» за днів | Черга «На збірку» за стільки днів; показник лишається «сьогодні» | 1 |
| Що показувати | Показники вгорі · Категорії допомоги пігулками · Блок «Правила за джерелами» | Що з цього бачити у вікні | усі · так · так |

Текст вітального «прийнято + ТТН» пише ШІ Люда — його змінюють у Люди («Тексти» → «Прийнято + ТТН»), не в Олеся. У тексті нотатки абзац (між порожніми рядками), у якому підстановка порожня, не пишеться: так «Що зробити» зникає, коли робити нічого. Порожнє поле тексту — знову типовий текст; незнайома підстановка лишається як є.

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

## 4. Задати правила для кожного джерела
Правила — це як Олесь обробляє замовлення з кожного джерела: що перевіряти, що робити з наложкою, хто створює ТТН. Таблиця — у «Налаштуваннях», група «Правила за джерелами»: рядок «Усі інші» (`*`) і рядок на кожне джерело; можна додати шаблон за початком назви — «Сайт*» діє на всі джерела, чия назва починається з «Сайт». Порожня клітинка — «як у всіх».

| Колонка | Варіанти | Що робить |
| --- | --- | --- |
| Що робити з угодами | перевірки → ТТН → збірка; відправляти завжди; усе в «Допомогу»; не чіпати | «відправляти завжди» — лише дані й склад, без оплати/рейтингів (ОЛХ, Telegram, дропери); «не чіпати» — Епіцентр |
| Накладений платіж | за факторами ризику; завжди допомога; відправляти | Сайти типово — допомога (підтвердіть з клієнтом) |
| Передоплата не зайшла / чекати, хв | чекати, потім допомога; одразу допомога; відправляти без оплати | Типово 120 хв; сайти — добу |
| Самовивіз | допомога; як звичайну угоду | |
| Оплата на рахунок | як передоплата; завжди допомога | Сайти типово — допомога (виставте рахунок) |
| Велике замовлення від, грн | 0 — не питати | Усе перевірено, лишається лише «Все ок» людини |
| ТТН | створює Олесь; чекати від площадки; створює людина | «чекати від площадки» — ОЛХ: трек-номер OLX Доставки з коментаря угоди (пише ШІ Едуард) Олесь сам додає в «Доставку»; без номера — чекає; «людина» — «Допомога» зі словами «створіть ТТН» |
| Доставка Meest | ТТН створює Олесь; допомога | Епіцентр типово — допомога |
| Вітальне через Люду | так / ні | |
| ТТН на маркетплейс | так / ні | Prom, Rozetka і Епіцентр приймають номер у замовлення |

Типові рядки: **Епіцентр** — покупець у BlackBox + немає оплати → допомога; у BlackBox, але оплачено (статус «Кошти заблоковано/списано») → їде; нема в BlackBox + післяплата → їде; «Рахунок» чи самовивіз → допомога; перед накладною Олесь ставить замовленню «Підтверджено» на Епіцентрі; Нова Пошта → ТТН → номер на Епіцентр → збірка; Укрпошта → ТТН, збірка одразу, номер на Епіцентр через 30 хв; Meest → допомога. **ОЛХ, Telegram, Власні контакти** — відправляти завжди; єдиний виняток — покупець у BlackBox і післяплата → допомога. «На карту-ключ», «Розрахунковий рахунок» (поки оплати з банку не підтягуються) і OLX Доставка — їде. **Сайт\*** — наложка, рахунок, самовивіз → допомога; картка без оплати чекає добу. Оплату картою Олесь бере з рядка «Оплата: …» коментаря угоди: сайт сам міняє його на «Оплачено», коли клієнт заплатив, і Олесь передає угоду на збірку (у нотатці «відправляємо» — «оплачено — коментар угоди: «Оплата: Оплачено (…)»»).

## 5. Що робить крок і за якими правилами
Крок — один прохід Олеся по нових, прийнятих і «Допомозі»; він іде сам кожні кілька хвилин або з кнопки «Запустити крок».
1. Скасоване на площадці → «Програно» (крім великої суми чи коментаря — тоді нотатка людині).
2. Самовивіз, рахунок, невідомий спосіб оплати на сайті → «Допомога» за правилом джерела.
3. Дані для накладної (телефон, ПІБ, місто, відділення/адреса, товари) — беруться так само, як у шторці «Створити ТТН». Точку видачі
   НП без номера («с. Милування, Пункт приймання-видачі (до 30 кг): вул. Миру, 78 А» — Prom № не пише) Олесь підбирає сам у довіднику
   НП: місто → точки без поштоматів → одна з такою вулицею й будинком (або єдина в селі); нуль чи кілька збігів — «Допомога».
   Готівка без жодних даних про доставку (власні контакти) — це «самовивіз / передача особисто», а не «неповні дані».
   Поле «Спосіб доставки» (список: Нова Пошта / Укрпошта / Meest Пошта / Rozetka Delivery / OLX Доставка / Самовивіз) Олесь
   заповнює сам тим, чим відправив, коли воно порожнє; трек OLX у коментарі → «OLX Доставка» завжди.
   Адреси з сайтів («Нова Пошта — відділення, поштомат або курʼєр, Дніпро, Відділення №181 …», «Укрпошта — відділення, м. Київ, …,
   02125 …») читаються без назви способу доставки попереду — для всіх служб; службові рядки сайту в коментарі («Оплата: При
   отриманні») не вважаються коментарем покупця.
   «ТТН: чекати від площадки» (ОЛХ) діє лише для OLX Доставки (оплата «ОЛХ доставка» або трек у коментарі Едуарда): ОЛХ з оплатою
   на карту й «Укрпошта 21036» Олесь відправляє сам, Укрпошті вистачає індексу без міста.
4. Склад: вільний залишок менший за потребу → «Допомога» («немає в наявності»).
5. Інші угоди клієнта: усі отримані — добре; будь-яка інша (і на збірці, і відправлена, і дубль без оплати) — допомога з назвою й
   етапом тієї угоди, бо клієнт замовляє знову, ще не отримавши; скасовані в історії — фактор ризику. Коли ту угоду отримають чи
   скасують — Олесь продовжить сам. Джерела «відправляти завжди» (ОЛХ, власні контакти, дропери) цю перевірку не роблять.
6. BlackBox: знайдено — фактор; не перевірено — чекаємо до «Чекати не довше»; сервіс недоступний — їдемо.
7. Рейтинги Prom/Rozetka, джерело Епіцентр — фактори; коментар клієнта — допомога.
8. Оплата: наложка + фактори → допомога; наложка без факторів → їдемо; передоплата не зайшла → чекаємо, потім допомога; оплачено →
   їдемо навіть з факторами. **Без оплати передоплатне замовлення не їде ніколи — лише з «Все ок».** «Оплачено» — це гроші в угоді,
   поле статусу оплати площадки чи сайту або, в угоді сайту, рядок «Оплата: Оплачено» в коментарі (сайт оновлює його сам).
9. Служба: не розпізнано → допомога; велике замовлення → допомога (лишається підтвердити).
10. Відправка: «Тип оплати checkbox» → ТТН (жива накладна в угоді береться як є; оплачено + післяплата в ТТН → допомога; служба
    тимчасово недоступна — повтор наступним кроком, «Спроб створити ТТН» разів); Укрпошта з пріоритетною доставкою в замовленні (Prom:
    тариф «Приоритетный» у полі prom_delivery_tariff) — тип відправлення Експрес → ТТН на маркетплейс → вітальне (лише з ТТН, лише
    брендам з каналом Люди, не «Товари для авто») → «Передали на збірку» → нотатка «відправляємо» (якщо ввімкнено).

## 6. Вирішити угоду на «Допомозі»: «Все ок»
«Допомога» — етап, на якому угода чекає рішення людини; «Все ок» — рішення «відправляємо». Угода на «Допомозі» має нотатку «ШІ Олесь · потрібна допомога» (що виправити, що зробити, що перевірено; текст — «Тексти → Нотатка «Допомога»») і смугу Олеся вгорі картки.

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

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

Задачі: типово Олесь задач не створює; з «Задача в угоді при «Допомозі» → одна на угоду» — одна задача на угоду («Допомога: <джерело>: <причина>») тому, кого вибрано в «Кому ставити задачу», з терміном і позначкою «Важлива» за налаштуванням. Олесь сам закриває її, коли угода поїхала чи скасована.

## 7. Дати Олеся іншим ШІ: API і «Вхід для ШІ»
Вкладка «API» в налаштуваннях Олеся показує, чим ним керують інші ШІ і як підключити свою програму.

1. Натисніть кружечок «Налаштування» у вікні Олеся і перейдіть на вкладку «API».
2. Прочитайте у «Вхід для ШІ», які інструменти Олеся бачать інші ШІ і хто з них має доступ.
3. Дайте доступ Ломі чи Остапу: у їхніх налаштуваннях, у «Доступах і лімітах», поставте галочку «ШІ Олесь».

- «Вхід для ШІ» — картка розділу «ШІ Олесь» для ШІ: усі інструменти `ai_oles_*` з підписами («читає» / «змінює», що питає людину) і
  хто з мозків (Ломі, Остап) має доступ. Доступ дається галочкою «ШІ Олесь» у «Доступах і лімітах» того ШІ.
- «Токени · N» — ключі для своїх програм: «Новий токен», «Відкликати» (з попередженням).
- «Підключити» — файл сесії для Claude, ChatGPT, Kimi чи Gemini, адреси MCP і REST.

Вкладка «Огляд» — службовий стан (дій сьогодні, чекають підтвердження, токени й витрати), «Журнал» — кожен крок з підсумком («перевірено 12 угод: на збірку 9, допомога 2…») і фільтрами «помилки / очікують / виконано».

## Можливі помилки
| Текст | Чому | Що зробити |
| --- | --- | --- |
| «Олеся вимкнено — увімкніть в «Інтеграції → ШІ»» | Перемикач вимкнено | Увімкнути на картці |
| «не вдалося створити ТТН: …» (в нотатці) | Відмова перевізника / нема акаунта в «Інтеграціях» / кілька міст з однією назвою | Виправити адресу чи акаунт, натиснути «Все ок» або створити ТТН руками |
| «ТТН … створено, але не передано на маркетплейс» | Площадка не прийняла номер у цьому статусі («ЕН вже додана» — не помилка: номер уже там, Олесь іде далі) | «Доставка → ⋮ → Передати ТТН на маркетплейс» після зміни статусу |
| «точка видачі НП: … не знайдено однозначно» | У місті кілька точок з такою вулицею або довідник НП не знайшов місто | Вибрати відділення зі списку в шторці «Створити ТТН» і натиснути «Все ок» |
| «в угоді ТТН … з післяплатою, а замовлення оплачене» | Чужа накладна з наложкою на оплачене замовлення | Перестворити накладну без післяплати |
| «служба тимчасово недоступна — спроба n/3» | Збій служби | Нічого: повторить наступним кроком (скільки разів — «Відправка → Спроб створити ТТН») |
| «Людина для задач «Допомоги»: такого запису в організації нема» | Вибрану людину видалили | Вибрати іншу або «відповідальному угоди» |

## Для ШІ-співробітників
Ключ розділу в каталозі — `ai-oles` (`describe_section("ai-oles")`, `GET /api/ai/sections/ai-oles`); доступ — галочка «ШІ Олесь (замовлення: перевірки, ТТН, збірка, «Допомога»)» у «Доступах» співробітника (Ломі має типово).
- `ai_oles_status` — стан, налаштування, правила за джерелами, останній крок.
- `ai_oles_summary` — зведення: допомога за категоріями, чекають, на збірку сьогодні, повтори, помилки, автономність.
- `ai_oles_queue` (kind = help | wait | shipped | retry | errors; days — «На збірку» за скільки днів), `ai_oles_deal` (deal_id) — черга
  й стан угоди з причинами і діями.
- `ai_oles_rules` — чинне правило для кожного джерела; `ai_oles_help_stats` (days) — чому угоди йшли в «Допомогу», за категоріями.
- `ai_oles_process` — обробити угоду зараз; `ai_oles_run_step` — крок зараз.
- `ai_oles_ok` — «Все ок» для угоди (кошик підтверджень «масові дії»); `ai_oles_cancel` — скасувати → «Програно» (кошик «видалення»).
- `ai_oles_settings_save` (ті самі ключі, що в «Налаштуваннях»: `help_task_to`, `help_note_text`, `ship_note`, `ttn_retry_max`,
  `instructions`…), `ai_oles_enabled` — через кошик «Керування іншими ШІ».
Не вигадуйте id угод — беріть їх з `ai_oles_queue`; не повторюйте дію, що вже чекає підтвердження; без оплати передоплатне замовлення відправляє лише людина через «Все ок». «Що показувати» — особисте налаштування людини: його не змінюють за неї.

## Додаткова інформація
Статті: [Угоди](deals.md), [Доставка і ТТН](shipping.md), [ШІ Ростік](ai-rostik.md), [ШІ Віктор](ai-viktor.md), [BlackBox](int-blackbox.md), [ШІ-співробітники](ai-employees.md).