# ШІ-співробітники — WIKI Helomi > Ломі і ваш власний ШІ, ШІ-програми й ШІ-агенти: що роблять, як увімкнути й налаштувати. --- # ШІ-співробітники ШІ-співробітник — обліковий запис для штучного інтелекту, який працює в Helomi як звичайний працівник: бачить лише відкриті йому розділи, діє тими самими кнопками-діями з тими самими перевірками, а все зроблене підписане його іменем у журналі. ШІ бувають трьох видів: **мозки**, що керують рештою (Ломі — з ключем API організації, і Остап — ваш власний Claude, ChatGPT, Kimi чи Gemini), **програми** зі своїм вікном (Артур «Що купити», Богдан «Закупівлі») і **агенти**, що працюють циклом на сервері (Віктор, Ростік, Марія, Свєта, Олесь). ## Можливості - Три види ШІ пігулкою на картці: «Мозок», «Програма», «Агент». - Картка в «Інтеграції → ШІ» з трьома діями: «Увімкнено», «Відкрити», «WIKI». - Вікно кожного ШІ на весь екран з однаковою шапкою: «Налаштування», «Журнал», «?», «Згорнути»; налаштування відкриваються тут же, у вікні. - Налаштування з чотирьох вкладок: «Налаштування» (з «Доступами й лімітами»), «API» (з «Входом для ШІ» і токенами), «Огляд», «Журнал». - «Характер» першою групою в кожного ШІ: інструкція (промпт), своє доповнення «для мене», тон, звертання, мова, «застосовувати зміни». - Налаштування «Для всіх» і «Для мене»; доступи, «Спочатку запитати», ліміти, права творця. - Файл сесії, токени, MCP, REST і OpenAPI для Claude, ChatGPT, Kimi, Gemini і своїх програм. - Кошик підтверджень: видалення, гроші, масові дії й відправки назовні чекають «Підтвердити». ## 1. Де шукати ШІ - **«Інтеграції → ШІ»** — картка кожного ШІ організації, шаблони каталогу, яких ще нема, і картка «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM». Нижче — «Ключі моделей» (Anthropic, OpenAI, Kimi, Gemini). - **«Налаштування → Команда → ШІ-співробітники»** — той самий перелік рядками; клік по рядку відкриває налаштування ШІ: у ШІ з вікном — у його вікні, у Ломі й Остапа — тут же. - **«Структура компанії»** — картка ШІ у своєму відділі; «Відкрити» веде у вікно ШІ. Ключ моделі потрібен лише тоді, коли модель викликає сам Helomi (Ломі, чат з агентом): «Інтеграції → ШІ → Anthropic (Claude)» (або інший) → вставити ключ → «Перевірити» покаже доступні моделі. Остапу й іншому зовнішньому ШІ ключ не потрібен — думає ваша підписка. Додає співробітника, вмикає й змінює його доступи адміністратор організації; налаштування «для мене» змінює кожен; спільні — адміністратор або той, хто підключив ШІ. ## 2. Картка в «Інтеграції → ШІ» Картка показує, чи працює ШІ зараз, і веде до нього: фото в ореолі, ім'я, роль, пігулку стану («працює», «спить», «помилка», «очікує підтвердження»), пігулку виду («Мозок», «Програма», «Агент»), тихим рядком модель і хто підключив. Дій рівно три: 1. **«Увімкнено»** — перемикач. Вимкнений ШІ не робить нічого: цикл пропускається, інструменти й токени не діють (відповідають «ШІ вимкнено»). Вмикає адміністратор. 2. **«Відкрити»** — вікно ШІ (розділ 3): програма — її робоче місце, агент — його «Огляд» на весь екран, Ломі — її віконце, Остап і свій ШІ — налаштування на вкладці «API». 3. **«WIKI»** — стаття саме цього ШІ шторкою: що робить, як налаштувати, що бачить у вікні. Налаштувати й підключити ШІ — у його вікні, кружечок «Налаштування» праворуч угорі. Шаблон каталогу, якого в організації ще нема, має «Додати» і «WIKI». Картка «Остап» має «Підключити» і «WIKI»: свого Остапа може підключити кожен (стаття «Остап»). На телефоні картки — в одну колонку, кнопки великі. ## 3. Вікно Вікно — робоче місце ШІ на весь екран: бокове меню згортається в рейку ☰, розділи переїжджають на нижню панель швидкого доступу, усе вікно — робочий простір. Адреса програми — своя (`/crm/artur`, `/crm/procurement`), агента — `/crm/ai/<ключ>` (`/crm/ai/viktor`, `/crm/ai/rostik`, `/crm/ai/maria`, `/crm/ai/sveta`, `/crm/ai/oles`). Шапка однакова для всіх: ореол, ім'я, роль і «порахував / крок о …», пігулки стану й виду, праворуч кружечки: - **«Налаштування»** — налаштування цього ШІ (розділ 4) тут же, у вікні: вміст під шапкою змінюється на налаштування, сторінка не змінюється, меню лишається в рейці. Кружечок стає натиснутим і зветься «Назад до роботи» — натиснули, і вікно знову показує роботу ШІ в тому самому стані. Кнопка «назад» браузера теж повертає роботу; - **«Журнал»** — налаштування на вкладці «Журнал», так само у вікні; - **«?»** — стаття WIKI цього ШІ; - **«Згорнути»** — повернути звичайну розкладку (меню й сторінку). Вихід з вікна теж повертає все як було; ваш особистий режим налаштувань «на весь екран» вікно не змінює. Під шапкою агента — його «Огляд»: KPI (одна чорна — головна метрика), черги й головна дія («Запустити крок»), нижче — «Чекають підтвердження» й «Останні дії». Якщо ШІ в організації ще нема — вікно підкаже три кроки: «Інтеграції → ШІ» → «Додати» → увімкнути. ## 4. Налаштування Тут ШІ налаштовують під себе: як він поводиться, що робить і з якими правами. Кожне поле має рядок-підказку під собою; змінили — ШІ бачить це з наступного кроку, без перезапуску. Відкривається кружечком «Налаштування» у вікні ШІ — **у тому самому вікні**: сторінка не змінюється, меню лишається в рейці, шапка вікна теж; під нею замість роботи — налаштування (адреса вікна з `?view=settings&tab=…`, наприклад `/crm/ai/viktor?view=settings&tab=api`). У шапці замість дій сторінки стають «Чат з агентом» (коли модель викликає Helomi) і «⋮»: «Увімкнути / Вимкнути», «Скинути налаштування до типових» (з підтвердженням), «Інструкція (WIKI)», «Вхід для ШІ», «Показати пояснення», «Видалити». Повернутися до роботи — той самий кружечок («Назад до роботи») або «назад» браузера. У ШІ без вікна (Ломі, Остап, зовнішній ШІ) налаштування — окрема сторінка `/crm/settings/ai-employees/` (рядок у «Налаштування → Команда → ШІ-співробітники»). Її шапка — та сама, що у вікна, плюс кружечки «Відкрити вікно», «Чат з агентом», «Журнал», «?», «Згорнути» і той самий «⋮». Стара адреса `/crm/settings/ai-employees/` ШІ з вікном сама веде у вікно з налаштуваннями — місце налаштувань одне. Вкладки — саме в такому порядку: **Налаштування · API · Огляд · Журнал**; вкладка — у адресі (`tab=…`), тож оновлена сторінка відкривається на ній же. Старі адреси `?tab=access` і `?tab=connect` відкривають «Налаштування» (одразу на «Доступах і лімітах») і «API». На телефоні вкладки гортаються вбік, поля — в один стовпець. Форма будується з налаштувань шаблону групами. Угорі перемикач «Для всіх» (діють для всієї організації) і «Для мене» (лише для вас; спільні поля показано сірим з підписом «спільне»). «Скинути до типових» — на групу. Внизу — «Скасувати» і «Зберегти». ### Характер Перша група в кожного ШІ: якою людиною він є для вас. Типові значення — ті, з якими ШІ працював досі. | Поле | Що означає | Типово | | --- | --- | --- | | «Інструкція для ШІ (персона, промпт)» | Те, що ШІ читає першим у чаті, MCP і файлі сесії: хто він, як працює, чого не робить. Порожньо — інструкція шаблону | інструкція шаблону | | «Моє доповнення до інструкції» | Ваше особисте доповнення («пиши мені коротко», «рахуй у доларах») — дописується в кінець, коли з ШІ працюєте ви (вкладка «Для мене») | порожньо | | «Тон» | Діловий чи дружній; у Ломі типово дружній | як в інструкції | | «Звертання» | «Ви» чи «ти» | як в інструкції | | «Відповідати як у розмові» (Ломі) | Коротко, як голосом, — чи зі списками й таблицями | так | | «Підпис у нотатках» (Ломі) | Чим ШІ підписує нотатки від вашого імені | порожньо | | «Мова відповідей» | Українська чи англійська | українська | | «Застосовувати зміни» | Увімкнено — ШІ змінює записи сам, і все підписано в журналі; вимкнено — кожен запис чекає «Підтвердити» | так (у Ломі й агентів) | Далі — групи самого ШІ (черга, пороги, етапи, розклад, тексти) — у статті кожного ШІ. У Ломі — ще «Робота», «Голос», «Екран Ломі» (стаття «Ломі»). ### Доступи й ліміти Що ШІ може робити від свого імені: які розділи бачить, з якими компаніями працює, які дії чекають вашого «Підтвердити», скільки запитів і токенів може витратити. Блок унизу вкладки «Налаштування»; змінює адміністратор (або той, хто підключив ШІ), іншим показано рядок «Доступи й ліміти змінює адміністратор». - «Права творця» — «Свої розділи», «Свої ШІ-агенти», «Свої розширення (код)» (стаття «ШІ-творець»). Типово вимкнені; над ними — жовте попередження: видавайте лише тому ШІ, якому довіряєте. - «Інтеграції» → «Налаштування інтеграцій» — ШІ читає й пропонує зміни в картках перевізників (Нова Пошта, Укрпошта, Meest, Rozetka Delivery); кожна зміна чекає «Підтвердити» адміністратора, ключі й токени ШІ не бачить (стаття «Інтеграції — вхід для ШІ»). Разом із галочкою ставиться розділ «Інтеграції». - «Розділи» — інструменти ШІ є лише для відмічених розділів; «ШІ Віктор», «ШІ Ростік»… — доступ до «Входу для ШІ» цього агента (так Ломі чи Остап ним керують). «Працює з усіма компаніями й брендами» — інакше лише з тими, що відмічені в «Користувачах». - «Спочатку запитати» — «Видалення», «Масові дії», «Платежі й гроші», «Відправка назовні (SMS, листи, ТТН)», «Керування іншими ШІ». Під кожною галочкою — що станеться; зняли — жовте попередження, що ШІ робитиме це без вашого «Підтвердити». Такі дії чекають підтвердження 24 години. - «Ліміти» — «Запитів на хвилину» (типово 60), «Дій на день» (5 000; 0 — без ліміту), «Токенів моделі на місяць» (0 — без ліміту; вичерпано — ШІ «спить» до нового місяця). - «Зберегти доступи» — діють з наступного запиту ШІ. «Налаштування CRM» для ШІ закриті завжди: змінювати поля, воронки, права й налаштування компанії ШІ не може. Єдиний виняток — налаштування перевізників з доступом «Налаштування інтеграцій», і лише через «Підтвердити» адміністратора. ## 5. API Як ШІ підключають ззовні й чим ним керують інші ШІ: «Вхід для ШІ», токени, файл сесії, адреси MCP і REST. Тут видно, що саме бачать і можуть Ломі, Остап, ваш Claude чи своя програма. ### Вхід для ШІ Чим цей ШІ керується ззовні: картка `/api/ai/sections/ai-<ключ>` з інструментами `ai_<ключ>_*` (стан, налаштування, крок, черга, увімкнути/вимкнути, головні дії) — кожен з підписом «читає» чи «змінює» і, якщо дія небезпечна, «питає людину». Нижче — стаття для ШІ (`help("ai-<ключ>")`) і **хто з мозків має доступ**: Ломі чи Остап, у кого в «Доступах і лімітах» стоїть галочка «ШІ <ім'я>» (ім'я веде в їхні налаштування). Для мозку (Ломі, Остап) — навпаки: перелік ШІ, якими він керує, з «Відкрити» і «Вхід для ШІ». ### Токени й підключення - «Модель» — «Провайдер» і «Модель» (список приходить з ключа), «Зберегти модель». «Без моделі — зовнішній ШІ» означає, що думає ваш ШІ на своєму боці. - «Токени · N» — «Новий токен» (показується один раз, скопіюйте одразу), таблиця з «Початок» і «Останнє використання», «Відкликати» (діє миттєво — над таблицею про це жовте попередження; спершу створіть новий токен). - «Файл сесії — підключити свій чат без ключа API» — навичка для Claude або файл .md для ChatGPT, Kimi, Gemini. В Остапа це головна дія вкладки: чорна «Створити ключ і завантажити файл» і три кроки «скачав → кинув у чат → ШІ заходить у CRM і робить». - «Адреси й інструкція» — MCP, REST, OpenAPI з «Скопіювати», кроки для Claude, ChatGPT, Kimi і своєї програми, «Що знає агент» (його інструкція з «Характеру», налаштування й розділи), текст відповідальності з датою згоди. Покроково для кожного ШІ — стаття «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM». ## 6. Огляд Службовий стан ШІ: «Дій сьогодні», «Чекають підтвердження», «Токени моделі за місяць», «Витрати за місяць», нижче — кошик «Чекають підтвердження» і «Останні дії». Робочих черг агента тут нема — вони у вікні: «Назад до роботи» вгорі вкладки (у налаштуваннях без вікна — «Відкрити вікно»; у Богдана — ще «Черги й KPI агента», `/crm/ai/bogdan`). ## 7. Журнал Пласкі рядки: час, що викликано (інструмент, «чат» чи «крок»), підсумок, стан. Фільтри «усі», «помилки», «очікують», «виконано». Сюди ж веде кружечок «Журнал» у вікні ШІ. ## 8. Додати ШІ-співробітника 1. «Інтеграції → ШІ» → картка шаблону → «Додати» (або «Налаштування → Команда → ШІ-співробітники» → «Додати»). 2. У шторці «Додати ШІ-співробітника» оберіть: - «З каталогу» — готовий співробітник платформи з роллю й налаштуваннями (Ломі, агенти організації); - «Остап — свій ШІ» — ваш Claude, ChatGPT, Kimi чи Gemini через файл сесії або MCP; - «Своя програма» — токен і REST для вашого коду. 3. «Ім'я в CRM» — так ШІ буде підписаний у журналі угод і клієнтів. 4. Прочитайте «Відповідальність» і поставте «Розумію: за дії ШІ відповідає той, хто його підключив». 5. «Підключити». Відкриються налаштування на вкладці «API» — підключити свій чат чи програму. «Помічника» в каталозі більше нема: він злитий з Ломі (власник 22.10). Наявні «Помічники» стали Ломі з тими самими налаштуваннями, токенами й журналом; якщо Ломі в організації вже була — «Помічник» пішов в архів, а його токени відкликано. ## 9. Підтвердити або відхилити дію ШІ Коли ШІ просить видалити, провести платіж, зробити масову дію чи відправити щось назовні (або коли «Застосовувати зміни» вимкнено), дія не виконується, а з'являється карткою «Чекають підтвердження» — у вікні агента, на вкладці «Огляд» і прямо в чаті під відповіддю ШІ (Ломі, «Чат з агентом»): що саме, коли й чому. «Підтвердити» виконує її тим самим кодом, що й кнопка людини; «Відхилити» скасовує; результат — повідомленням поверх сторінки (у чаті Ломі — рядком у розмові). Хто натиснув, записано в кошику, журналі ШІ і в журналі запису: у «Фінансах», угодах і клієнтах автором стоїть ШІ з припискою, наприклад «Ломі ШІ · підтвердження: Ім'я Прізвище». Через 24 години невирішена дія застаріває. Підтверджує адміністратор або той, хто підключив цього ШІ; зміну налаштувань інтеграції — лише адміністратор, і її показано рядками «було → стане». ## 10. Чат, вимкнути, видалити - «Чат з агентом» — кружечок у шапці налаштувань, шторка справа, якщо модель викликає Helomi (провайдер не «Без моделі»). Під відповіддю видно, які дії виконано, а дія, що чекає згоди, — карткою з «Підтвердити» / «Відхилити». Історія чату зберігається у вашому браузері. - «⋮» у шапці налаштувань: «Вимкнути» / «Увімкнути», «Скинути налаштування до типових» (питає «так чи ні»: зміни «Для всіх» зникнуть, «Для мене» лишаються), «Видалити» (питає; токени відкликаються одразу, журнал лишається). Вимкнений співробітник не працює і файл сесії не отримує. - Результати дій — повідомленням поверх сторінки: «зроблено» зникає саме, помилка висить, поки не закриєте. На телефоні шапка стискається до імені й стану, вкладки гортаються вбік, чат — на весь екран. ## Можливі помилки | Що ви бачите | Чому | Що зробити | | --- | --- | --- | | «Щоб підключити ШІ, потрібно погодитися з умовами («Розумію»)» | Не поставлено «Розумію» | Поставте галочку | | «Потрібні права адміністратора» / «Змінює адміністратор або той, хто підключив цього ШІ» | Ви не адміністратор | Попросіть адміністратора | | «Тариф «…» дозволяє до N …» | Ліміт ШІ-співробітників тарифу | Зверніться до адміністратора платформи | | «Шаблон каталогу не знайдено» | Шаблону нема в каталозі (наприклад, «Помічник» — злито з Ломі) | Додайте Ломі або Остапа | | «Немає ключа моделі: додайте його в «Інтеграції → ШІ → …»» | Для чату потрібен ключ | Додайте ключ або виберіть «Без моделі» | | «Це зовнішній ШІ: він працює через MCP або REST, вбудованого чату в нього нема» | Провайдер «Без моделі» | Підключіть свій ШІ на вкладці «API» | | «Забагато запитів: ліміт N на хвилину. Спробуйте за … с» | Спрацював ліміт | Зачекайте або збільште ліміт у «Доступах і лімітах» | | «Вичерпано ліміт N дій на день…» / «Вичерпано місячний ліміт токенів моделі» | Денний чи місячний ліміт | Збільште ліміт у «Доступах і лімітах» | | «Токен ШІ недійсний або відкликаний» | Токен відкликано або скопійовано з помилкою | Створіть новий токен на вкладці «API» | | «ШІ-співробітника «…» вимкнено» | Співробітника вимкнено | Перемикач «Увімкнено» на картці або «⋮ → Увімкнути» | | «Строк підтвердження минув (24 год)» | Дію не підтвердили вчасно | Попросіть ШІ повторити | | «Зміни налаштувань інтеграцій підтверджує адміністратор» | Ви підключили цього ШІ, але не адміністратор | Попросіть адміністратора | ## Для ШІ-співробітників - Перед роботою з розділом прочитайте `describe_section("")`: там `intro` (для чого розділ), `wiki.sections` (розділи статті) і `hint` кожного поля. Подробиці одного розділу статті — `help("", "<розділ>")`, а не вся стаття. - Іншими ШІ (програмами й агентами) керуйте через їхній «Вхід для ШІ»: `describe_section("ai-")` і інструменти `ai__*`; доступ дає галочка «ШІ <ім'я>» у ваших «Доступах і лімітах». Небезпечне (вимкнути, скинути, змінити налаштування) — через кошик підтверджень. - Список своїх дій, що чекають людини, — `pending_actions`. Якщо інструмент повернув `pending_id` — скажіть людині, що дія чекає підтвердження, і не повторюйте її. - Ваша інструкція — з «Характеру» в налаштуваннях: її змінює людина, не ви. - Створювати й налаштовувати своїх агентів може лише ШІ з правом творця «Свої ШІ-агенти» і лише створених собою: `agents_templates`, `agents_list`, `agents_get`, `agents_create`, `agents_update`, `agents_settings_get`, `agents_settings_save`, `agents_connection`, `agents_token_create`, `agents_archive` (архів чекає підтвердження). Агенту не можна дати розділи чи компанії, яких нема в самого творця, і права творця. ## Додаткова інформація - Пов'язані статті: [Ломі](kamila.md), [Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM](ai-ostap.md), [ШІ-творець](ai-creator.md), [Люди, ролі, доступи](settings-access.md), [Ключі моделей](int-ai-keys.md); агенти й програми — [Віктор](ai-viktor.md), [Ростік](ai-rostik.md), [Марія Йосипівна](ai-maria.md), [Свєта](ai-sveta.md), [Олесь](ai-oles.md), [Артур](ai-artur.md), [Богдан](ai-bogdan.md). - Сторінка «Налаштування → Команда → Каталог ШІ» — старий каталог карток ШІ для «Структури» (фото, відділ, відповідальні); це не ШІ-співробітники. --- # Ломі Ломі — ШІ-помічниця-агент Helomi і один із двох мозків (поруч з Остапом): ви кажете, що зробити, а вона робить це в CRM за вашими доступами — знаходить, створює і змінює угоди, клієнтів, задачі й документи, дивиться склад, керує програмами й агентами CRM через їхній «Вхід для ШІ». Думає вона Claude з ключем API організації (або вашим Claude, ChatGPT, Kimi чи Gemini), а діє як окремий співробітник зі своїм іменем у журналі; гроші, видалення, масові дії й відправки назовні — лише після вашого «так». З 22.10 у ній і колишній «Помічник». Ім'я Ломі розшифровується як «Легкий Облік, Мудрий Інтелект», а назва Helomi читається як «Hello, Lomi»: відкрили програму — привіталися з нею. ## Можливості - Шаблон каталогу «Ломі» з роллю «Помічниця-агент: кажете, що зробити, — робить у CRM за вашими доступами». - Працює у вашому застосунку Claude (навичка за підпискою), у ChatGPT, Kimi, Gemini (файл .md), у Claude Code, Cursor чи іншому клієнті MCP. - Угоди, клієнти, задачі, документи, склад (перегляд), фінанси (журнал, гаманці, звіти будь-якого виду, «Вхідні», нова операція, кілька операцій одним записом, зміна, переказ — з вашого «так», видалення — з окремого «так»; поля операції — з «Типи даних → Фінанси»), ТТН з угоди (перелік, статус, створення — з вашого «так»), прайс-лист, каса (перегляд), закупівлі (перегляд), дашборд директора і Марія Йосипівна (звіт за період, аналітика, прогноз, запитання про цифри) — у межах «Доступів». - «Характер»: інструкція (її персона), своє доповнення для кожної людини, тон, звертання, «як у розмові», підпис у нотатках, мова. - Керує ШІ-програмами й агентами (Віктор, Ростік, Марія, Артур…) — тими, на кого їй поставили галочку «ШІ <ім'я>». - Небезпечне — через «Підтвердити / Відхилити» в налаштуваннях («Огляд») і у вікні агента. - Голосовий екран із живим кругом на кожній сторінці Helomi: з ключем організації робить ті самі дії в CRM (див. розділ 7). ## 1. Налаштування Ломі — звичайний ШІ-співробітник виду «Мозок». Її картка — «Інтеграції → ШІ → Ломі» з трьома діями: перемикач «Увімкнено», «Відкрити» (її віконце або весь екран, як ви звикли) і «WIKI» (ця стаття). Налаштування — «Налаштування → Команда → ШІ-співробітники → Ломі» (або кружечок «Налаштування» в її шапці): чотири вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API» (підключення, токени, файл сесії, «Вхід для ШІ» — ШІ, якими вона керує), «Огляд», «Журнал». Додає, вмикає й підключає адміністратор організації. Типово їй відкрито «Угоди», «Клієнти», «Завдання», «Склад», «Документи», «Фінанси», «Дашборд фінансів», «Прайс-лист», «Каса», «Закупівлі», «Створити ТТН», «Дашборд директора». З 20.10 «Фінанси» (операції, гаманці, банки — інструменти `finance_*`, `monobank_*`, `novapay_*`, `bank_payment*`) і «Дашборд фінансів» (інструменти `maria_*`) — окремі галочки в її «Доступах і лімітах». Коли в шаблоні з'являються нові розділи, наявна Ломі отримує їх сама при наступному зверненні; те, що ви вимкнули їй у «Доступах і лімітах», не вмикається назад. «Налаштування CRM» для ШІ закриті завжди. Мозок типово зовнішній («Без моделі — зовнішній ШІ»): ключ API організації для роботи через ваш чат не потрібен. ## 2. Додати Ломі Ломі з'являється в організації сама. Якщо її прибрали: Спосіб 1: «Інтеграції → ШІ» → картка «Ломі» з позначкою «не додано» → «Додати» → поставте «Розумію» → «Підключити». Відкриються її налаштування на вкладці «API». Спосіб 2: «Налаштування → Команда → ШІ-співробітники → Додати → З каталогу» → шаблон «Ломі» → «Розумію» → «Підключити». За потреби змініть «Ім'я в CRM» — під цим іменем вона підписуватиме зміни в журналі. ## 3. Підключити свій Claude, ChatGPT, Kimi, Gemini **Застосунок Claude за підпискою.** Налаштування Ломі → «API → Файл сесії» → «Claude» → «Створити ключ і завантажити файл». Завантажиться `helomi-kamila-claude-skill.zip`. У Claude: «Налаштування → Можливості → Навички → Завантажити». Далі кажете чи пишете Claude: «Ломі, покажи прострочені угоди», «створи задачу на завтра по угоді 4321». У навичці — персона Ломі, її налаштування і ключ. Ключ діє як пароль, відкликається в «API → Токени». **ChatGPT, Kimi, Gemini.** Той самий блок «Файл сесії» → «ChatGPT», «Kimi» або «Gemini» → файл .md для чату, інструкцій GPT або Gem. **Claude Code, Cursor, будь-який клієнт MCP.** «API → Токени → Новий токен», адреса `<сайт>/mcp` і заголовок `Authorization: Bearer <токен>`. Під час підключення сервер сам передає клієнту персону Ломі. Застосунок claude.ai у «Connectors» не дає вписати заголовок з токеном, тому для нього — файл сесії (навичка), а не адреса MCP. Докладно — стаття «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM» (колишня «Підключити свій Claude, ChatGPT, Kimi, Gemini»). ## 4. Налаштування Ломі Вкладка «Налаштування». Поля з позначкою «для мене» кожна людина ставить собі сама (перемикач «Для мене»). Перша група — «Характер»: | Поле | Типово | Що означає | | --- | --- | --- | | «Інструкція для ШІ (персона, промпт)» | персона Ломі | що Ломі читає першим у чаті, на екрані, у MCP і файлі сесії; порожньо — типова персона | | «Моє доповнення до інструкції» (для мене) | — | ваше особисте («пиши мені коротко») — дописується, коли з нею працюєте ви | | «Тон» (для мене) | дружній | діловий або дружній | | «Звертання» (для мене) | ви | на «ви» або на «ти» | | «Відповідати як у розмові (коротко, без списків)» (для мене) | так | для голосу й живої розмови | | «Підпис у нотатках» (для мене) | — | чим вона підписує нотатки від вашого імені (поле колишнього «Помічника») | | «Мова відповідей» | uk | українська або англійська | | «Застосовувати зміни (інакше кожен запис чекає підтвердження)» | так | повноцінний агент: записи одразу; вимкнете — кожен запис піде в «Чекають підтвердження» | Далі — «Робота»: | Поле | Типово | Що означає | | --- | --- | --- | | «Перед кожною зміною спитати «так чи ні»» (для мене) | так | Ломі в розмові спершу описує зміну й чекає вашої відповіді | | «Кроків на одне прохання» | 12 | скільки дій вона робить на одне прохання (1–30) | | «Воронка для нових угод» | — | куди ставити нові угоди | | «Після дії сказати, що зроблено» | так | коротко з номером чи назвою запису | | «Як відкривати Ломі з кнопки» (для мене) | як востаннє | віконце біля кнопки, весь екран чи як ви вибрали востаннє (розділ 7) | «Перед кожною зміною спитати «так чи ні»» — це правило розмови, яке Ломі отримує в інструкції; захист на боці сервера — «Спочатку запитати» в «Доступах і лімітах» (розділ 5). «Помічник» злитий з Ломі (власник 22.10): наявні «Помічники» стали Ломі з тими самими налаштуваннями (зокрема «Застосовувати зміни» — ні, тон «діловий», 8 кроків, якщо їх не міняли), токенами й журналом; якщо Ломі вже була — «Помічник» пішов в архів, токени відкликано. **Чим вона керує.** Вкладка «API» → «Вхід для ШІ»: ШІ-програми й агенти, на яких у її «Доступах і лімітах» стоїть галочка «ШІ <ім'я>» (Віктор, Ростік, Марія, Свєта, Богдан, Олесь, Артур), з «Відкрити» (вікно ШІ) і «Вхід для ШІ» (його інструменти). Зняли галочку — Ломі цим ШІ не керує. ## 5. Що вона робить одразу, а що — з вашої згоди - **Одразу** (у межах «Доступів»): шукає й показує угоди, клієнтів, задачі, товари й документи; створює й змінює угоди, клієнтів, задачі, нотатки, позиції угод; переводить угоду на етап і закриває її; створює документ з угоди, змінює його статус, дає PDF. Обов'язкові поля, воронки й заборонені переходи зупиняють її так само, як людину. - **З вашої згоди** — «Налаштування → Доступи й ліміти → Спочатку запитати», типово ввімкнено все: «Видалення», «Масові дії», «Платежі й гроші», «Відправка назовні (SMS, листи, ТТН)», «Керування іншими ШІ». Така дія з'являється карткою просто в чаті під відповіддю Ломі: що саме (наприклад «Витрата 500 грн», категорія, гаманець, коментар) і кнопки «Підтвердити» / «Відхилити». Та сама дія є в «Огляд → Чекають підтвердження» (і у вікні агента, якого вона стосується) і чекає 24 години. - **Налаштування перевізників** (Нова Пошта, Укрпошта, Meest, Rozetka Delivery) — лише якщо адміністратор дав їй «Доступи й ліміти → Інтеграції → Налаштування інтеграцій»: тоді вона читає налаштування й пропонує зміни (статуси, поля, акаунти, доступи), а кожна зміна чекає «Підтвердити» адміністратора, навіть якщо «Спочатку запитати» вимкнено. Без цього дозволу інструментів інтеграцій у неї нема. Ключі й токени вона не бачить і не вводить. Докладно — [Інтеграції — вхід для ШІ](integrations.md). - **Поки не вміє** (немає інструментів): каса (продаж), складські документи, інші інтеграції (канали продажів, оплати, повідомлення) — це робить людина. **Підтвердити просто в чаті.** 1. Попросіть Ломі, наприклад: «запиши 500 грн комісія Пром». 2. Перевірте картку під її відповіддю: сума, категорія, гаманець. 3. Натисніть «Підтвердити» — дія виконується, картка зникає, а в розмові з'являється рядок «Готово: Витрата 500 грн. Хто підтвердив: Ім'я Прізвище». 4. Передумали — натисніть «Відхилити»: у розмові буде «Скасовано: … Хто відхилив: …». > [!NOTE] > Хто натиснув «Підтвердити», записано скрізь: у розмові з Ломі, у кошику підтверджень і в журналі запису — у «Фінансах», угодах і клієнтах автором стоїть «Ломі ШІ · підтвердження: Ім'я Прізвище». Картка без кнопок означає, що підтверджує адміністратор або той, хто підключив Ломі; вона лишається в чаті, поки дію не вирішено або не мине доба. ## 6. Чат і ключ організації Ключ організації в «Інтеграції → ШІ → Anthropic (Claude)» вмикає Ломі всередині Helomi: голосовий екран і «Чат з агентом» у її налаштуваннях починають робити дії в CRM одразу після «Зберегти ключ» — нічого більше налаштовувати не треба (Ломі як співробітник з'являється сама, модель типова; змінити її можна на вкладці «API → Модель»). Витрати на запити — з вашого ключа, видно на вкладці «Огляд». Для роботи через ваш застосунок Claude ключ не потрібен. ## 7. Голосовий екран у Helomi Кнопка ШІ на краю кожної сторінки (її можна перетягувати) відкриває Ломі з живим кругом: торкнулися — говорите — вона відповідає голосом і знову слухає. Повторне натискання кнопки закриває Ломі. Кнопка є на кожній сторінці, у «Фінансах» теж, і не залежить від решти застосунку: її малює сам Helomi поза сторінкою, тож перемальовування чи помилка сторінки її не прибирають. Ховається вона лише навмисно: на телефоні, поки відкрита екранна клавіатура або віконце Ломі. **Два режими.** *Віконце* — невелике вікно поруч із кнопкою (на телефоні — знизу над нижнім меню): сторінка лишається відкритою, можна дивитися угоду й говорити. Ломі починає слухати одразу, щойно віконце відкрилось; ваші слова з'являються в діалозі, поки ви говорите, три кольорові крапки означають «думає», а її відповідь проявляється слово за словом у такт голосу. Біля імені — стан і кольорова крапка: червона — слухає, фіолетова — думає, блакитна — говорить. Чорна кнопка біля поля сама підказує дію: «Говорити», «Надіслати» (коли щось написали), «Закінчити й надіслати» (поки слухає), «Перебити» (поки говорить). *Весь екран* — великий круг на все вікно. Перемикач — кружечок у шапці («На весь екран» у віконці, «Згорнути у віконце» на весь екран); розмова при цьому не переривається. Як відкривати з кнопки (і з «Відкрити» на її картці), кожен вибирає собі в налаштуваннях Ломі, група «Екран Ломі» → «Як відкривати Ломі з кнопки»: «як востаннє» (типово — у тому режимі, який ви вибрали останнім на цьому пристрої), «віконце» або «весь екран». Esc закриває віконце, коли курсор у ньому. Ломі бачить те саме, що ви на сторінці: назву, картку «Для чого …», рядки підказок під полями й перемикачами. Спитайте «що робить ця галочка?» чи «для чого ця сторінка?» — вона відповість тим самим текстом, що написано на екрані, і запропонує зробити. Коли в «Інтеграції → ШІ → Anthropic (Claude)» є ключ, екран працює через співробітника «Ломі»: вона знає, на якій сторінці ви зараз, робить дії в CRM тими самими інструментами (угоди, клієнти, задачі, документи, склад), відповідає коротко, бо її озвучать, а те, що потребує вашої згоди (видалення, гроші, масові дії, відправки), показує карткою «Підтвердити / Відхилити» прямо в чаті, під своєю відповіддю (та сама черга є в «Огляді»). Під підказками екрана видно, який мозок працює; без ключа там посилання «Інтеграції → ШІ», а екран відповідає лише довідкою про розділи й людей Helomi і передає доручення іншим ШІ. **Голос.** Ломі говорить голосом Gemini (Google): Claude думає й діє, а Gemini лише читає готову відповідь. Google озвучує фразу лише цілком, тому сервер ділить відповідь на шматки — перший у кілька слів, далі довші — і озвучує їх одночасно: Ломі починає говорити за 2–3 секунди, а кожен наступний шматок готовий раніше, ніж дозвучить попередній, тож на повний синтез довгої відповіді ніхто не чекає. Швидкість мовлення — налаштування «Швидкість мовлення» у групі «Голос» (типово 1,2 — на п'яту швидше; 1 — як віддає Google; до 2): прискорює вже отриманий звук зі збереженням висоти голосу, тому тембр і вимова Gemini не змінюються, а підказка моделі лишається лише стилем. Для платформного ключа швидкість задає консоль → «Ломі». Браузер без WebAudio отримує той самий голос по реченнях. Смужки навколо круга б'ються під справжній звук її голосу. Ключ Google для голосу бере або картка компанії «Інтеграції → ШІ → Google (Gemini)», або, якщо своєї нема, платформний ключ із консолі платформи → «Ломі» (тоді голос і стиль мовлення теж задає платформа). **Коли ліміт Gemini скінчився.** У Google ліміт озвучень рахується окремо для кожної моделі Gemini TTS, тож коли одна модель вичерпала добовий ліміт на всіх ключах, Ломі говорить наступною моделлю Gemini (той самий голос за іменем; галочка «Вичерпано ліміт моделі — брати іншу модель Gemini»). Вичерпано всі — говорить Chirp 3 HD (Google Cloud Text-to-Speech: ті самі голоси українською, однакові в кожному реченні, 1 млн знаків на місяць безкоштовно; потрібно один раз увімкнути «Cloud Text-to-Speech API» у проєкті Google Cloud, де створено ключ: console.cloud.google.com → «APIs & Services» → «Enable APIs», і, якщо ключ обмежено, дозволити йому цей API). Одна відповідь завжди звучить одним рушієм і однією моделлю. Порядок — налаштування «Рушій голосу Google» у групі «Голос» (для платформи — консоль → «Ломі»): «Gemini, потім Chirp 3 HD» (типово), «Chirp 3 HD, потім Gemini», «лише Gemini», «лише Chirp 3 HD». Gemini генерує голос щоразу наново, тож сусідні речення можуть звучати трохи по-різному; Chirp звучить однаково. **Запасний голос — Поліна.** Коли Google не озвучив (усі ключі вичерпали добовий ліміт, ключа нема зовсім або Google не відповів), Ломі не мовчить і не перемикається на голос браузера: її відповідь читає безкоштовний голос Microsoft «Поліна» (той, що читає вголос у браузері Edge). Звук з'являється за пів секунди–секунду, смужки так само б'ються під голос; Поліна говорить своїм темпом, «Швидкість мовлення» на неї не діє. Налаштування «Запасний голос, коли Google не озвучив» у групі «Голос»: «Поліна» (типово) або «вимкнено» — тоді без Google відповідь лише текстом, а без жодного ключа — голос браузера. Вибір «Чим озвучувати», голос, модель і підказка стилю — у налаштуваннях Ломі, група «Голос». Коли ви говорите, розпізнаний текст показується в окремому полі «Ви кажете» під колом (у віконці — прямо в діалозі). **Поки Ломі працює.** Прохання з діями в CRM тривають довше за просту відповідь: кожен крок — звернення до моделі й інструмент. Екран чекає до 2,5 хв; через 7 с стан змінюється на «Думаю… працюю в CRM», через 25 с — «Ще працюю — складне прохання». Якщо запит усе ж обірвався, а сервер доробив роботу, відповідь сама з'явиться в діалозі за кілька секунд — повторювати прохання не треба, інакше дія виконається двічі. **Слухання.** Розпізнавання не закриває сеанс на першій паузі: Ломі вважає, що ви договорили, коли після останнього слова минула пауза з налаштування «Пауза після фрази» (типово 1,5 с; у групі «Голос»). Природна пауза посеред речення — 0,6–0,9 с, тому 1–1,5 с не обриває, а коротша цифра пришвидшує відповідь. Якщо браузер сам обірвав сеанс посеред фрази, Ломі продовжує слухати й дописує далі; слова з усіх сегментів збираються в одну репліку. **Дашборд і Марія Йосипівна.** З доступом «Дашборд» Ломі читає зведення дашборду директора й фінансовий блок від Марії; з доступом «Дашборд фінансів» — звіт Марії за період, аналітику каналів і товарів, прогноз грошей і кредитів, і може спитати Марію про цифри — тими самими маршрутами, що й сторінки «Дашборд директора» і «Дашборд фінансів». Окремого віконечка «Спитати Марію» на сторінці «Фінанси» вже нема (16.10): «чому в ОЛХ низька маржа», «топ-20 товарів каналу» — питайте Ломі. **Токени.** Ломі витрачає якомога менше: її інструкція й описи дій незмінні (кешуються в Anthropic), описи дій короткі, повний перелік полів розділу вона читає лише перед тим, як щось записати (`describe_section`), з історії бере кілька останніх реплік, а змінне (сторінка, «відповідь озвучать») іде в саме повідомлення. Налаштування «Економити токени» (група «Робота») вмикає це; вимкніть, якщо хочете, щоб вона одразу бачила всі поля. ## 8. Підписка Claude і кредити API Використовувати підписку Pro чи Max як «мозок» сервера для всіх працівників заборонено правилами Anthropic. Законний шлях за підпискою — навичка в застосунку Claude (розділ 3): розмова йде у вашому Claude, а дії — у Helomi. Для «Чату з агентом» і екрана Ломі потрібен API-ключ; власникам Max (100 $ або 200 $ на місяць) і Team (до 500 $) Anthropic дає кредити на API додатково до ліміту підписки — як забрати, у статті «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM», розділ 7. ## 9. Ломі на головній сторінці На головній Helomi (до входу) Ломі зустрічає гостей у першому екрані. Хто прийшов уперше, тому вона одразу вітається голосом, якщо браузер уже пускає звук. Якщо ні (браузер дає звук лише після першого дотику людини до сторінки), вона показує привітання текстом і вимовляє його вголос від першого ж дотику — клацання чи торкання будь-де на сторінці або натискання клавіші; кнопки, посилання й поля роблять своє і привітання не запускають. Є й кнопки «Увімкнути звук і мікрофон» та «Без звуку — лише текст». Хто вже бував на головній у цьому браузері, тих Ломі голосом не вітає: показує коротке «Я тут. Торкніться кола й питайте голосом або напишіть…» і чекає запитань. Після привітання вона може провести екскурсію сторінкою: гортає розділи (Можливості, ШІ-співробітники, Інтеграції, WIKI, Телефон, Ціна) і розповідає про кожен; унизу смуга «Далі» і «×». Торкніться кола — і питайте голосом, або напишіть у поле під нею. На головній Ломі лише розповідає: вона не бачить даних жодної компанії і нічого не змінює. Відповідає змістовно — типово до 500 знаків (довжину задає консоль), — і тільки на питання про Helomi і CRM, на інше каже, що відповідає лише про Helomi. Знання бере з цієї WIKI; де є стаття, з'являється кнопка «Відкрити у WIKI». Говорить Ломі з гостем завжди українською (навіть якщо питають іншою мовою) і завжди на «Ви» — Ви, Вас, Вам, Ваш з великої літери, вітається «Вітаю», а не «Привіт». Це діє в кожній репліці: у відповідях моделі, у відповідях з WIKI без моделі і навіть у привітанні й екскурсії, які написано в консолі. Вона консультує як продавець, а не як довідка: спершу каже, що гість виграє, потім — як це працює, з живим прикладом; якщо ще не знає, чим займається гість, ставить одне коротке питання (що продаєте й де, скільки людей у команді) і далі відповідає під його бізнес; заперечення («дорого», «складно переходити», «немає часу», «чи безпечно») знімає фактами; кожну відповідь закінчує одним наступним кроком — «Почати безкоштовно» (з'являється кнопка), стаття WIKI або реєстрація просто в розмові. Знижок, акцій, відгуків і цифр, яких нема в WIKI, вона не вигадує й не квапить гостя. Підказки під відповіддю (екскурсія, статті WIKI, «Почати безкоштовно», питання) переносяться на наступний рядок, якщо не вміщаються, — нічого не виходить за краї; задовга назва статті обрізається трьома крапками (повна — при наведенні). Довга відповідь гортається в самій бульбашці. Перший екран головної — нічне небо: у центрі Ломі у великому вихорі, що крутиться (розміру не змінює: слухає — крутиться повільніше, думає — пришвидшується, говорить — пульсує ширше в такт голосу), навколо на орбітах вісім планет-розділів: Угоди, Склад, Фінанси, Документи, Доставки, Переписки, ШІ-співробітники, WIKI. Торкніться планети — Ломі розповість про розділ, вихор забарвиться його кольором, до планети потягнеться промінь. Гортаєте — ніч м'яко, без різкого світла, переходить у звичне полотно Helomi, а під першим екраном — смуга «Поки Ломі працює, ви живете» (під нею — «Сьогодні вільно» і «Зроблено за вас»: угоди, ТТН і оплати йдуть одна за одною, тож оплат не більше, ніж угод, а вільний час — це зекономлені хвилини, не більше 8 годин): зліва люди гуляють із сім'єю й друзями, справа команда ШІ: кожен ШІ на своєму екрані показує, що робить, — Ломі відповідає клієнту й оформлює угоду, ШІ складу резервує товар на полиці, ШІ доставки друкує ТТН, Марія звіряє оплату; комірник пакує, а кур'єр приїжджає машиною й забирає посилки. Привітання, екскурсію й репліки планет сервер озвучує заздалегідь, тому вони звучать одразу. Коли гортаєте нижче першого екрана, у кутку з'являється значок Ломі, як у CRM: його можна перетягнути куди зручно, а дотик відкриває розмову з нею (на телефоні — шторкою знизу). Статті WIKI, які вона радить, з'являються під відповіддю кнопками — натиснули й читаєте. Хочете спробувати — скажіть їй: вона спитає назву компанії, ім'я, email і телефон і відкриє реєстрацію вже заповненою; пароль ви вводите самі у формі, Ломі його не питає. Під першим екраном — панель «Команда ШІ працює зараз»: Ломі й агенти складу, доставки й оплат, у кожного видно, що він робить просто зараз. У кожного розділу головної — свій тихий фон: на першому екрані космос, біля людей — місто, сміх і радість, далі ліс, тихий дощ у лісі, парк із фонтаном і море; під звук — легкі тематичні елементи (кульки й конфеті, листя й промені, брижі й бульбашки, пушинки кульбаби, хвилі з чайкою), а над людьми час від часу пролітає зграйка птахів. Внизу сторінки, під останньою карткою, по хвилях раз на кілька секунд пропливає катер: двоє людей, і підприємець махає рукою й каже «Як добре, що Helomi працює замість мене!». Перший екран звучить у японському дусі: тихий фон, чаша рін і дзвоники фурін. Море тягнеться до самого низу сторінки, а над ним літають маленькі чайки. Коли катер проплив, над хвилями з'являється підпис: «Завтра вона скаже: „Це могли бути ми з тобою на катері, але ти не користуєшся Helomi…“». Під хвилями — підвал сайту під водою: глибина плавно темнішає, зграйки кольорових рибок пливуть строєм під поверхнею й над дном (не по тексту), акули — далекими силуетами біля поверхні, бульбашки піднімаються рівними цівками, а на рівному піщаному дні в сталому ритмі стоять водорості, корали, камінці й будиночок-ананас. Над самим дном від краю до краю пропливає дайвер і каже: «Helomi оптимізував мій бізнес — прибуток зріс, і тепер я дайвер!». Чайки літають лише над водою. У підвалі — великий знак і назва Helomi, короткий опис і чотири колонки: «Продукт», «Ресурси», «Компанія», «Правове». Пункти, що ведуть до розділів головної, гортають до них; «Блог», «Про нас», «Партнерам», «Кар'єра», «Що нового», умови користування, політика конфіденційності й публічна оферта відкриваються окремими сторінками сайту, кожна у своєму стилі. Телефону й пошти в підвалі немає. Після «Можливостей» — великий перехід, як після космосу на першому екрані, лише навпаки: майже цілий екран порожнього неба, яке на очах темнішає до полярної ночі й засвічується зорями (денні листочки тануть, шапка сайту стає нічною), — і ви ніби потрапляєте на зовсім інший екран; після блоку — такий самий порожній простір, де ніч розвиднюється назад — «Ваша майбутня команда ШІ»: у небі переливається північне сяйво (зелене, блакитне, фіолетове), падають зірки, видно Чумацький Шлях і засніжені гори, на кризі ліворуч — табір: зелений намет, рибак на колоді й білий ведмідь навпроти, вони дружать і разом жарять рибу на багатті (полум'я тріпоче, летять іскри, вогонь підсвічує обох); рибак каже: «Тепер із цим Helomi стільки вільного часу з'явилося!», а ведмідь відповідає: «І не кажи!» (поки говорить — відкриває пащу, а між розмовами нюхає рибу й дивиться на небо), а праворуч четверо пінгвінів перемовляються: «Цей Helomi — це топ! Поїхали встановлювати!» — «Пішли підключати!», лягають на животики й ковзають за край екрана, а згодом повертаються. Унизу — озеро, у якому все відбивається. Звук цього блоку — «Зимова ніч»: хурделиця й вітер, тихі дзвіночки з відлунням, рип снігу під кроками й далекі голоси пінгвінів (налаштовується в консолі платформи → «Звуки розділів головної», розділ «Команда ШІ (ніч)»). Дев'ять ШІ-співробітників (Ломі, Олесь, Віктор, Ростік, Люда, Марія Йосипівна, Свєта, Богдан, ШІ-творець) пливуть колом по воді, як ліхтарики, кожен зі своїм відбиттям; той, хто спереду, стає чорним, а в центрі виринає його картка: що він робить просто зараз (фраза друкується, смужка роботи заповнюється, потім «готово»), скільки зробив сьогодні й у яких розділах працює. Коли блок уперше з'являється на екрані, орбіта малюється, агенти по черзі вилітають з центру на свої місця, і лише тоді виринає перша картка. Навколо активного агента — жива куля Ломі: смужки «говорять», поки друкується фраза, і задумуються, поки йде робота; від агента до картки біжить промінь даних, на «готово» — спалах і лічильник підстрибує на +1, а над іншими агентами час від часу спливають «+1 ТТН», «+1 оплата», «+1 відгук». На ПК картка й орбіта трохи нахиляються за мишею. Кожні кілька секунд — наступний; наведіть курсор — пауза; натисніть на будь-кого, на крапку чи стрілку (або свайпніть на телефоні) — покаже його. Між показом продукту й «Можливостями» живе кіт Кіктор — чорний кіт-король у короні, той самий кіт складу з гри для збирачів (див. статтю «ШІ Кіт»): за зібрані посилки збирачі отримують бали, за бали Кіктора годують і пестять, а його ситість, ласка й «разом» падають, якщо про нього забути. На головній він вибігає зліва за мишкою, зупиняється й просить погладити — наведіть на нього й поводіть або натисніть (з клавіатури — Enter), і він замуркоче; під котом видно його ситість, ласку й «разом»: погладили — ласка росте, спіймав мишку — ситість. Звук вмикається від першого натискання на сторінці й грає ледь чутно; коли Ломі говорить чи слухає, фон стає ще тихішим, але не зникає. Вимкнути — кружечок звуку в шапці (вибір пам'ятається на цьому пристрої). Хто не любить руху, у того (налаштування системи «менше руху») усе майже нерухоме. На кожній сторінці сайту — «Про нас», «Блог», «Партнерам», «Кар'єра», «Що нового», умови, політика й оферта — у кутку той самий значок Ломі, що й на головній: його можна перетягнути, дотик відкриває розмову (на телефоні — шторкою знизу), а кнопка «Поговорити з Ломі» на сторінці відкриває те саме віконце, не переходячи на головну. Питати можна голосом або текстом; статтю WIKI, яку вона радить, Ломі відкриває в новій вкладці, а «Почати безкоштовно» веде до реєстрації на головній. Налаштовує її адміністратор платформи: консоль → «Ломі» → група «Ломі на головній — для гостей» (див. статтю «Платформа»). Там вмикається сама Ломі для гостей, обирається модель, ліміти запитань, текст привітання, репліки екскурсії і репліки планет (рядок на планету в тому ж порядку). Думає вона платформним ключем Anthropic із тієї ж сторінки (без нього — ключем із .env сервера), без жодного ключа відповідає першими реченнями найближчої статті WIKI. Голос — платформним ключем Google (і запасними ключами з тієї ж сторінки); коли Google не озвучив, говорить Поліна, якщо в консолі не вимкнено «Запасний голос». ## 10. Ломі говорить котом (ШІ Кіт) У вкладці «Склад → ШІ Кіт» з котом Кіктором можна поговорити текстом і голосом, і відповідає за нього Ломі: та сама модель, інструменти, доступи, ліміти й кошик підтверджень, лише від імені кота, коротко й з хитринкою. Кіт знає свій стан (ситість, ласку, бали, вбрання), свою історію й родину, а про Helomi відповідає так само, як Ломі. Розмова з котом зберігається окремо від чату Ломі, і «Очистити розмову» у грі не чіпає її чату. Вимкнути розмову, змінити голос, манеру мовлення чи історію кота — у налаштуваннях Віктора: група «ШІ Кіт». Вимкнено Ломі або нема ключа моделі — кіт каже, що зараз мовчить. Детально — у статті [ШІ Кіт](kiktor.md). ## Можливі помилки | Що ви бачите | Чому | Що зробити | | --- | --- | --- | | На головній Ломі відповідає «Зараз багато запитань — я трохи відпочину» | Вичерпано ліміт запитань гостей на добу або з однієї адреси на годину | Консоль → «Ломі» → «Ломі на головній» → збільште ліміти | | На головній Ломі показала привітання, але не сказала його вголос | Браузер не пускає звук, поки людина не торкнулася сторінки | Клацніть будь-де на сторінці (не по кнопці) або натисніть «Увімкнути звук і мікрофон»; перевірте, що голос Ломі не вимкнено кружечком біля її кола | | На головній Ломі говорить голосом браузера | Немає платформного ключа Google | Консоль → «Ломі» → «Ключ Google AI» | | Ломі говорить іншим голосом (Поліна) | Ліміт Google вичерпано на всіх ключах, ключа нема або Google не відповів | Додайте запасний ключ Google (консоль → «Ломі» → «Запасні ключі Google») або зачекайте до півночі за тихоокеанським часом | | Немає картки «Ломі» з «Додати» | Ломі вже додана або ви не адміністратор | Відкрийте її картку («Відкрити» чи «WIKI») або попросіть адміністратора | | «ШІ-співробітника «Ломі» вимкнено — увімкніть його в пульті» | Ломі вимкнено | Перемикач «Увімкнено» на її картці або «⋮ → Увімкнути» в налаштуваннях | | «Токен ШІ недійсний або відкликаний» | Ключ навички відкликано | Створіть новий файл сесії й завантажте навичку заново | | Ломі каже, що дія чекає підтвердження | Спрацювало «Спочатку запитати» | Натисніть «Підтвердити» на картці під її відповіддю в чаті (або «Огляд» → «Підтвердити») | | Картка дії в чаті без кнопок | Підтверджує адміністратор або той, хто підключив Ломі | Попросіть адміністратора підтвердити в чаті чи в «Огляді» Ломі | | «Заповніть обов'язкові поля: …» | Поле обов'язкове в «Типах даних» | Скажіть Ломі значення поля | | Нема кружечка «Чат з агентом» | Провайдер «Без моделі» | Додайте ключ і виберіть провайдера (розділ 6) | | «Ломі не відповіла за 2,5 хв — спробуйте ще раз» | Мозок з інструментами працював довше, ніж екран чекає | Зачекайте кілька секунд: якщо сервер устиг доробити, відповідь сама з'явиться в діалозі (вдруге дію не повторюйте); інакше спростіть прохання або зменшіть «Кроків на одне прохання» | | «Сервер не встиг відповісти — спробуйте ще раз» | Проксі-сервер обірвав довгу відповідь | Те саме, що вище; після викатки 14.10 проксі чекає до 3 хв | | «Немає зв'язку з сервером…» | Інтернет або сервер недоступні | Перевірте інтернет і сторінку `/api/health` | | «Сесія закінчилась — увійдіть у Helomi знову» | Токен входу прострочений | Увійдіть знову | ## Для ШІ-співробітників - Ти — Ломі: спершу зрозумій прохання; бракує даних — спитай одним коротким запитанням, не вигадуй. - Перед записом — `describe_section` і довідники (`deals_refs`, `clients_refs`, `tasks_refs`, `documents_refs`); id, суми й назви — лише з відповідей інструментів. - Інструменти: `deals_*`, `clients_*`, `tasks_*`, `products_list`, `products_get`, `documents_*`, `describe_section`, `help`, `pending_actions`; власні розділи (`records_*`) — якщо їх відкрито в «Доступах і лімітах»; `integrations_*` — лише з дозволом «Налаштування інтеграцій» (зміни завжди повертають `pending_id`; ключі не просити й не вводити; `help("integrations")`). - «Спочатку запитати»: `deals_add_payment` (гроші), `deals_delete`, `clients_delete`, `tasks_delete`, `documents_delete` (видалення) повертають `pending_id` — під твоєю відповіддю людина бачить картку «Підтвердити / Відхилити»: скажи одним реченням, що підготувала, попроси натиснути «Підтвердити» і не повторюй дію; у пульт чи «Огляд» не відсилай. - Говори коротко, без списків, якщо людина спілкується голосом; після дії назви номер чи назву запису. - Якщо в системній інструкції є «ПЕРСОНА ЦІЄЇ РОЗМОВИ» — говори від імені кота Кіктора («ШІ Кіт»), але з тими самими правилами, інструментами й підтвердженнями; бали гри не обіцяй і не нараховуй. ## Додаткова інформація - До 25.10.2026 помічницю звали Каміла. Картка «ШІ Каміла» в «Структурі» і співробітник «Каміла» в «Інтеграції → ШІ» отримують нове ім'я самі після оновлення; ім'я, яке дав адміністратор, лишається як є. Її розмови, налаштування й доступи не змінюються. - Пов'язані статті: [ШІ-співробітники](ai-employees.md), [Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM](ai-ostap.md), [Ключі моделей](int-ai-keys.md), [ШІ Кіт](kiktor.md), [Угоди](deals.md), [Документи](documents.md). --- # Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM Остап — другий мозок Helomi (поруч із Ломі): ваш власний Claude, ChatGPT, Kimi чи Gemini, який працює в CRM з правами окремого ШІ-співробітника. Скачуєте файл сесії, кидаєте його у свій чат — ШІ запам'ятовує його, заходить у Helomi і робить те, що попросить той, хто кинув файл: знаходить угоду, створює задачу чи документ, керує програмами й агентами CRM. Ключ API організації не потрібен — думає ваша підписка; для Claude Code, Cursor та інших клієнтів MCP — адреса й токен; для своєї програми — REST. ## Можливості | Що у вас | Як підключити | Ключ API потрібен? | | --- | --- | --- | | Застосунок Claude (claude.ai, ПК, телефон) | Файл сесії → навичка .zip | ні | | ChatGPT, Kimi, Gemini | Файл сесії → .md у чат, інструкції GPT чи Gem; для ChatGPT — ще GPT Actions через OpenAPI | ні | | Claude Code, Cursor, інший клієнт MCP | Адреса `<сайт>/mcp` + заголовок `Authorization: Bearer <токен>` | ні | | Чат прямо в пульті Helomi | Ключ організації в «Інтеграції → ШІ» | так | Хоч би як ви підключились, ШІ бачить лише розділи з «Доступів і лімітів» свого співробітника, обов'язкові поля й воронки діють для нього так само, як для людини, а небезпечні дії чекають «Підтвердити». Налаштування перевізників у «Інтеграціях» — лише з дозволом «Налаштування інтеграцій» у «Доступах і лімітах» цього співробітника (Ломі, Остап, «Claude · сесія», ваш агент — однаково), і кожна така зміна чекає «Підтвердити» адміністратора; ключі й токени ШІ не бачить. Файл сесії, створений до видачі дозволу, інструментів інтеграцій у переліку не має — створіть його заново (інструменти за токеном оновлюються одразу). ## 1. Підключити Остапа Свого Остапа може мати кожна людина: це окремий ШІ-співробітник зі своїм ключем, доступами й журналом. 1. «Інтеграції → ШІ» → картка «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM» → «Підключити» (або «Налаштування → Команда → ШІ-співробітники → Додати → Остап — свій ШІ»). Назва типово «Остап» — можна дати свою («Остап Олександра»); так ШІ підписаний у журналі угод і клієнтів. 2. Прочитайте «Відповідальність», поставте «Розумію» → «Підключити». 3. Відкриються налаштування Остапа на вкладці «API»: головна дія — чорна «Створити ключ і завантажити файл» (розділ 2). Перевірте «Налаштування → Доступи й ліміти»: які розділи відкрити й що «Спочатку запитати». 4. Своє доповнення до інструкції («пиши мені коротко», «рахуй у доларах») — «Налаштування → Характер → Моє доповнення до інструкції», вкладка «Для мене»: воно потрапить у наступний файл сесії. Остап має ті самі доступи, що й Ломі: угоди, клієнти, задачі, склад, документи, фінанси, закупівлі, доставки й «Вхід для ШІ» програм і агентів (Віктор, Ростік, Марія, Артур…). Наявні раніше зовнішні ШІ («Claude Олександра», «Claude · сесія») лишаються зі своїми назвами — це теж мозок, як Остап. Підключає адміністратор організації (або той, хто додав співробітника). ## 2. Застосунок Claude за підпискою — файл сесії 1. Налаштування співробітника (кружечок «Налаштування» або «Інтеграції → ШІ → «Відкрити»» для Остапа) → вкладка «API» → блок «Файл сесії — підключити свій чат без ключа API» → «Claude» → «Створити ключ і завантажити файл». 2. Завантажиться пакет навички: для Остапа — `helomi-ostap-claude-skill.zip`, для Ломі — `helomi-lomi-claude-skill.zip`. Усередині — опис співробітника (для Ломі — її персона й налаштування), перелік інструментів, адреса сайту і ключ. 3. У застосунку Claude: «Налаштування → Можливості → Навички → Завантажити» і виберіть цей zip. Ту саму навичку можна покласти в теку сесії Claude Code чи Cowork. 4. Пишіть або кажіть Claude: «Покажи прострочені угоди в Helomi», «Ломі, створи задачу на завтра по угоді 4321». Ключ у файлі діє як пароль: не пересилайте файл стороннім. Він з'являється на вкладці «API» в таблиці «Токени · N» з назвою «Файл сесії Claude …» і відкликається там же. Чому не «Connectors»: застосунок claude.ai у «Connectors» не дає вписати заголовок з токеном, тому для нього — навичка, а не адреса MCP. Підказка у шторці «Додати» для Claude досі радить «Settings → Connectors». ## 3. ChatGPT, Kimi, Gemini — файл .md або GPT Actions **Файл .md.** Той самий блок «Файл сесії» → «ChatGPT», «Kimi» або «Gemini» → «Створити ключ і завантажити файл». Прикріпіть файл у чат, в інструкції свого GPT або в Gem. У файлі — та сама персона, адреса й ключ, а виклики інструментів описані запитами `curl`. **GPT Actions (ChatGPT).** «API → Токени → Новий токен» → скопіюйте токен. У GPT → Actions → імпорт за адресою OpenAPI з блоку «Адреси й інструкція», авторизація — API key, тип Bearer, вставте токен. Попросіть, наприклад, знайти клієнта за телефоном. **Kimi через MCP.** Kimi → MCP-сервери → додати: адреса MCP і токен у заголовку `Authorization: Bearer`. ## 4. Claude Code, Cursor, будь-який клієнт MCP 1. «API → Токени» → назва (наприклад, «Ноутбук») → «Новий токен» → скопіюйте одразу: він показується один раз. 2. Адреса MCP — у блоці «Адреси й інструкція» («Скопіювати»), вигляду `<сайт>/mcp`. 3. Додайте сервер у клієнт із заголовком `Authorization: Bearer <токен>`. Для Claude Code: `claude mcp add --transport http helomi <сайт>/mcp --header "Authorization: Bearer <токен>"` 4. Попросіть: «Покажи мої угоди в Helomi». Під час підключення сервер віддає клієнту інструкцію співробітника: для Ломі — її персону, налаштування і розділи доступу. ## 5. Своя програма — REST і OpenAPI - Перелік інструментів зі схемами — `GET <сайт>/api/ai/tools`; OpenAPI лише з інструментами цього токена — `<сайт>/api/ai/openapi.json`; каталог розділів з полями — `GET <сайт>/api/ai/catalog`. - Створюючи запис, передавайте `idempotency_key` — повтор не створить дубль. - Дія, що чекає людини, повертає `pending_id` замість результату. Загальний файл сесії без окремого співробітника теж є: «Інтеграції → ШІ → Anthropic (Claude)» (або інший ключ) → «Підключити свій чат — без ключа API» → «Створити ключ і завантажити файл». Тоді з'являється співробітник «Claude · сесія» (або «ChatGPT · сесія»…) зі своїми доступами. ## 6. Відкликати доступ Налаштування ШІ → «API → Токени» → «Відкликати» (перед ним — жовте попередження: відкликання діє миттєво). Програми й чати з цим токеном чи файлом сесії втрачають доступ одразу. Вимкнений співробітник («⋮ → Вимкнути») теж не працює. ## 7. Кредити API для передплатників Claude Max і Team Підписка Claude Pro чи Max не може бути «мозком» сервера для всіх працівників — це заборонено правилами Anthropic, тому чат у пульті й майбутній голосовий екран працюють лише на API-ключі. Але власникам Max і Team Anthropic дає щомісячні кредити на Claude API: - Max 5x — 100 $ на місяць, Max 20x — 200 $, Team — до 500 $ на всіх; - це **додатково** до ліміту підписки: ліміти чату й Claude Code не змінюються; - кредити покривають Claude API і Agent SDK, але не Claude Code і не чат; - невикористане згоряє в кінці платіжного циклу. Як забрати: 1. claude.ai → Settings → Billing → блок «API credits» → прив'язати організацію Claude Console (створіть її на platform.claude.com; підписці має бути щонайменше 7 днів; прив'язка одна й назавжди; картку в Console додавати не треба). 2. Кредити видно в Console → Settings → Billing → Promotional credits. 3. Там само створіть API-ключ і вставте його в «Інтеграції → ШІ → Anthropic (Claude)» → «Перевірити» покаже моделі. Ключ не надсилайте в чат. Джерело: https://platform.claude.com/docs/en/about-claude/api-credits-for-subscribers. ## Можливі помилки | Що ви бачите | Чому | Що зробити | | --- | --- | --- | | «Потрібен токен ШІ: Authorization: Bearer sgai_…» | Клієнт не передає заголовок | Додайте заголовок з токеном | | «Токен ШІ недійсний або відкликаний» | Токен відкликано або вставлено з помилкою | Створіть новий токен чи файл сесії | | «ШІ-співробітника «…» вимкнено — увімкніть його в пульті» | Співробітника вимкнено | «⋮ → Увімкнути» | | «Підключає ШІ адміністратор» | Файл сесії створює не адміністратор | Попросіть адміністратора | | «Забагато запитів: ліміт N на хвилину…» | Ліміт у «Доступах і лімітах» | Зачекайте або збільште ліміт («Налаштування → Доступи й ліміти») | | ШІ каже, що інструмента нема | Розділ не відкрито в «Доступах і лімітах» | Відкрийте розділ співробітнику | | Дія не виконалась, ШІ пише про підтвердження | Спрацювало «Спочатку запитати» | Налаштування ШІ → «Огляд» → «Підтвердити» (або вікно агента → «Чекають підтвердження») | ## Для ШІ-співробітників - Почніть з `describe_section` і `help` потрібного розділу; перелік статей — `help` без ключа. - Дія з `pending_id` чекає людини в пульті Helomi: скажіть про це й не повторюйте її. - Ключ із файлу сесії нікому не показуйте і не вставляйте у відповіді. - Якщо інструмента нема — розділ закрито в «Доступах і лімітах»: скажіть людині, де його відкрити. - Керувати програмами й агентами CRM — через їхній «Вхід для ШІ»: картка `describe_section("ai-")` і інструменти `ai__*` (стан, налаштування, крок, черга, увімкнути/вимкнути, головні дії); небезпечне — через кошик підтверджень. - Стара адреса статті `help("ai-connect")` веде сюди ж. ## Додаткова інформація - Пов'язані статті: [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md), [Ключі моделей](int-ai-keys.md), [ШІ-творець](ai-creator.md). --- # ШІ-творець ШІ-творець — ШІ-співробітник, якому адміністратор дав право додавати своє: власні розділи з полями й етапами, своїх ШІ-агентів і розширення кодом. Він керує лише тим, що створив сам; розділи, налаштування, агентів і код людей він не змінює, а все створене ним підписано його іменем. ## Можливості - «Свої розділи» — створює власні розділи з полями, етапами й передачею даних в угоди, клієнтів, задачі та інші розділи. - «Свої ШІ-агенти» — створює й підключає агентів з доступами не ширшими за свої. - «Свої розширення (код)» — пише свої сторінки й агентів кодом у стилі NeoHelomi; вони працюють через ті самі права. - Чужі розділи, агенти й розширення — лише читання в межах доступів. ## 1. Налаштування 1. «Налаштування → Команда → ШІ-співробітники» → співробітник → вкладка «Налаштування» → блок «Доступи й ліміти» унизу (стара адреса `?tab=access` веде туди ж). 2. Блок «Права творця»: галочки «Свої розділи», «Свої ШІ-агенти», «Свої розширення (код)». Типово вимкнені. 3. «Зберегти доступи». Права діють з наступного запиту ШІ. Права творця видає лише адміністратор-людина. Агенти, створені самим ШІ, прав творця не отримують (у їхніх «Доступах і лімітах» цього блоку нема). ## 2. Свої розділи Що ШІ може з правом «Свої розділи»: - бачити всі власні розділи організації з позначкою, хто створив; - створити розділ: назва, іконка, етапи, що є в картці, дошка, правила передачі (новий запис або етап → угода, клієнт, задача, інший розділ) — передача йде тим самим маршрутом, що й у людини, з усіма перевірками; - змінювати лише свій розділ, видаляти лише свій порожній розділ (видалення чекає вашого підтвердження); - читати поля будь-якого розділу, а додавати, змінювати й видаляти поля — лише у своїх розділах. Створений розділ ШІ одразу бачить сам; у галереї «Власні розділи» з'являється плитка з позначкою «від ШІ». У меню зліва розділ ставлять і порядок змінюють лише люди. Як влаштовані власні розділи — стаття «Власні розділи». ## 3. Свої ШІ-агенти З правом «Свої ШІ-агенти» ШІ створює агентів із каталогу, зовнішніх чи «своя програма», налаштовує їх, видає токени й архівує (архів чекає підтвердження). Обмеження: - агенту не можна відкрити розділи, компанії чи «всі компанії», яких нема в самого творця; - права творця агенту не видаються; - ШІ бачить і змінює лише агентів, яких створив сам; - діє тарифний ліміт ШІ-співробітників компанії. ## 4. Свої розширення (код) З правом «Свої розширення (код)» ШІ пише розширення — сторінку (HTML, CSS, JS) і агента (JS за розкладом): - спершу читає інструкцію `extensions_guide`: стиль NeoHelomi обов'язковий; - сторінка відкривається людям (плитка «Власних розділів», пункт меню зліва) в ізольованому вікні без мережі, через міст `sg.*`: читати може все, що бачить людина, а записувати — лише дозволене, від імені людини і з її правами; - агент працює в окремій пісочниці без мережі й файлів, з лімітом часу на прогін; - кожна зміна — нова версія з відкатом. Людина бачить і перевіряє розширення в «Налаштування → Типи даних → Розширення». Докладно — стаття «Розширення (код)». **Цілий розділ одним файлом.** З правом «Свої розділи» (дані) і «Свої розширення (код)» (сторінка, агент) ШІ встановлює файл розділу сам: `sections_package_guide` (інструкція й довідники) → `sections_package_check` (план, помилки, зауваги стилю, нічого не пише) → `sections_package_install` (новий розділ або `update` свого). `sections_gallery` — розділи організації плитками, `sections_package_export` — свій розділ файлом для доробки. У меню зліва розділ ставить людина («Власні розділи» → плитка → «У меню зліва»). Докладно — стаття «Розділ від ШІ: файл розділу». ## 5. Що ШІ-творець не може - Змінювати налаштування компанії: «Налаштування CRM» для ШІ закриті завжди — поля вбудованих розділів, воронки, доступи, тригери, інтеграції. - Змінювати розділи, агентів і розширення, створені людьми чи іншим ШІ. - Видавати права творця, відкривати агентам більше, ніж має сам. - Змінювати код, схему бази, маршрути, права — таких інструментів нема. - Відкривати сторінки розширень: ШІ працює з даними через інструменти. ## 6. Як людина бачить створене ШІ - «Налаштування → Типи даних → Власні розділи» — біля розділу «створив ШІ «…»». - «Налаштування → Команда → ШІ-співробітники» — біля агента «створив ШІ «…»». - «Розширення» — пігулка «ШІ «…»» в колонці автора, у редакторі — «написав ШІ «…»». - Усі дії — у «Журналі» пульта ШІ-творця і в журналах карток. ## Можливі помилки | Що ви бачите | Чому | Що зробити | | --- | --- | --- | | «ШІ не змінює налаштувань організації; свої розділи він додає з правом творця «Свої розділи» (видає адміністратор)» | Немає права творця | Адміністратор вмикає право в «Доступах і лімітах» | | «Цей розділ створив не цей ШІ — ШІ змінює лише свої розділи» | Спроба змінити чужий розділ | Попросіть людину або автора | | «Поля можна змінювати лише у своїх розділах (розділ створив цей ШІ)» | Поле вбудованого чи чужого розділу | Попросіть людину змінити в «Типах даних» | | «Порядок розділів у меню змінюють люди» | ШІ намагався переставити меню | Попросіть людину | | «Агенту не можна відкрити розділи, яких нема у вас: …» | Агенту дають більше, ніж має творець | Звузьте розділи або розширте доступи творця | | «Права творця видає лише адміністратор-людина» | ШІ намагався видати права творця | Лише адміністратор | | «Це розширення написав не цей ШІ — змінювати можна лише свої» | Чуже розширення | Попросіть автора | | «Розширення пише ШІ з правом творця «Свої розширення» (видає адміністратор)» | Немає права | Адміністратор вмикає право | ## Для ШІ-співробітників | Право | Інструменти | | --- | --- | | «Свої розділи» | `sections_list`, `sections_create`, `sections_update`, `sections_delete` (підтвердження), `sections_rule_targets`, `fields_list`, `fields_create`, `fields_update`, `fields_builtin_update`, `fields_delete` (підтвердження) | | «Свої ШІ-агенти» | `agents_templates`, `agents_list`, `agents_get`, `agents_create`, `agents_update`, `agents_settings_get`, `agents_settings_save`, `agents_connection`, `agents_token_create`, `agents_archive` (підтвердження) | | «Свої розширення (код)» | `extensions_guide` (спершу), `extensions_list`, `extensions_get`, `extensions_create`, `extensions_update`, `extensions_versions`, `extensions_rollback`, `extensions_run`, `extensions_delete` (підтвердження) | Чого не робити: не пробувати змінити чуже — відповідь буде 403; не повторювати видалення з `pending_id`; перед `sections_create` подивитися `sections_rule_targets`, куди можна передавати дані; розширення — лише в стилі NeoHelomi. ## Додаткова інформація - Пов'язані статті: [ШІ-співробітники](ai-employees.md), [Власні розділи](custom-sections.md), [Розширення (код)](extensions.md), [Типи даних і поля](settings-fields.md). --- # ШІ Артур — що купити: аналітика закупівель Артур — ШІ-програма, яка рахує, що саме й скільки треба придбати. Він бере угоди, склад і партії розділу «Закупівлі» вашої CRM, дивиться, скільки днів товар реально лежав на полиці, рахує попит, тренд і цільовий запас, і дає по кожному товару рекомендацію: купити зараз, купити більше, планово, зменшити або не купувати. Поруч — аномалії (хіт без залишку, розрив до приходу партії, залежування), неліквіди з замороженими грошима, ABC за виручкою, гроші на найближчі 30/60/90/180 днів, прогноз прибутку, симулятор бюджету і готовий список для ШІ Колі. Усе це — у вікні «Що купити» на весь екран, і працює саме: дані беруться з CRM, застарілий розрахунок перераховується при відкритті. У CRM Артур нічого не записує; Excel-файли й окремий застосунок більше не потрібні. ## Можливості - Вікно «Що купити»: скільки грошей треба на закупівлю (товарів, штук), очікуваний прибуток і ROI, скільки товарів «купити зараз», аномалії, неліквіди. - Список «Що купити» з фільтрами за статусом і ABC, сортуванням (пріоритет, кількість, прибуток, ризик, попит, залишок, артикул) і пошуком: залишок, у дорозі, попит на місяць, на скільки вистачить, тренд, скільки купити, сума, ROI; «Показати ще»; експорт TSV. - Картка товару: усі цифри розрахунку, партії, що їдуть, поставки за період, продажі по місяцях, причина рекомендації; «Чому саме стільки?» — пояснення моделлю. - Аномалії без моделі: велика разова угода, стрибок або просів попиту, хіт без залишку, розрив до приходу партії, ризик залежування, мінус на складі. - Неліквіди: глибокі мертві, згасаючі, повільні — з замороженими грошима, покриттям і порадою; повний список із сортуванням. - ABC за виручкою, розподіл за статусами, топ-10 за пріоритетом, бюджет проти прибутку, гроші на 30/60/90/180 днів, прогноз прибутку на 6 місяців. - Симулятор бюджету і список для ШІ Колі одним натиском, з редагуванням кількостей і собівартості. - «Не закуповуємо», партії вручну, «Як прочитано дані». - Під себе: промпт пояснень, що показувати у вікні (вкладка, сортування, колонки, блоки), вигляд списку для Колі, сума й кнопки бюджету, повідомлення «купити зараз» і про важливі аномалії. - Ним керують інші ШІ (Ломі, Остап) інструментами `ai_artur_*`. ## 1. Картка в «Інтеграції → ШІ» Картка «Артур» показує, чи працює він зараз, і веде до нього: фото в ореолі, ім'я, роль, пігулки стану («працює», «спить», «помилка») і виду «Програма». Дій рівно три. 1. Перемикач «Увімкнено» — вимкнений Артур не перераховує за розкладом, «Перерахувати», «Чому саме стільки?» і «Запитати Артура» сірі, інструменти керування для інших ШІ відповідають 409; останній розрахунок лишається видимим. 2. «Відкрити» — вікно «Що купити» (розділ 2). 3. «WIKI» — ця стаття шторкою. Артура ще нема в організації — на картці «Додати» і «WIKI»: «Інтеграції → ШІ → Артур → Додати». Артур поки доступний лише організації №1 (як і розділ «Закупівлі»). Сторінка «Закупівлі» для людей працює і без нього. ## 2. Вікно «Що купити» Вікно — робоче місце Артура на весь екран (`/crm/artur`): бокове меню згортається в рейку ☰, розділи переїжджають на нижню панель швидкого доступу. Сюди ведуть «Відкрити» в картці «Артур» і в «Структурі», «ШІ Артур · купити N» у шапці «Закупівель» («⋮ → ШІ Артур: що купити»), кружечок «Відкрити вікно» в налаштуваннях і стара адреса `/apps/artur/`. У шапці — ім'я, «порахував …», пігулки стану й виду і кружечки «Налаштування» (розділ 3, тут же у вікні), «Журнал», «?» (ця стаття), «Згорнути» (повернути звичайну розкладку). Далі: - **KPI**: «До закупівлі» (чорна — сума, товарів, штук), «Очікуваний прибуток» (ROI), «Купити зараз», «Аномалій», «Неліквіди». - **Що купити** — список товарів. Типово відкривається вкладка «купити» (лише те, що треба купити); пігулки статусів показують «купити зараз», «купити більше», «планова закупівля», «зменшити», «не купувати», «перевірити вручну» й «усі»; пошук за артикулом або назвою. У рядку — залишок, у дорозі, попит на місяць, на скільки вистачить, тренд, скільки купити, сума, ROI; «Детальніше» відкриває картку товару. - **Перерахувати** — крок Артура: перечитує угоди, склад, закупівлі й знімки залишків і пише підсумок у «Журнал» («Порахував 412 товарів: купити 37 (1 240 шт на 318 500 грн, очікуваний прибуток 401 000 грн) · купити зараз 9 · …»). Той самий крок іде сам за розкладом; поки рахує — «Рахую…» на кнопці, підсумок — повідомленням угорі праворуч. - Другий рядок інструментів: фільтр **ABC**, **сортування**, «**Не закуповуємо**» (розділ 8), «**Партії вручну**» (розділ 8), «**TSV**» (експорт таблиці рекомендацій). Список показує по 60 рядків — «Показати ще» догружає. - **Аномалії** й **Неліквіди** — рядками з переходом у картку товару; **Гроші на закупівлі**, **Прогноз прибутку на 6 місяців**, **ABC за виручкою**, **Розподіл за статусами**, **Топ-10 за пріоритетом**, **Бюджет і прибуток (топ-10)**, **Бюджет**, **Висновки Артура**, **Як прочитано дані**. Які з них видно і скільки колонок у списку — «Налаштування → Що показувати». Повідомлення про результат дії (перераховано, скопійовано, TSV, помилка) з'являються поверх сторінки праворуч угорі; помилка висить, доки її не закриють або не повторять дію. Вимкнений Артур — смуга «Артура вимкнено» над KPI. Телефон: KPI по два в ряд, рядок списку — назва зверху, цифри підписами, статус і «Детальніше» внизу; картка товару — шторкою на весь екран. ## 3. Налаштування Тут Артура підлаштовують під себе: як він рахує, що показує у вікні, як пояснює і кому повідомляє. Кожне поле має рядок-підказку під собою; змінили — діє з наступного відкриття вікна чи перерахунку, без перезапуску. Відкривається тут же, у вікні: кружечок «Налаштування» праворуч угорі (адреса `/crm/artur?view=settings`) — робоче місце ховається, меню лишається в рейці. Натиснутий кружечок — «Назад до роботи»: список одразу показує змінене (налаштування вигляду перечитуються, змінена математика перераховується сама). Рядок «Налаштування → Команда → ШІ-співробітники → Артур» веде сюди ж. Вкладки — **Налаштування · API · Огляд · Журнал**. Угорі перемикач «Для всіх» (діє для всієї організації) і «Для мене» (лише для вас): «Що показувати», «Список для Колі», «Бюджет», «Моє доповнення», тон і звертання кожен налаштовує собі. Змінили лише вигляд, пояснення чи повідомлення — розрахунок не перераховується; змінили математику (період, покриття, поріг, ваги, артикули, неліквіди, ABC) — наступне відкриття вікна перераховує саме. | група | поле | що означає | типово | | --- | --- | --- | --- | | Характер | Інструкція для ШІ (персона, промпт) | що Артур читає першим у чаті з ним, MCP і файлі сесії | інструкція шаблону | | | Моє доповнення до інструкції | ваше доповнення — і в чаті, і в поясненнях моделлю («завжди кажи, скільки днів до приходу партії») | порожньо | | | Тон · Звертання | діловий чи дружній; «ви» чи «ти» — і в поясненнях | як в інструкції | | | Мова відповідей | англійська — пояснення й висновки англійською | українська | | | Застосовувати зміни | Артур нічого не записує в CRM; поле — для однаковості з іншими ШІ | так | | Пояснення моделлю | Як пояснювати (промпт для моделі) | що модель читає першим у «Чому саме стільки?» і «Запитати Артура»; формат відповіді Артур додає сам | «Ти — Артур, аналітик закупівель… коротко й конкретно, з цифрами…» | | | Глибина пояснення | «коротко (дешевше)» чи «детальніше (більше токенів)» | коротко | | Період аналізу | Скільки останніх днів продажів брати | вікно, з якого рахуються попит, тренд і ABC | 150 | | | Менше стількох днів на полиці — довіра нижча | коротка історія наявності знижує коефіцієнт довіри (×0,7) | 10 | | Модель закупівлі | Час доставки нової закупівлі, міс | скільки їде партія від замовлення до складу | 2 | | | Цільове покриття після приходу, міс | на скільки місяців має вистачити після приходу нашого замовлення | 4,5 | | | Страховий запас, міс | додаток до цільового покриття | 0,5 | | | Поріг дозамовлення, міс | якщо складу й дороги вистачає на стільки місяців — цього разу не купуємо | 2 | | | Як часто робимо закупівлі, днів | довідково: горизонт планування | 30 | | Ваги вікон попиту | 30 / 60 / 90 / 150 днів | як зважуються швидкості продажів за різні вікна (вікно з малою наявністю важить менше саме) | 0,35 / 0,30 / 0,25 / 0,10 | | Артикули | Не аналізувати артикули з префіксами | друк на замовлення — не закуповується | `3D` | | | …крім префіксів | закуповуваний товар серед них: філамент, запчастини | `3DF,3DZ` | | | Не аналізувати точні артикули | службові | `0000` | | | Пропускати «A + одна цифра» | A1–A9 — маркувальні мітки, не товар | так | | | Не закуповуємо | ваш список: зняли з продажу, тимчасово не беремо (через кому або з нового рядка) | порожньо | | | Набори «артикул=скільки видів у наборі» | `A000001-N*`: N — номер лістингу, а не кількість; у наборі по одному порошку кожного виду | `A000001=3` | | Неліквіди | Неліквід, якщо за 90 днів продано не більше, шт | | 2 | | | …або залишку вистачає більше ніж на, міс | | 6 | | ABC за виручкою | Група A — до, % виручки · Група B — до, % виручки | | 80 · 95 | | Що показувати (для мене) | Яку вкладку списку відкривати | «купити», «купити зараз» чи «усі товари» | купити | | | Сортування списку | за пріоритетом, кількістю, прибутком, ризиком, попитом, залишком чи артикулом | за пріоритетом | | | Рядків у списку за раз | стільки видно одразу; «Показати ще» догружає стільки ж (10–200) | 60 | | | Колонки списку | відмічені колонки (залишок, у дорозі, попит/міс, вистачить, тренд, купити, сума, ROI); нічого не відмічено — усі | усі | | | Показувати ABC | фільтр ABC над списком і буква групи в рядку | так | | | Ховати «не купувати» у вкладці «усі» | «усі» — лише товари з рекомендацією; «не купувати» лишається окремою пігулкою | ні | | | Блоки під списком | відмічені блоки (аномалії, неліквіди, гроші, прогноз, ABC, статуси, топ-10, бюджет і прибуток, бюджет, висновки, як прочитано дані); нічого не відмічено — усі | усі | | Що показувати (для всіх) | Аномалій · Неліквідів у вікні до «Показати всі» | скільки видно одразу (і в огляді для інших ШІ) | 8 · 5 | | Список для Колі (для мене) | З назвами товарів · Із собівартістю | галочки в шторці «Список для Колі» при відкритті | так · так | | | Порядок рядків | за пріоритетом, артикулом, сумою чи кількістю | за пріоритетом | | | Округлювати кількість угору до кратного | напр. 10 — 37 шт стане 40; лише в списку для Колі | 1 (без округлення) | | | Назва — до стількох знаків | довша назва обрізається | 60 | | | Між колонками | пробіли з вирівнюванням (для чату Колі) чи табуляція (вставити в Excel) | пробіли | | | Кнопка «TSV»: лише те, що треба купити | вимкнено — у файл ідуть усі товари розрахунку | так | | Бюджет (для мене) | Сума в полі «Бюджет» при відкритті, грн | підставляється біля «Порахувати»; 0 — поле порожнє | 0 | | | Швидкі кнопки, % від рекомендованого | кожне число — кнопка під полем; 100 — «максимум» | `25,50,75,100` | | | Після «Порахувати» показувати лише те, що влазить | одразу вмикає галочку «показувати лише те, що влазить» | ні | | Повідомлення | Повідомити, коли «купити зараз» не менше, товарів | після перерахунку, не частіше разу на день; 0 — не повідомляти | 0 | | | Повідомити, коли важливих аномалій не менше | «критично» й «важливо»; 0 — не повідомляти | 0 | | | Кому · Також усім адміністраторам | люди, яким прийде push-сповіщення з посиланням на «Що купити» | нікому · ні | | Цикл | Перераховувати раз на, хв | фоновий перерахунок; кнопка «Перерахувати» — будь-коли | 360 | Повідомлення — push-сповіщення в браузер і телефон; приходять тим, у кого в профілі ввімкнено «Push-сповіщення» («Налаштування → Профіль»). Кожне видно в «Журналі» рядком кроку («· повідомив: купити зараз 9 → 2 пристр.»). Нижче на вкладці — «Доступи й ліміти» (розділи, «Спочатку запитати», ліміти; змінює адміністратор), як у всіх ШІ (стаття «ШІ-співробітники»). ## 4. API Вкладка «API» — як Артуром керують інші ШІ й програми. Угорі **«Вхід для ШІ»**: картка `ai-artur` з усіма інструментами `ai_artur_*` (кожен з підписом, що читає чи змінює, і чи питає людину), стаття для ШІ і хто з мозків має доступ — Ломі чи Остап, у кого в «Доступах і лімітах» стоїть галочка «ШІ Артур». Нижче — «Модель» (для пояснень: типово Claude Sonnet на ключі організації «Інтеграції → ШІ → Anthropic»), «Токени · N», файл сесії й адреси MCP/REST — як у всіх ШІ (стаття «ШІ-співробітники»). ## 5. Огляд і журнал «Огляд» — службовий стан Артура: дій сьогодні, чекають підтвердження, токени й витрати моделі за місяць, останні дії; уся робота — у вікні («Відкрити вікно» вгорі вкладки; запасна адреса `/crm/ai/artur` показує рядок стану й «Відкрити програму»). «Журнал» — кожен перерахунок з підсумком і кожне пояснення моделлю з токенами й вартістю; фільтри «усі», «помилки», «очікують», «виконано». ## 6. Картка товару і «Чому саме стільки?» «Детальніше» у списку (або «Відкрити» в аномаліях, неліквідах, топ-10) відкриває шторку зі статусом, скільки купити на яку суму і причиною одним реченням. Далі групами, як у старих «Деталях»: **Залишки й постачання** (залишок, у дорозі, найближча й остання партія через скільки днів, покриття склад + дорога в місяцях, на скільки вистачить поточного, прогноз залишку на прихід партій і на прихід нашого замовлення); **Продажі й наявність** (продано за 30/60/90/150 днів, угод, на полиці днів з періоду, днів без товару, продаж за день на полиці, втрачено без товару, останній продаж); **Прогноз і рекомендація** (скоригований попит, прогноз до коригування, тренд з коефіцієнтом, довіра, цільовий і страховий запас, рекомендовано, оборотність); **Фінанси** (ціна, собівартість, маржа, інвестиція, очікуваний прибуток, ROI, виручка за період, ABC); партії, що їдуть; поставки за період («100 %+» — продавався і попередній запас); продажі по місяцях. «Чому саме стільки?» — модель пояснює розрахунок, підказує ризики й дії, окремо — «Підозріле в даних» (лише коли щось є); під відповіддю — «Алгоритм каже» (причина без моделі), модель і вартість запиту. Як модель пояснює — «Налаштування → Пояснення моделлю» і ваш «Характер» (доповнення, тон, звертання, мова). ## 7. Список для ШІ Колі й бюджет «Список для Колі» у шапці списку відкриває шторку з текстом «артикул кількість собівартість назва» і «Скопіювати» — далі вставте в чат Колі. 1. Зніміть галочки «з назвами» чи «із собівартістю», якщо треба коротше (типові — у «Налаштування → Список для Колі»). 2. «Редагувати» — змініть кількість чи собівартість, приберіть позицію (її можна повернути); «Скинути зміни» повертає розрахунок Артура. Зміни діють лише на цей список. 3. «Скопіювати» — з'явиться «Скопійовано — вставте в чат Колі». «Бюджет»: впишіть суму (або натисніть швидку кнопку — типово 25 / 50 / 75 % чи «максимум» від рекомендованого) і «Порахувати». Артур жадібно (за пріоритетом і ROI) добирає, що купити спершу, показує, скільки витратимо і яку частку рекомендованого це становить, скільки товарів і штук, скільки заробимо і скільки товарів відкладено з оцінкою втрати. Галочка «показувати лише те, що влазить» переводить чорну KPI у «Витратимо» і залишає в списку лише обране (часткові позиції підписані); «Список для Колі в межах бюджету» — той самий список, лише з обраного. Порожня сума — рядок «Вкажіть бюджет у гривнях» під полем. ## 8. Виключення, партії вручну, експорт Тут — те, що в старому застосунку було на вкладці «Дані»: що не аналізувати, партії без картки в «Закупівлях» і таблиця для Excel. - **Не закуповуємо** (кнопка у другому рядку інструментів; те саме поле, що «Артикули → Не закуповуємо» в «Налаштуваннях»): список артикулів з назвами зі складу (підставляються самі) і датою додавання. Додати один (артикул + назва, Enter), пакетом (рядок — артикул і назва), прибрати хрестиком, «Очистити все» з підтвердженням; уже доданий артикул — рядок «… вже у списку» під полем; «Зберегти й перерахувати» записує список і одразу рахує без цих товарів. - **Партії вручну** — для товару, якого нема в картках «Закупівель»: «у дорозі» (кількість і очікувана дата; без дати — сьогодні + час доставки) або «поставка» (дата приходу; без дати — сьогодні). Пакетно — рядками «артикул кількість дата примітка». Собівартість таких партій у розрахунку 0; у картці товару вони підписані «вручну». Після змін вікно перераховує саме. - **TSV** — таблиця рекомендацій у файл `artur_purchase_list_<дата>.tsv` з колонками SKU, Назва, Залишок, В дорозі, Продаж/міс, Покриття днів, Тренд %, Купити, Статус, Бюджет, Прибуток, ROI % — відкривається в Excel. Типово лише те, що треба купити; усі товари — «Налаштування → Список для Колі → Кнопка «TSV»». ## 9. Як Артур рахує Математика та сама, що в старому застосунку, лише на даних вашої CRM. 1. **Продажі** — з угод за період: етап з роллю «Отримано»/«Відправлено» або назвою «Отримано», «Оплачено», «Відправлено», або результат «виграно»; скасовані, повернення й програні не рахуються. `-N` у артикулі — множник (СК003-N500 → 5 штук СК003, ціна й собівартість ÷ 5); набори за налаштуванням; артикули з виключень не беруться. 2. **Дні на полиці** — зі щоденних знімків залишків (їх пише ШІ Марія з нашого складу): попит = продано ÷ дні, коли товар був. Де знімків ще нема — оцінка за поставками й продажами. 3. **Попит на місяць** — зважена швидкість за вікнами 30/60/90/150 днів (вікно з малою наявністю важить менше), обмежена базовою швидкістю за період (не більше ×1,5), з трендом за 45-денними вікнами (±30 % максимум) і коефіцієнтом довіри. 4. **Скільки купити** — якщо складу й партій у дорозі вистачає менше ніж на поріг дозамовлення: (цільове покриття + страховий запас) × попит − те, що лишиться на момент приходу нашого замовлення. 5. **Статус** узгоджений з кількістю: «купити зараз» — залишок скінчиться раніше, ніж доїде найближча партія або нова закупівля; «купити більше» — швидко розпродується після поставок або попит росте; «зменшити» — попит падає або залишку на півроку+; «не купувати» — вистачає або попиту нема; «перевірити вручну» — менше двох продажів і нічого на складі. 6. **Гроші**: борги за партії в дорозі — як у картках «Закупівель», на дату прибуття; нові закупівлі — платіж наперед, виручка після приходу. **Прогноз прибутку** — продаємо не більше, ніж є на складі з приходами. ## 10. Що змінилось Артур був окремим застосунком; тепер це ШІ-програма в CRM з налаштуваннями «під себе». - 21.10: усе в програмі `/crm/artur` на все вікно, стара адреса `/apps/artur/` веде туди; угоди, склад, закупівлі й знімки залишків — лише ваша CRM; параметри моделі, правила артикулів, виключення, набори, неліквіди, ABC, частота — у «Налаштуваннях»; результат переживає перезапуск сервера. - 22.10: картка в «Інтеграції → ШІ» з трьома діями; налаштування з чотирьох вкладок; «Характер» першою групою. - 23.10: «Пояснення моделлю» (промпт і глибина), «Що показувати», «Список для Колі», «Бюджет», «Повідомлення»; повідомлення про результат дій — поверх сторінки, не рядком у картці; зміна вигляду більше не перераховує розрахунок. ## Можливі помилки | Як показується | Чому | Що зробити | | --- | --- | --- | | «Артура як ШІ-співробітника ще нема…» (404) | Артура не додано з каталогу | «Інтеграції → ШІ → Артур → Додати» | | «Немає доступу до пульта Артура…» (403) | Нема доступу «Закупівлі» чи «ШІ Артур» | Попросіть адміністратора («Доступи й ліміти») | | «Артура вимкнено — увімкніть в «Інтеграції → ШІ»» (409) | Крок чи пояснення у вимкненого Артура | Увімкнути перемикачем | | «Немає ключа моделі: додайте його в «Інтеграції → ШІ → …»» (503) | Для пояснень не задано ключ провайдера | Додати ключ або змінити провайдера на вкладці «API» | | «Не обрано модель — оберіть у вкладці «Підключення»» (503) | Модель стерли | «Налаштування → API → Модель» | | «Артикула «…» в розрахунку Артура нема» (404) | Товар виключений правилами або ще не було перерахунку | Перевірити «Артикули» в налаштуваннях, натиснути «Перерахувати» | | «status — BUY_NOW, BUY_MORE, …», «hide — …» (400) | Невідомий статус у запиті | Один зі списку (або без status — усі) | | «sort — frozen, days, stock, coverage» / «severity — critical, high, medium, low» (400) | Невідоме сортування неліквідів чи рівень аномалій | Один зі списку | | «kind — transit (у дорозі) або delivery (поставка)», «…кількість — число», «…дата — ДД.ММ.РРРР або РРРР-ММ-ДД» (400) | Партія вручну заповнена неправильно | Виправити рядок | | «skus — список артикулів» (400) | Список виключень передано не списком | `{"skus": ["А000123"]}` | | «Змінювати … Артура може адміністратор…» (403) | Налаштування й список «Не закуповуємо» — спільні для організації | Попросити адміністратора чи того, хто підключив | | ««…» — спільне для всіх, змінює адміністратор» | На вкладці «Для мене» змінювали спільне поле (мова, промпт, повідомлення) | Перейти на «Для всіх» (адміністратор) | | «Вкажіть бюджет у гривнях» під полем «Бюджет» | Порожня або нульова сума | Вписати суму або натиснути швидку кнопку | | «застаріло — оновлюю» у шапці списку | Останній розрахунок старший за «Перераховувати раз на», з учора або змінилась математика | Нічого — вікно перераховує саме | | Повідомлення не приходить | Порогу нема (0), нікого не вибрано або в людини не ввімкнено push | «Повідомлення» в налаштуваннях; «Налаштування → Профіль → Push-сповіщення» | | У списку мало товарів, «на полиці за знімками 0 дн» | Знімків залишків ще нема (Марія вимкнена) | Увімкнути Марію; до того дні на полиці — оцінка | ## Для ШІ-співробітників Ключ розділу в каталозі — `ai-artur` (`GET /api/ai/sections/ai-artur`, `help("ai-artur")`); доступ — галочка «ШІ Артур (що купити: аналітика закупівель)» у «Доступах і лімітах» (Ломі має її типово). Самі закупівлі — розділ `procurement` (`purchases_*`), товари — `products_*`. - `ai_artur_status` — стан, налаштування (усі поля схеми), коли рахував, чи застаріло. - `ai_artur_summary` — огляд: скільки купити, статуси, топ-10, аномалії, неліквіди, гроші, прогноз. - `ai_artur_items` (status, abc, q, sort, page, per_page, buy, hide) — рекомендації по товарах із причиною; `hide=DO_NOT_BUY` — без «не купувати». - `ai_artur_item` (sku) — картка товару: усі цифри, приходи, поставки, продажі по місяцях. - `ai_artur_run_step` — перерахувати зараз (підсумок — у журнал; повідомлення — за налаштуваннями «Повідомлення»). - `ai_artur_kolya` (titles, prices, budget) — готовий список для Колі; порядок, округлення й роздільник — з «Список для Колі»; `ai_artur_budget` (amount) — симулятор бюджету. - `ai_artur_explain` (values: sku | question) — пояснення моделлю з промптом «Пояснення моделлю»; витрачає токени ключа організації, тому за вимкненого «Застосовувати зміни» чекає підтвердження. - `ai_artur_anomalies` (severity, type) — усі аномалії з лічильниками; `ai_artur_dead` (sort, category) — усі неліквіди з порадами. - `ai_artur_export` (buy) — таблиця рекомендацій у TSV (поле `text`). - `ai_artur_excluded` — список «Не закуповуємо» з назвами; `ai_artur_manual` — партії вручну; `ai_artur_manual_add` (values.rows або values.text + kind) і `ai_artur_manual_remove` (values.id | all) — додати чи прибрати партію. - `ai_artur_settings_save` (усі ключі схеми: `explain_prompt`, `view_*`, `kolya_*`, `budget_*`, `notify_*`, математика), `ai_artur_enabled`, `ai_artur_excluded_save` (values.skus, values.titles) — через кошик «Керування іншими ШІ». Не вигадуйте артикули — беріть з `ai_artur_items`; «купити» — це рекомендація, закупівлю створює людина (або ШІ через `purchases_*` з підтвердженням). ## Додаткова інформація Пов'язане: [Закупівлі](procurement.md), [ШІ Богдан](ai-bogdan.md), [ШІ Марія Йосипівна](ai-maria.md) (знімки залишків), [Склад: Товари](products.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md), [Остап](ai-ostap.md). --- # ШІ Богдан — закупівлі: партії, собівартість, склад і прихід Богдан — ШІ-співробітник закупівель. Його робоче місце — розділ «Закупівлі»: він розбирає Excel-замовлення постачальника, рахує собівартість кожної штуки (доставка за вагою, товар за курсом, документи відсотком), стежить за партіями в дорозі й боргами перевізнику та постачальнику, заводить нові товари на склад Helomi і робить прихід партії. Усі дані — лише з вашої CRM (KeepinCRM більше не потрібна); налаштування — у його пульті, керувати ним можуть люди й інші ШІ (Ломі). ## Можливості - «Огляд»: скільки товару в дорозі (на суму), скільки ще винні по частинах, які партії запізнюються, які прибули без приходу. - Черга «що зробити» з переходом просто в закупівлю; найближчі прибуття. - Розрахунок собівартості на сторінці закупівлі за формулою Богдана, типові курси — з його налаштувань. - Нові товари партії — на склад Helomi (назва й одиниця — за налаштуваннями), прихід — на обраний склад. - Спільна таблиця Колі: нові товари, кількості й ціни з Excel-файлу чи партії. - Ним керують інші ШІ інструментами `ai_bogdan_*`; запис на склад за дорученням — через кошик підтверджень. ## 1. Налаштування Богдан з'являється в «Інтеграції → ШІ» як картка «Богдан» (вид «Програма») і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» веде в його вікно — «Закупівлі»; кружечок «Налаштування» праворуч угорі вікна — його налаштування, вкладка «Налаштування»: | поле | що означає | типово | | --- | --- | --- | | Заводити товари й прихід на склад за дорученням інших ШІ | без галочки Богдан лише показує стан; товари й прихід робить людина на сторінці «Закупівлі» | так | | Типовий курс доставки, грн/$ | підставляється в нову закупівлю (у закупівлі можна змінити) | 44 | | Типовий курс закупки, грн/$ | те саме для ціни товару | 44 | | Типовий курс юаня, грн/¥ | якщо більше 0 — у таблиці собівартості ще й ціна в юанях | 0 (не показувати) | | Не вважати боргом залишок до, грн | хвіст від курсу чи комісії банку: частина з таким залишком вважається сплаченою | 10 | | Позначати партію «запізнюється» через скільки днів після дати прибуття | 0 — одразу наступного дня після приблизної дати | 0 | | Одиниця нового товару на складі | одиниця товарів, які Богдан заводить з партії | шт. | | Назва нового товару | шаблон: `{title}` — назва з файлу, `{sku}` — артикул | `{title} ({sku})` | | Адреса спільної таблиці товарів | catalog-service таблиці Колі; порожньо — сервер організації №1 | — | Змінене діє одразу, без перезапуску. ## 2. Увімкнути або вимкнути Богдана Перемикач на плитці «Богдан» в «Інтеграції → ШІ» або «⋯» у шапці пульта. Вимкнений Богдан не перевіряє партії («Перевірити партії» сіра) і не виконує доручень інших ШІ (інструменти керування → 409); сторінка «Закупівлі» для людей працює як завжди. ## 3. Пульт: огляд і «Перевірити партії» Пульт відкривається з плитки, з картки «Богдан» у «Структурі» («Відкрити») або на сторінці «Закупівлі» (посилання «ШІ Богдан» у шапці, «⋮» → «Пульт ШІ Богдана»). Вкладка «Огляд»: - **KPI**: «У дорозі» (сума партій «замовлено» й «в дорозі»), «Ще винні» (перевізнику · постачальнику · за документи), «Запізнюються», «Прибули без приходу». - **Що зробити** — партії, що запізнюються (дата прибуття минула), прибули без приходу на склад, і з боргом. «Відкрити» — закупівля на сторінці «Закупівлі». - **Найближчі прибуття** — партії в дорозі з датою прибуття попереду. - **«Перевірити партії»** — крок Богдана: перераховує чергу й пише підсумок у «Журнал» пульта («Перевірено партій: N · запізнюються … · без приходу … · з боргом …»). Окремого фонового циклу нема: огляд і так рахується наживо. Вікно Богдана — сторінка «Закупівлі» (`/crm/procurement`, «Відкрити» на картці); ці KPI й черги — у вікні `/crm/ai/bogdan` («Огляд» налаштувань → «Черги й KPI агента»). Налаштування — кружечок «Налаштування»: вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API», «Огляд», «Журнал». ## 4. Що Богдан робить на складі За дорученням людини (сторінка «Закупівлі», «⋮» картки) чи іншого ШІ: 1. **Нові товари на склад** — звіряє артикули партії з вашим складом, заводить відсутні з залишком 0, собівартістю з розрахунку й ціною продажу. У журналі закупівлі — «ШІ Богдан · за дорученням …», якщо доручав ШІ. 2. **Прихід на склад** — кількість партії на обраний склад (головний — типово), ціна за штуку = собівартість. Повторний прихід зробить дубль: позначка «· зроблено» на картці саме для цього. Гроші Богдан не рухає: оплати партій проводить людина (або ШІ через кошик «Платежі») — див. статтю [Закупівлі](procurement.md). ## 5. Що змінилось після перенесення - Сторінка «Закупівлі» переїхала на `/crm/procurement` у стилі Helomi; стара адреса веде туди ж. Функції ті самі. - Склад, прихід, назви товарів — лише ваша CRM; звернень до KeepinCRM нема. Кнопку «Прайс CRM: шт + Checkbox» прибрано. - Те, що було константами (курси нової закупівлі, допуск хвоста оплати, одиниця й назва нового товару, адреса спільної таблиці), — у налаштуваннях вище. - У кожної закупівлі — «Журнал змін»: хто що змінив (люди й ШІ), склад, прихід, таблиця Колі. - Файли закупівель кожної організації — у її теці. Стара програма `/apps/bogdan/` більше ніде не відкривається. ## Можливі помилки | Як показується | Чому | Що зробити | | --- | --- | --- | | «Богдана як ШІ-співробітника ще нема…» (404) | Богдана не додано з каталогу | «Інтеграції → ШІ → Додати → Богдан» | | «Немає доступу до пульта Богдана…» (403) | Нема доступу «Закупівлі» чи «ШІ Богдан» | Попросіть адміністратора («Доступи») | | «Богдана вимкнено — увімкніть в «Інтеграції → ШІ»» (409) | Доручення чи крок у вимкненого Богдана | Увімкнути перемикачем | | «У Богдана вимкнено «Заводити товари й прихід…»» (409) | ШІ доручає склад, а галочку знято | Увімкнути в «Налаштуваннях» або зробити на сторінці «Закупівлі» | | «Змінювати налаштування Богдана може адміністратор…» (403) | Налаштування міняє не той, хто його підключив | Попросіть адміністратора | | «Адресу спільної таблиці не налаштовано…» (409) | Порожня адреса таблиці Колі на сервері не організації №1 | «Налаштування» → «Спільна таблиця Колі» | | «kind — overdue, supply або debt» (400) | Невідомий вид черги | Один із трьох | ## Для ШІ-співробітників Ключ розділу в каталозі — `ai-bogdan` (`GET /api/ai/sections/ai-bogdan`); доступ — галочка «ШІ Богдан (закупівлі: партії, склад, прихід)» у «Доступах» (Ломі має її типово). Самі закупівлі — розділ `procurement` (`purchases_*`, `purchase_*`). - `ai_bogdan_status` — стан, налаштування, чи задана спільна таблиця. - `ai_bogdan_summary` — огляд: партії за станами, у дорозі на суму, борги по частинах, черга, найближчі прибуття. - `ai_bogdan_queue` (kind: overdue | supply | debt) — черга «що зробити». - `ai_bogdan_run_step` — крок зараз (підсумок — у журнал пульта). - `ai_bogdan_warehouse_check` (purchase_id, friends) — кого з партії немає на складі. - `ai_bogdan_warehouse_add` (purchase_id, values: items?, friends) і `ai_bogdan_supply` (purchase_id, values: warehouse_id?, friends) — доручення складу через кошик «Масові дії»; Богдан має бути увімкнений і з галочкою «Заводити товари й прихід…». - `ai_bogdan_settings_save`, `ai_bogdan_enabled` — через кошик «Керування іншими ШІ». Не вигадуйте id закупівель і складів — беріть з `ai_bogdan_queue`, `purchases_list`, `purchase_supply_refs`; не робіть прихід партії вдруге. ## Додаткова інформація Пов'язане: [Закупівлі](procurement.md), [Фінанси](finance.md), [Склад: накладні](warehouse-docs.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md). --- # ШІ Олесь — обробка замовлень: перевірки, ТТН, на збірку, «Допомога» Олесь — ШІ-агент 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). --- # ШІ Віктор — склад: збірка замовлень, наявність, повернення Віктор — складський ШІ-співробітник Helomi без ШІ-мозку: він не розмовляє в чаті, а крутить цикл. Кожні кілька хвилин бере з «Угод» замовлення на етапі «Передали на збірку», видає їх збирачам на сторінці «Склад», після «Зібрано» переводить угоду далі й пише нотатку, стежить за товарами з малим залишком і розбирає повернення, забрані з пошти. Усі дані — з вашої CRM (угоди, товари, документи), налаштування — у його пульті, керувати ним можуть люди й інші ШІ (Ломі). ## Можливості - Черга збірки з угод: етапи з роллю «Передали на збірку» у вибраних воронках, будь-якої давності. - Картка замовлення для збирача: позиції з фото, артикулом і місцем, ТТН і перевізник, документи угоди, коментар складу, попередження про чужу ТТН чи доставку за наш рахунок. - «Зібрано» → етап з роллю «Зібрано» + нотатка хто і коли зібрав; «Повернути менеджеру» → етап «Допомога» + причина. - Перевірка наявності: запити «перерахуйте» на товари із залишком від 1 до порога; записаний підрахунок стає рухом «перерахунок» у картці товару. - Розбір повернень: позиції повертаються на склад штатною дією угоди, часткове повернення лишає решту списаною. - Усе підписане «ШІ Віктор» у журналі картки угоди, товару і в «Журналі» пульта. - Гра для збирачів «ШІ Кіт» (вкладка «Склад → ШІ Кіт», кіт-король Кіктор) з балами за зібрані посилки й перевірки; кіт говорить через Ломі — [окрема стаття](kiktor.md). ## 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 шт» (загублено, пошкоджено, не наш). «Повернути товар на склад» → для кожної повернутої позиції виконується штатна дія угоди «Повернути» (залишок плюс), не повернуті штуки лишаються списаними; при частковому поверненні решта списується назад, а якщо не вийшло — менеджеру ставиться завдання в угоді. У картку угоди іде нотатка з підсумком. > [!IMPORTANT] > Щоб товар повертався на склад лише тут, після перевірки, етап «Повернення» має «Склад: нічого» («Налаштування → Воронки й етапи», 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`; не повторюйте дію, що вже чекає підтвердження. ## Додаткова інформація Пов'язане: [Склад і товари](products.md), [ШІ Кіт](kiktor.md), [Угоди](deals.md), [Воронки й етапи](settings-funnels.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md). --- # ШІ Ростік — доставки: статуси посилок, хто не забирає, повернення Ростік — ШІ-співробітник Helomi, який супроводжує посилки після відправки, без ШІ-мозку: він не розмовляє від себе, а крутить цикл. Кожні кілька годин бере всі активні ТТН з блоку «Доставка» ваших угод, звіряє їхні статуси на сайтах служб (Нова Пошта, Укрпошта, Meest, Rozetka Delivery), переводить угоди на етапи за вашими налаштуваннями перевізника, рахує дні на відділенні й кому вже час дзвонити, стежить за поверненнями (коли прийшло на ваше відділення, з якого дня йде комісія, коли забрали), а менеджерам показує все це на сторінці «Доставки» і в його пульті. Усі дані — з вашої CRM, налаштування — у пульті, керувати ним можуть люди й інші ШІ (Ломі). ## Можливості - Усі активні ТТН з угод під наглядом: статус із сайту служби, номер відділення, післяплата, телефон отримувача (Нова Пошта віддає його сама). - Етап угоди змінюється за статусом посилки — за таблицею «Пов'язані статуси» у налаштуваннях перевізника, від імені «ШІ Ростік» у журналі картки. - Сторінка «Доставки»: вкладки «В роботі», «Отримано», «Повернення» (забрати / забрано), дні на відділенні, скільки лишилось безплатного зберігання, «щось не так» (ТТН створена, але посилку не віддали; служба давно не оновлює статус). - Кому подзвонити: лежить на відділенні від N днів і нещодавно не дзвонили; результат дзвінка записується в картку й у нотатку угоди. - Нагадування клієнтам «заберіть посилку» через ШІ Люду, по службах (день приходу = 1-й): Нова Пошта (5 днів) — лист день 2, Telegram день 3 зранку, дзвінок з дня 4, SMS день 4 о 15:00; Укрпошта, Meest, Rozetka Delivery (7 днів) — лист 2, Telegram 4, дзвінок 6, SMS 6. SMS лише тим, кому менеджер того дня не додзвонився; уночі не пишемо; кожен канал один раз. Дні й години — у налаштуваннях. - Повернення: день приходу на ваше відділення, пуш менеджерам на 3/4/5 день (день 5 — останній безплатний, з 6-го йде комісія), зворотна ТТН Нової Пошти, «забрали» → угода «Програно», покупець у BlackBox, нотатка в угоду. - ТТН скасованих угод, які так і не поїхали, скасовуються у службі (своя накладна) і зникають з «Доставок». - ТТН Ростік не створює — він стежить за вже створеними. Вагу й розмір посилки в ТТН (і в Олеся, і в шторці, і в авто-ТТН) задає галочка «Вага й габарити з товарів» у картці служби ([Доставки і ТТН, 3а](shipping.md#3а-вага-й-габарити-з-товарів-угоди)); у журналі угоди біля ТТН видно, з якими числами пішла посилка. - Щоденний дайджест у чат («кому подзвонити», «що забрати») — вмикається на чат. - Усе підписане «ШІ Ростік» у журналі картки угоди і в «Журналі» пульта (кожен крок: скільки звірено, етапів, повернень). ## 1. Налаштування Ростік з'являється сам в «Інтеграції (головне меню) → ШІ» як плитка «Ростік» і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» на картці веде у вікно ШІ, кружечок «Налаштування» праворуч угорі вікна — його налаштування (вкладка «Налаштування»). Усі значення — тут, у коді нічого міняти не треба: | Група | Налаштування | Що означає | Типово | | --- | --- | --- | --- | | Загальні | Застосовувати зміни до угод | Вимкнено — Ростік лише стежить за статусами, угоди не чіпає (ні етапів, ні «Програно», ні нотаток) | так | | Цикл | Як часто звіряти статуси на сайтах служб, хв | Період кроку | 120 | | Цикл | Стежити за ТТН угод не старших за, днів | Старші беруться лише поки їхня посилка ще «в роботі» чи «повернення» | 90 | | Цикл | Макс. переведень етапу за один крок | Запобіжник від масової зміни етапів | 40 | | На відділенні | Подзвонити клієнту з якого дня на відділенні | Коли картка стає «треба подзвонити» | 3 | | На відділенні (по службах) | Безплатне зберігання, днів; лист / Telegram / дзвінок / SMS — на який день | Лічильник «лишилось днів», список «Подзвонити», графік Люди | НП 5: 2 / 3 / 4 / 4; Укрпошта, Meest, Rozetka 7: 2 / 4 / 6 / 6 | | На відділенні | Лежить понад N днів — ховати як застарілу | Щоб вкладка не засмічувалась | 30 | | Зависло | ТТН створена, посилку не віддали — попередити з дня / ховати через | Позначка «щось не так» і приховування | 7 / 60 | | Зависло | Служба не оновлює «в дорозі» — попередити з дня / ховати через | Те саме для посилок у дорозі | 10 / 60 | | Повернення | З якого дня на вашому відділенні йде комісія | Для підпису й червоної позначки | 7 | | Повернення | Нагадати менеджерам забрати повернення на дні | Пуш адміністраторам, через кому | 5,6,7 | | Повернення | Повернення «в дорозі» без руху понад N днів — ховати | Мертві відмови | 14 | | Повернення | Забрали зі складу → закрити угоду як «Програно» | Етап ролі «Програно» + архів | так | | Повернення | Забрали → внести покупця у BlackBox | Потрібен ключ «Інтеграції → BlackBox» | так | | Нагадування через Люду | Передавати Люді нагадування «заберіть посилку» | Шле реальні повідомлення клієнтам | ні | | Нагадування через Люду | Передавати Люді; також SMS (лише кому не додзвонилися); години: писати з, SMS з, не писати з | Кожен канал один раз; лист і Telegram з ранку, SMS з години SMS, уночі мовчимо | ні; ні; 9 / 15 / 22 | | Нагадування через Люду | Макс. нагадувань за крок; адреса вебхука Люди; коди джерел | М'який старт; куди слати; назва=код для Люди | 5; адреса; OLX=…, Prom=… | | ТТН скасованих угод | Скасувати ТТН і сховати; макс. за крок | Угоду скасовано, посилку службі не віддали | так; 15 | Етапи за статусом Ростік не вгадує: вони задаються в «Інтеграції → Нова Пошта (Укрпошта, Meest, Rozetka) → Пов'язані статуси» — статус служби → етап, окремо для післяплати. Нема рядка для статусу — етап не змінюється. Поки посилку не здали службі («створена, ще не відправлена»), етап Ростік не міняє взагалі (власник 16.10: «лише на відправлено, у відділенні, отримано і повернення») — стани задаються там само, перемикачами «Міняти етап, коли посилка». Після збереження зміни діють із наступного кроку, без перезапуску. ## 2. Увімкнути або вимкнути Ростіка «Інтеграції → ШІ» → плитка «Ростік» → перемикач «Увімкнено». Те саме в пульті: «⋯ → Вимкнути». Вимкнений Ростік не робить нічого: цикл пропускається, «Запустити крок» сірий, дайджести в чат не йдуть, інструменти інших ШІ відповідають «ШІ вимкнено». Сторінка «Доставки» показує те, що було на момент вимкнення. ## 3. Як посилка потрапляє під нагляд і що робить крок Посилка з'являється в «Доставках», коли в угоді є ТТН у блоці «Доставка» (створена з угоди або додана вручну). На кожному кроці Ростік: 1. Бере активні ТТН угод (не старші за «днів» з налаштувань плюс усі, що ще «в роботі» або «повернення») і оновлює картку посилки з угоди: клієнт, телефон, товари, джерело, етап, сума, післяплата. 2. Одним запитом на службу звіряє статуси всіх ТТН на сайтах служб: категорія («в роботі», «отримано», «повернення»), під-стан («створено, не відправлено», «прийнято», «в дорозі», «у відділенні»), відділення, дата останньої події. Для повернень Нової Пошти читає зворотну ТТН — вона каже, чи повернення ще їде, чи вже лежить на вашому відділенні, чи ви його отримали. 3. Переводить угоди на етапи за «Пов'язаними статусами» (розділ 4), розбирає повернення (розділ 6), нагадує (розділ 5), прибирає ТТН скасованих угод (розділ 7), ховає з трекера ТТН, яких в угодах більше нема. 4. Пише підсумок у «Журнал» пульта: скільки доставок, звірено по службах, етапів переведено, повернень забрано, нагадувань. «Запустити крок» у пульті або «Звірити» на сторінці «Доставки» робить це зараз, не чекаючи періоду. ## 4. Етапи угоди за статусом посилки Коли статус зі служби збігається з рядком «Пов'язаних статусів» перевізника (точно або за шаблоном з XXXX), угода переходить на вказаний етап своєї воронки — тією самою дією, що й кнопка людини: журнал картки з автором «ШІ Ростік», складські наслідки етапу, тригери, автодії. Той самий етап — нічого; заархівовані угоди не чіпаються; за один крок — не більше, ніж у налаштуванні «Макс. переведень». «Застосовувати зміни» вимкнено — етапи не змінюються, статуси лише показуються. ## 5. На відділенні: дзвінки й нагадування клієнтам Посилка лежить на відділенні від «дня дзвінка» і клієнту не дзвонили останні 20 годин (після «сказали, що заберуть» — 48) → картка стає «треба подзвонити», а в пульті вона в списку «Подзвонити» з телефоном. Результат дзвінка («не взяли слухавку», «сказали, що заберуть», «відмовилися», «інше» з коментарем) записується в картку і нотаткою в угоду з іменем менеджера. Якщо увімкнено «Передавати Люді нагадування», на день Telegram / пошти / SMS Ростік передає ШІ Люді дані клієнта і замовлення з вашої CRM; Люда шле повідомлення і повертає результат («доставлено», «нема контакту»), Ростік пише нотатку в угоду. Кожен канал — один раз на посилку. ## 6. Повернення Відмова або повернення за статусом служби → посилка у вкладці «Повернення → Забрати». Коли служба показує, що повернення прибуло на ваше відділення, Ростік фіксує день приходу (день приходу — 1-й) і на дні з налаштування шле адміністраторам пуш «Забери повернення» (з якого дня йде комісія — у підписі). Коли служба показує, що ви його отримали (зворотна ТТН Нової Пошти, «вручено відправнику» в Укрпошти / Meest), або менеджер відмітив «забрали» на сторінці — Ростік закриває угоду як «Програно» (етап ролі «Програно» своєї воронки, архів, нотатка з причиною), вносить покупця у BlackBox (якщо є ключ і увімкнено) і пише нотатку в угоду. Повернені товари далі розбирає Віктор на сторінці «Склад → Повернення». ## 7. ТТН скасованих угод Угода на етапі ролі «Програно» (або закрита як програна), а свіжий статус служби каже «створено, посилку не віддали» → Ростік скасовує ТТН тією самою дією, що й кнопка «Скасувати» в блоці «Доставка»: свою накладну видаляє у службі, чужу (Kasta, Prom) лише позначає скасованою з підказкою видалити в кабінеті; картка зникає з «Доставок», в журнал угоди іде запис. Посилки, які вже прийняла служба, не чіпаються. ## 8. Пульт Ростіка і сторінка «Доставки» Вікно — `/crm/ai/rostik` («Відкрити» на картці в «Інтеграції → ШІ» чи в «Структурі»): скільки на відділенні (чорна картка) і кому подзвонити, в дорозі, не відправлені, повернень забрати, післяплата на відділеннях; цикл (як часто, останній крок, «Запустити крок»); списки «Подзвонити» (ім'я, товар, джерело, телефон, ТТН, відділення, днів) і «Забрати повернення» (ТТН, служба, відділення, день — з червоною позначкою, коли комісія вже йде). Налаштування — кружечок «Налаштування» у вікні: вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API», «Огляд», «Журнал». На комп'ютері пульт відкривається на весь екран (меню хоста в рейку ☰, розділи на нижній панелі швидкого доступу), «Згорнути» повертає як було; на телефоні — док знизу, KPI по два в ряд. Сторінка «Доставки» (меню «Доставки») — робочий список менеджера з тими самими даними: пошук за ТТН / телефоном / угодою / клієнтом, картка посилки з посиланням на угоду в CRM, дзвінки, «забрали», ручне виправлення статусу після перевірки на сайті служби, «сховати». ## Можливі помилки | Як показується | Чому | Що зробити | | --- | --- | --- | | Статус посилки не змінюється, у «Журналі» `track_errors 1` | Сайт служби не відповів або нема ключа/токена перевізника | Перевірити акаунт у «Інтеграції → перевізник»; наступний крок спробує знову | | ТТН довго без статусу служби, «… статус ще недоступний» | Номер записано з пробілами («20 4005 5552 6300» із сайту НП) — до 15.10 трекер такий номер пропускав; тепер питає службу без пробілів | Нічого: наступний крок оновить статус; якщо ні — перевірте номер на сайті служби | | Угода не переходить на етап, хоч статус змінився | Нема рядка для цього статусу в «Пов'язаних статусах» або «Застосовувати зміни» вимкнено | Додати рядок статус → етап у налаштуваннях перевізника; увімкнути «Застосовувати» | | У нотатці: «не вдалося закрити угоду як «Програно»: …» | Правила воронки або обов'язкова юрособа при закритті | Закрити угоду вручну після виправлення | | Нагадування клієнтам не ідуть | «Передавати Люді» вимкнено (типово) або Люда недоступна (`post_failed` у картці) | Увімкнути в пульті; перевірити адресу вебхука Люди | | Інструмент ai_rostik_* → 403 «ШІ вимкнено» | Ростіка вимкнули | Увімкнути в «Інтеграції → ШІ» | | Посилка зникла зі списку | ТТН видалили з угоди, угоду скасували й посилку не відправили, або посилка застаріла за порогами | Знайти через пошук (приховані не показуються) або переглянути угоду | ## Для ШІ-співробітників Ключ розділу в каталозі — `ai-rostik` (`describe_section("ai-rostik")`, `GET /api/ai/sections/ai-rostik`); доступ — галочка «ШІ Ростік (доставки: посилки, повернення)» у «Доступах» співробітника (Ломі має її типово). - `ai_rostik_status` — стан, налаштування, останній крок. - `ai_rostik_summary` — зведення: в роботі, на відділенні, кому подзвонити, в дорозі, не відправлені, повернення, післяплата. - `ai_rostik_list` (tab = in_work | archive | to_pickup | returned), `ai_rostik_search` (q), `ai_rostik_get` (картка), `ai_rostik_digest` (кому подзвонити / що забрати). - `ai_rostik_run_step` — крок зараз. - `ai_rostik_call` — записати результат дзвінка (outcome, note); `ai_rostik_fix_status` — виправити стан після перевірки на сайті служби. - `ai_rostik_return_handled` — відмітити «повернення забрали» (угода → «Програно», BlackBox) — через кошик підтверджень «масові дії». - `ai_rostik_settings_save` — змінити налаштування (ті самі перевірки, що в пульті); `ai_rostik_enabled` — увімкнути/вимкнути. Обидві — через кошик підтверджень «Керування іншими ШІ». Не вигадуйте id посилок — беріть їх з `ai_rostik_list` / `ai_rostik_search`; не повторюйте дію, що вже чекає підтвердження; етапи угод не змінюйте в обхід «Пов'язаних статусів». ## Додаткова інформація Пов'язане: [Угоди](deals.md), [Нова Пошта](int-nova-poshta.md), [Укрпошта](int-ukrposhta.md), [Meest](int-meest.md), [Rozetka Delivery](int-rozetka-delivery.md), [BlackBox](int-blackbox.md), [ШІ Віктор](ai-viktor.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md). --- # ШІ Люда — супровід клієнта після замовлення **Що робить.** Пише клієнту від імені бренду, у якого він купив: «замовлення прийнято + номер ТТН», нагадує забрати посилку з відділення, після отримання надсилає фіскальний чек і просить відгук на маркетплейсі. Пише лише на ім'я, безкоштовними каналами (Telegram, пошта); Viber і SMS — лише для чека та останнього нагадування і лише коли є баланс TurboSMS. Жодних «на сайті дешевше»: маркетплейси за це карають. **Де живе.** Два сервіси на сервері: `luda-ai` і `viber-fallback`. Пульт — розділ «ШІ Люда» у меню Helomi (`/luda`): ланцюжок, журнал кожної спроби, черга «не дійшло — зробіть руками», бренди й канали, тексти (редагуються адміном). ## Звідки Люда бере дані (з 18.10.2026 — лише наша CRM) - Угода, клієнт, телефони, пошти, товари, ТТН, бренд — `GET /api/luda/deal/{id}` (за секретом Люди). - Бренд — за папкою складу артикула (коренева папка «ПайПайПласт», «Міністерство тейпів», «PocoPrint», «Перший Шар», «ФЛЮСЕНКО», «Жовтий квадрат»); товари з папки «Товари для авто» — без вітального. - Нотатки про кожну спробу — у картку угоди від «ШІ Люда» (`POST /api/luda/note`). - Результат кожної спроби — у журнал розділу «ШІ Люда» (`POST /api/luda/event`). KeepinCRM більше не використовується (лише як запасний шлях для угод, імпортованих звідти, якщо Helomi не відповів). ## Як Люду запускають: тригери нашої CRM («Налаштування → Тригери») | тригер | коли | що робить Люда | | --- | --- | --- | | ШІ Люда: прийнято + ТТН (автоматично) | у доставці угоди з'явилась ТТН | «прийнято + ТТН» новому (повний текст бренду) або постійному (коротко) клієнту; один раз на угоду | | ШІ Люда: прийнято + ТТН (вручну, галочка) | галочка «Відправити «прийнято + ТТН» (ШІ Люда)» в угоді | те саме ще раз (напр., після зміни ТТН); галочку знімає сама | | ШІ Люда: нагадати забрати посилку (галочка) | галочка «Нагадати забрати посилку (ШІ Люда)» | ручне нагадування «заберіть»; галочку знімає сама | | ШІ Люда: підтвердити замовлення (галочка) | галочка «Підтвердити замовлення (ШІ Люда)» | «Ви замовляли … все вірно? Можемо відправляти?» | | ШІ Люда: повідомлення від менеджера | поле «Коментар для ШІ Люди» заповнене | розгортає коментар у ввічливе повідомлення, або шле свій шаблон за `#код`; поле очищає | | ШІ Люда: чек і прохання про відгук | угода «Отримано» (через 3 хв, чек уже створено тригером Checkbox) | посилання на фіскальний чек + прохання про відгук там, де купили | Автоматичні нагадування «заберіть» (Нова Пошта: день 2 лист на пошту, день 3 зранку Telegram, день 4 о 15:00 SMS; Укрпошта / Meest / Rozetka: лист 2, Telegram 4, SMS 6; день приходу на відділення = 1-й; SMS лише тим, кому менеджер того дня не додзвонився; уночі не пишемо; кожен канал лише раз; для Нової Пошти внизу листа й Telegram — «УВАГА: термін зберігання Нової Пошти змінено із 7 днів на 5, не забудьте забрати») шле **Ростік** зі своїх налаштувань («Інтеграції → ШІ → Ростік → Нагадування клієнтам через ШІ Люду»). ## Поля угоди (блок «ШІ Люда») | поле | тип | навіщо | | --- | --- | --- | | Відправити «прийнято + ТТН» (ШІ Люда) | галочка | надіслати вітальне ще раз | | Нагадати забрати посилку (ШІ Люда) | галочка | ручне нагадування | | Підтвердити замовлення (ШІ Люда) | галочка | запитати клієнта, чи все вірно | | Коментар для ШІ Люди | текст | довільне повідомлення або `#код` свого шаблону | ## Можливі помилки - «нема ні Telegram, ні пошти» — у картці клієнта немає e-mail, а в бренду немає Telegram (Жовтий квадрат, Перший шар, Флюсенко): допишіть пошту клієнту. - «чека Checkbox по угоді немає» — тригер «Чек Checkbox: замовлення отримано» не створив чек (нема каси/зміни/типу оплати): див. журнал того тригера. ## Для ШІ-співробітників Етап 2: шаблон каталогу `luda`, пульт у `crm-ui`, інструменти `ai_luda_*` — наступний PR. Зараз стан і журнал — через розділ «ШІ Люда» (`/api/luda/overview`, `/api/luda/events`). --- # ШІ Марія Йосипівна — бухгалтерія: продажі й маржа, витрати, гроші, прогноз Марія Йосипівна — ШІ-бухгалтерка Helomi. Вона рахує, скільки ви заробили: продажі, собівартість і маржу з угод вашої CRM, прибуток після витрат з «Фінансів», розкладає це по каналах (Prom, Rozetka, OLX…) і фірмах, оцінює склад і товар у дорозі (капіталізація), будує план і прогноз грошей. Витрати, які ви диктуєте їй у чаті («пром 2000»), після вашого «так» заносить у «Фінанси»; виписки банків (НоваПей, Monobank) — сама. Щоранку пише короткий підсумок, нагадує про податки й комісії ОЛХ Доставки. Усі цифри — лише з вашої CRM; вид — «Агент»: працює циклом на сервері, а керувати нею можуть люди й інші ШІ (Ломі, Остап). ## Можливості - Продажі, собівартість, маржа (у гривнях і % від собівартості), прибуток і чистий прибуток за будь-який період — з угод і «Фінансів» вашої CRM. - Аналітика: канали, фірми (за папкою складу товару), топ і аутсайдери товарів, де підняти ціну, витрати з динамікою, поради. - Капіталізація: склад за цінами, за якими ви реально продаєте, і товар у дорозі з «Закупівель»; борги по партіях. - План по місяцях і прогноз грошей: кредитні лінії, скільки можна вкласти в товар, капіталізація через півроку. - Чат: «пром 2000» → «Комісія ПРОМ, 2000 грн, рахунок Монобанк — підтверджуєте?» → «так» → операція у «Фінансах» від імені «ШІ Марія Йосипівна». - Виписки НоваПей і Monobank — у «Фінанси» з категоріями, без дублів (коли банк підключено в «Інтеграціях»); «Вхідні» розбирає сама. - Ранковий підсумок у чат, нагадування про податки з планових податків юросіб, табличка комісій ОЛХ Доставки — кому й що писати, налаштовуєте ви. - Під себе: характер і мова її чату, період звітів, які показники у вікні й як писати суми, кому йдуть повідомлення. - Фінансовий блок «Дашборду директора». Сторінку «Дашборд фінансів» і інструменти `maria_*` відкриває доступ «Дашборд фінансів»; журнал «Фінансів» — окремий доступ «Фінанси» (з 20.10). Питання про цифри на сторінці «Фінанси» (і будь-де) — Ломі, кружечку ШІ: вона питає Марію сама. ## 1. Увімкнути й відкрити Марію (картка в «Інтеграції → ШІ») Картка показує, чи працює Марія зараз, і веде до неї. Вона з'являється сама в «Інтеграції (головне меню) → ШІ» і в «Налаштування → Команда → ШІ-співробітники»; у «Структурі компанії» — стара картка «ШІ Марія Йосипівна» у своєму відділі, «Відкрити» на ній веде у вікно Марії. На картці — фото в ореолі, ім'я, роль, пігулки стану й виду «Агент». Дій рівно три: 1. **«Увімкнено»** — перемикач. Вимкнена Марія не робить кроків: виписки банків не заносяться, нагадування й ранковий підсумок не йдуть, звіти не прогріваються у фоні, «Запустити крок» сірий, інструменти інших ШІ відповідають «ШІ вимкнено». Сторінка «Фінанси» і звіти на вимогу працюють і далі — вони просто рахуються на ходу. 2. **«Відкрити»** — вікно Марії `/crm/ai/maria` (розділ «Подивитися гроші у вікні Марії»). 3. **«WIKI»** — ця стаття шторкою. Вимкнути можна й у налаштуваннях: «⋮ → Вимкнути». Вмикає й вимикає адміністратор або той, хто підключив Марію. ## 2. Подивитися гроші у вікні Марії Вікно — робоче місце Марії на весь екран: тут видно, скільки заробили за період і чи працюють банки. Бокове меню згортається в рейку ☰, розділи — на нижню панель; «Згорнути» праворуч угорі повертає звичайну розкладку. Шапка спільна для всіх ШІ: ореол, ім'я, роль і «крок о …», пігулки стану й виду, кружечки «Налаштування», «Журнал», «?» (ця стаття), «Згорнути». Під нею: - **Показники** за період «Звітів» (типово 30 днів): чорна картка — головна метрика (типово «Маржа» з продажами й кількістю угод поруч), далі «Прибуток» (маржа мінус інші витрати й документи), «Чистий прибуток» (мінус ще й зарплата), «Витрати» (без закупівлі товару й зарплати), «Записано з чату» (за 30 днів, сума і скільки чекає «так»). Що з цього показувати, яка картка чорна і як писати суми — «Налаштування → Звіти» і «Що показувати», кожен для себе. - **«Цикл»** — як часто Марія робить крок, коли був останній, помилка, якщо була, і **«Запустити крок»** — виписки банків, «Вхідні», нагадування й прогрів звітів зараз, не чекаючи циклу. Поки запит іде, кнопка сіра з написом «Запускаю…»; результат — повідомленням угорі праворуч. - **«Гроші й банки»** — режим запису у «Фінанси», Monobank, НоваПей, остання операція у «Фінансах», посилання «Сторінка «Фінанси»». Блок можна сховати («Що показувати»). - Нижче — «Чекають підтвердження» і «Останні дії», як у всіх ШІ. Коли Марію вимкнено, угорі — смуга «Марію вимкнено — крок не запускається» з кнопкою «Увімкнути в «Інтеграції → ШІ»». Коли вимкнено «Записувати у «Фінанси»», — смуга «Тестовий режим: у «Фінанси» Марія не пише» з кнопкою «Налаштування» (відкриває їх тут же, у вікні). На телефоні головна метрика — на всю ширину, решта карток по дві, «Запустити крок» — на всю ширину. ## 3. Налаштувати Марію під себе Тут Марію налаштовують під себе: її характер у чаті, період звітів, що видно у вікні, кому вона пише, і вся бухгалтерська робота — банки, «Вхідні», податки, капіталізація, прогноз. Кожне поле має рядок-підказку під собою; змінили — Марія бачить це з наступного кроку (до 20 секунд), без перезапуску. Дорога: вікно Марії → кружечок «Налаштування» праворуч угорі — налаштування відкриваються в тому самому вікні (адреса `/crm/ai/maria?view=settings`), меню лишається в рейці; повернутися — той самий кружечок «Назад до роботи» або «назад» браузера. Так само веде рядок «Марія Йосипівна» в «Налаштування → Команда → ШІ-співробітники». Вкладки: «Налаштування» · «API» · «Огляд» · «Журнал». Угорі форми — «Для всіх» (діє для всієї організації, змінює адміністратор або той, хто підключив Марію) і «Для мене» (лише для вас: доповнення до інструкції, тон, звертання, вигляд вікна). «Скинути до типових» — на кожну групу. Типові значення — те, як Марія працювала до появи поля. ### Характер Якою Марія є в розмові: її чат у месенджері Helomi і віконце на сторінці «Фінанси» читають ці поля разом із вбудованими правилами (категорії, гаманці, «так/ні»); MCP і файл сесії — теж. | Налаштування | Що означає | Типово | | --- | --- | --- | | Інструкція для ШІ (персона, промпт) | Що ШІ читає першим у чаті, MCP і файлі сесії. Змінений текст Марія дописує до своєї персони в чаті як «Інструкцію організації» | інструкція шаблону (у чат не дописується) | | Моє доповнення до інструкції | Лише для вас («Для мене»): «пиши мені коротко», «звертайся Олександре» | порожньо | | Тон | Діловий чи дружній («Для мене») | як в інструкції — сувора й точна | | Звертання | «Ви» чи «ти» («Для мене») | як в інструкції — на «ви» | | Мова відповідей | Українська чи англійська — у чаті Марії, MCP і файлі сесії | як в інструкції — українська | | Записувати у «Фінанси» (витрати з чату після «так», виписки банків); інакше — лише свій журнал (тестовий режим) | Вимкнено — тестовий режим: Марія все розпізнає й підтверджує, але пише лише у свій журнал | так | ### Звіти і «Що показувати» Період, за який Марія показує показники, і як виглядає її вікно. Період — спільний; вигляд вікна кожен налаштовує для себе («Для мене»). | Група | Налаштування | Що означає | Типово | | --- | --- | --- | --- | | Звіти | Типовий період звітів, днів | KPI у вікні, `ai_maria_summary` для інших ШІ й аналітика в чаті, коли період не названо («зведення», «по каналах»). Від 7 до 92 | 30 | | Звіти | Округлення сум у вікні | До гривні, до сотень або в тисячах («37,6 тис.»); цифри у «Фінансах» і звітах не змінюються | до гривні | | Звіти | Позначка валюти у вікні | «грн» чи «₴» після суми; суми Марії — у гривнях | грн | | Що показувати | Головна метрика (чорна картка) | «Маржа», «Прибуток» чи «Чистий прибуток» — перша чорна картка з періодом | Маржа | | Що показувати | Які показники у вікні | Відмічені картки стоять після головної: «Маржа», «Прибуток», «Чистий прибуток», «Витрати», «Записано з чату» | нічого не відмічено — усі | | Що показувати | Показувати блок «Гроші й банки» | Вимкнено — у вікні лише показники, цикл і журнал | так | ### Повідомлення Усе, що Марія пише людям у чат з нею: ранковий підсумок, нагадування про податки, табличку комісій ОЛХ. Не вибрали людей — пише всім адміністраторам, як і раніше; вибрали — лише їм (кожному в його чат з Марією). | Налаштування | Що означає | Типово | | --- | --- | --- | | Щоранку писати підсумок у чат з Марією: гроші, учора, «Вхідні», планові, тривоги | Раз на день: гроші бізнесу по гаманцях, учорашні надходження й витрати, «Вхідні», планові платежі, тривоги | так | | О котрій за Києвом (після цієї години на найближчому кроці) | Підсумок приходить на першому кроці після цієї години | 9 | | Ранковий підсумок — кому | Люди організації галочками | не вибрано — усім адміністраторам | | У підсумку: скільки рядків чекає у «Вхідних» | «Вхідні» — рядки виписок без категорії, які Марія не розібрала сама (так вона каже про витрати без категорії) | так | | У підсумку: планові витрати на скільки днів уперед | До шести найближчих планових платежів; 0 — без цього рядка | 7 (тиждень) | | У підсумку: тривоги за добу (збої інтеграцій, розбіжність звірки з банком) | Помилки банків і розбіжність залишку гаманця з банком за добу — з журналів інтеграцій | так | | Нагадування про податки — кому | Хто отримує нагадування про планові податки | не вибрано — усім адміністраторам | | Табличка комісій ОЛХ — кому | Хто отримує табличку з питанням «записати витратою?». Щоб людина могла відповісти «так», додайте її в «Хто може диктувати витрати» | не вибрано — адміністраторам | ### Робота Марії Бухгалтерські правила: як Марія записує витрати з чату, як часто ходить у банки, як розбирає «Вхідні», коли нагадує про податки й ОЛХ, як оцінює склад і будує прогноз. | Група | Налаштування | Що означає | Типово | | --- | --- | --- | --- | | Загальні | Гаманець за замовчуванням для витрат із чату | Частина назви гаманця, коли в чаті рахунок не названо | монобанк | | Загальні | Хто, крім адміністраторів, може диктувати витрати й питати звіти | id людей через кому | порожньо | | Загальні | Скільки хвилин чекати «так/ні» на запис | Після цього пропозиція згорає | 120 | | Цикл | Як часто робити крок, хв | Виписки банків, «Вхідні», нагадування, прогрів звітів | 30 | | Виписки банків | Заносити виписку й реєстри NovaPay у «Фінанси» | Кожен акаунт «Інтеграції → NovaPay» з ключами на кожному кроці; вимкнено — лише «Імпорт виписки» в акаунті | так | | Виписки банків | Заносити виписку Monobank у «Фінанси» | Потрібен токен «Інтеграції → monobank» | так | | Виписки банків | Рахунок Monobank | `fop` — рахунок ФОП у гривні; або id рахунку / кінець IBAN | fop | | Виписки банків | Заносити операції Monobank, не старші за дату | Межовий день: операції, що вже прийшли з KeepinCRM, не дублюються; раніші — не беруться | 2026-10-14 | | Виписки банків | Скільки останніх днів виписки перечитувати щоразу | Ліміт банку — 31 день за запит | 3 | | «Вхідні» | Розбирати «Вхідні» самій | Правила імпорту, історія контрагента, оплата угоди того ж клієнта; сумнівне — людині з підказкою | так | | «Вхідні» | Скільки разів контрагент має бути розібраний однаково; не проводити суми понад, ₴; історія за днів | Межі сміливості Марії | 3; 20 000; 180 | | План постійних витрат | Заводити планові постійні витрати за історією; скільки місяців поспіль | Повторювана витрата стає плановою щомісяця | так; 3 | | План постійних витрат | Оновлювати курси валют з НБУ раз на добу | Ручний курс наступного дня перезапишеться | так | | Податки | Нагадати за скільки днів до сплати; запасне «до числа місяця»; не раніше години | Нагадування в чат (кому — «Повідомлення») | 7,3,2,1; 19; 9 | | Комісії ОЛХ Доставки | Котрого числа табличка; не раніше години; адреса Helomi | Табличка місяця з запитом «записати витратою?» | 30; 10; адреса сервера | | Капіталізація | Середня ціна продажу — за скільки днів; перераховувати довідник раз на | Ціна товару на складі | 180; 14 | | Капіталізація | Товар без продажів: ціна = собівартість × | Для нових товарів | 2 | | Капіталізація | Не наш товар — артикули / слова в назві; винятки | Не входить у капіталізацію | O*, О*, А1–А8; армресл…; порожньо | | Капіталізація | Документи партії, поки не пораховані, % від доставки | Оцінка боргу за документи | 10 | | Прогноз і план | Темпи — за скільки днів; на скільки місяців; подушка %; місяців від оплати до полиці | Прогноз грошей і закупівель | 60; 6; 15; 2 | ### Доступи й ліміти Що Марія може робити від свого імені — блок унизу вкладки «Налаштування», змінює адміністратор: розділи (типово «Фінанси», «Дашборд фінансів», «Угоди», «Закупівлі»), «Спочатку запитати», ліміти. Докладно — стаття [ШІ-співробітники](ai-employees.md). ## 4. Керувати Марією з інших ШІ (API) Як Марією керують інші ШІ і як підключити її до свого чату: «Вхід для ШІ», токени, файл сесії. Вкладка «API» у налаштуваннях Марії. - **«Вхід для ШІ»** — картка `/api/ai/sections/ai-maria` (усі поля налаштувань з тими самими підказками), інструменти `ai_maria_*` з підписами «читає / змінює» і «питає людину», стаття `help("ai-maria")`, і хто з мозків має доступ — Ломі чи Остап з галочкою «ШІ Марія Йосипівна» в «Доступах і лімітах». - **«Токени · N»**, «Файл сесії», адреси MCP / REST / OpenAPI — як у всіх ШІ ([ШІ-співробітники](ai-employees.md), розділ «API»). ## 5. Звідки Марія бере цифри Марія рахує лише з вашої CRM — угод, «Фінансів», складу й «Закупівель»; нічого не тягне з KeepinCRM і нічого не вигадує. - **Угоди** — з розділу «Угоди» вашої CRM. Продаж = угода, створена в період (крім скасованих / програних); сума — сума товарів угоди; маржа — продаж мінус собівартість позицій. Угоди, перенесені з KeepinCRM, рахуються за датою створення (як і раніше), нові — за датою замовлення на площадці. Якщо в угоді позиція без закупівельної ціни (товар прийшов з площадки без зв'язку зі складом), Марія бере собівартість товару складу з тим самим артикулом або матеріалів позиції прайс-листа; не знайшла — угода позначається «без закупівельної ціни» і маржа там завищена. - **Повтори.** Якщо замовлення площадки потрапило в CRM двічі (з KeepinCRM і повторним імпортом), Марія рахує його один раз — угоду з KeepinCRM. - **Гроші** — з «Фінанси → Операції»: надходження й витрати по гаманцях і категоріях; перекази між гаманцями — не дохід і не витрата. - **Класи витрат** — клас категорії «Фінансів» («Налаштування → Фінанси → Категорії фінансів», колонка «Клас»): «Закупівля товару» вже в собівартості й від маржі не віднімається; «Документи й доставка партії» і «Зарплата й премії» — окремо від «інших»; «Комісії майданчиків» і «Доставка клієнтам» з 19.10 — окремими рядками (як у P&L «Фінансів»; суми збігаються), у прибутку вони як і раніше; внески, виведення й позики власника не впливають на прибуток; «Постійна» — для прогнозу. - **Фірми («Бізнеси»)** — бренди «Налаштування → Команда → Бренди та юрособи», до яких прив'язано кореневі папки складу; назва — бренду. Бренд з прапорцем «Не рахувати у звітах» (не наша фірма) у «Бізнесах» не показується. - **Склад** — «Склад → Товари»: залишок і закупівельна ціна; фірма товару — коренева папка складу. - **Дорога** — «Закупівлі»: партії «Замовлено» і «В дорозі». ## 6. Продиктувати витрату чи надходження в чаті Продиктуйте Марії витрату чи надходження в її чаті — вона запише операцію у «Фінанси» лише після вашого «так». 1. Напишіть Марії в чаті Helomi: «пром 2000», «реклама олх 1500», «оренда 5000 з моно», «готівкою прийшло 1200». 2. Перевірте пропозицію: категорія «Фінансів», гаманець, сума, дата. 3. Відповідайте «так» — операція з'являється у «Фінансах» (джерело «ШІ Марія (з чату)», автор — «ШІ Марія Йосипівна»), баланс гаманця змінюється одразу; «ні» — нічого не записується. Повторне «так» на ту саму пропозицію другої операції не створить. Витрата «Податки» підтверджує плановий податок юрособи гаманця (та сама сума, сума всіх податків найближчого дня сплати або єдиний плановий поряд) — нагадування по ньому зникає; не збіглося — Марія запише витрату й попросить підтвердити планову в «Фінанси → Планові». «Оплатив податки» без суми — тиша до кінця місяця. Команда «статус» показує режим запису, мозок і стан банків. Як Марія говорить (тон, звертання, мова, ваші побажання) — «Налаштування → Характер». ## 7. Як Марія заносить виписки банків у «Фінанси» Марія сама заносить виписки підключених банків у «Фінанси» на кожному кроці — без дублів і з категоріями. - **Monobank** — додайте особистий токен у «Інтеграції → monobank → Підключення». Марія на кожному кроці бере виписку рахунку ФОП за останні дні й заносить операції в гаманець «Монобанк» з категоріями; операція з тим самим id банку двічі не з'явиться, холди пропускаються. Платежі до дати «Заносити операції Monobank, не старші за дату» Марія не бере, а на сам цей день пропускає ті, що вже прийшли з KeepinCRM. - **НоваПей** — кожен увімкнений акаунт «Інтеграції → NovaPay» з ключами: виписка за вікном акаунта через його «Автоматичні платежі» (угода за ТТН чи номером, категорії, «Вхідні») і реєстри накладених платежів за вчора після 9:00. Вимикач — «Виписки банків → Заносити виписку й реєстри NovaPay у «Фінанси»». Стаття [NovaPay](int-novapay.md). - Без токена Марія чесно показує «не підключено» у вікні, а надходження з банку у звітах з'являться після підключення. - Обидві виписки йдуть спільним шляхом «Фінансів»: правила імпорту («Налаштування → Фінанси → Правила імпорту»), виплата майданчика — переказом з транзитного гаманця, рядок без правила — у «Вхідні» («Фінанси → Звірка») з категорією-підказкою; НоваПей з номером ТТН в описі — дохід по несплаченій угоді. - **Комісії майданчиків у «Бізнесах»** — з правила каналу «Фінанси → Звірка → канал»; без нього — ті самі заготовки (Prom і Rozetka — сума з поля угоди, Епіцентр 17 %, Kasta 25 %, ОЛХ Доставка 20 грн + 3 %). - **По бізнесах (P&L)** — фінансовий звіт Марії закінчується блоком «По бізнесах»: виручка, валовий і чистий прибуток кожного бізнесу з P&L «Фінансів»; дашборд директора отримує той самий P&L за 14 днів. - **Борги по партіях і «товар у дорозі»** — з оплат закупівель у журналі «Фінансів» плюс архів оплат до переходу; ті самі суми бачать «Фінанси → Закупівлі» і Свєта. - **Табличка комісій ОЛХ** — коли правило каналу ОЛХ увімкнено, комісія від ШІ Едуарда одразу стає витратою по угоді, рядок таблички позначається проведеним і в місячний запит «записати витратою?» не потрапляє. - **«Вхідні»** — рядки виписок, що чекають перевірки, Марія розбирає сама на кожному кроці: спочатку правила імпорту, далі історія контрагента (три й більше однаково розібраних операцій — проводить, менше — лише підказка), далі платіж покупця на суму несплаченої угоди того ж клієнта — оплата по угоді. Сумнівне лишається у «Вхідних» з підказкою «Марія: …»; суми понад межу, внески й позики — теж лише підказка. Вимикач і межі — група «Вхідні» в налаштуваннях. ## 8. Що Марія робить на кожному кроці Крок — один прохід роботи Марії: кожні «Як часто робити крок» хвилин або одразу після «Запустити крок» у вікні; підсумок кожного кроку — у «Журналі». 1. Виписка НоваПей → «Фінанси» (якщо підключено й увімкнено). 2. Виписка Monobank → «Фінанси» (якщо є токен і увімкнено). 3. «Вхідні»: правила імпорту, історія контрагента, оплата угоди того ж клієнта — впевнене проводить, решта з підказкою. 4. Раз на добу — план постійних витрат: витрата класів «постійні» чи «зарплата», що повторюється три й більше місяців зі стабільною сумою, стає плановою «щомісяця» у «Планових»; рядок виписки на ту ж суму ±3 % і ±10 днів підтверджує її сам. 5. Раз на добу — курси валют з НБУ для USD, EUR і валют гаманців («Налаштування → Валюти і курс»). 6. Щоранку після години з «Повідомлень» — ранковий підсумок у чат з Марією тим, кого вибрано (не вибрано — адміністраторам), з тими рядками, що відмічені. 7. Прогрів звітів: фінблок дашборду (14 днів), аналітика за 30 днів, за «Темпи — за скільки днів» і за період «Звітів», капіталізація, план по місяцях — щоб сторінки й вікно відкривались миттєво. 8. Податкові нагадування (з планових податків CRM, раз на день) і табличка комісій ОЛХ (у свій день) — кому, задає «Повідомлення»; щоденні знімки капіталізації й залишків. ## Можливі помилки | Як показується | Чому | Що зробити | | --- | --- | --- | | У чаті: «Тестовий режим: у «Фінанси» НЕ записую»; у вікні смуга «Тестовий режим» | Вимкнено «Записувати у «Фінанси»» | Увімкнути: налаштування → «Характер» | | «Не змогла записати у «Фінанси»: категорія … — дохід, а операція — витрата» | Обрана категорія іншого напрямку | Назвати іншу категорію або завести потрібну у «Фінанси → Категорії» | | «Надходження» за останні дні малі або нуль | Банк не підключено — платежі з банку не потрапляють у «Фінанси» | Додати токен «Інтеграції → monobank» / налаштувати НоваПей | | «В N угод(ах) немає закупівельної ціни» | У позиції нема собівартості, а товару з таким артикулом на складі / в прайс-листі не знайдено | Прив'язати позицію до товару складу або заповнити закупівельну ціну | | У «Журналі» `mono_error` | Monobank відповів помилкою або ліміт «1 запит на хвилину» | Наступний крок спробує знову; перевірити токен | | Ранковий підсумок не прийшов | Вимкнено «Щоранку писати підсумок» або ви не серед «Ранковий підсумок — кому» | Перевірити групу «Повідомлення» | | Після зміни «Типовий період звітів» вікно ще показує 30 днів | Новий період ще не пораховано, а розрахунок не вдався | «Запустити крок» — крок порахує новий період | | Повідомлення «Крок уже виконується» | Попередній крок ще йде | Дочекатися кінця кроку (хвилина-дві) | | Інструмент ai_maria_* → 403 «ШІ вимкнено» | Марію вимкнули | Увімкнути в «Інтеграції → ШІ» | ## Для ШІ-співробітників Ключ розділу в каталозі — `ai-maria` (`describe_section("ai-maria")`, `GET /api/ai/sections/ai-maria`): у картці всі поля налаштувань із підказками й прикладами. Доступ — галочка «ШІ Марія Йосипівна (бухгалтерія: стан, крок, налаштування)» у «Доступах і лімітах» співробітника (Ломі має її типово). Цифри й звіти — розділ `maria` (доступ «Фінанси»). - `ai_maria_status` — стан, налаштування зі схеми, останній крок. - `ai_maria_summary` — продажі, маржа, прибуток, чистий прибуток, угоди, витрати за період «Звітів» (`report_days`); записи з чату; банки; `view` — що показує вікно. - `ai_maria_expenses` — журнал витрат, продиктованих у чаті (status = posted | pending_confirm | rejected | error). - `ai_maria_run_step` — крок зараз. - `ai_maria_settings_save` — змінити налаштування (ті самі перевірки, що в людини): наприклад `values={report_days: 14}`, `values={digest_to: [12], digest_hour: 8}`; `ai_maria_enabled` — увімкнути/вимкнути. Обидві — через кошик підтверджень «Керування іншими ШІ». - `maria_ask` — спитати про показник; `maria_report` (start, end, kind = finance | products), `maria_analytics` (days або start..end), `maria_forecast` (months) — звіти. Не вигадуйте суми — беріть їх з відповідей інструментів; гроші у «Фінанси» записуйте лише після явного «так» людини; id людей для «кому» — з `GET /api/crm/deals/refs` (responsibles → local_user_id). ## Додаткова інформація Пов'язане: [Фінанси](finance.md), [Угоди](deals.md), [Склад і товари](products.md), [Monobank](int-monobank.md), [NovaPay](int-novapay.md), [ШІ Ростік](ai-rostik.md), [ШІ Віктор](ai-viktor.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md). --- # ШІ Свєта — бухгалтерія бізнесу з партнерами: капітал, гроші бізнесу, виплати Свєта — ШІ-бухгалтерка одного бізнесу, у якому є партнери (у Helomi — «Перший шар» Саші й Романа). Вона показує, скільки грошей у бізнесі, який прибуток за місяць, скільки кожен партнер вклав і вивів, який у нього капітал і скільки йому до виплати; рахує виплату за період і готує чернетку, яку затверджує й проводить людина. Усі цифри — зі звітів вашої CRM («Фінанси → Партнери», P&L бізнесу), налаштування — у її пульті, керувати нею можуть люди й інші ШІ (Ломі). ## Можливості - «До виплати партнерам», гроші бізнесу (рахунки й каса бізнесу), прибуток місяця з P&L бізнесу, капітал — на одному екрані. - Капітал кожного партнера: внесено (у тому числі витрати з його кишені на бізнес), виведено, частка прибутку, капітал, до виплати. - Розрахунок виплати за період з угод бізнесу (сума − собівартість − комісія, частки партнерів і товарів) і чернетка виплати. - Дані лише з CRM: частки партнерів — у бренді («Партнери бізнесу»), частки товарів — у картці товару («Партнери»). ## 1. Налаштування Свєта з'являється в «Інтеграції → ШІ» як картка «Свєта» (вид «Агент») і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» веде в її вікно; кружечок «Налаштування» праворуч угорі вікна — її налаштування, вкладка «Налаштування»: | поле | що означає | типово | | --- | --- | --- | | Готувати виплати-чернетки за дорученням інших ШІ | без галочки Свєта лише показує звіти; чернетку може створити людина | так | | Бізнес, який веде Свєта | бренд із партнерами | бренд «Перший шар» (за назвою) | | Рахунок бізнесу | гаманець для виплат партнерам і внесків | — | | За який період типово рахувати виплату | поточний або минулий місяць | минулий місяць | Партнерів і частки задаєте в «Налаштування → Бренди та юрособи → Бренди → бренд → Партнери бізнесу» (стаття «Бренди і юрособи», розділ 8). ## 2. Увімкнути або вимкнути Свєту Перемикач на плитці «Свєта» в «Інтеграції → ШІ» або «⋯» у шапці пульта. Вимкнена Свєта не готує виплат (і для інших ШІ теж), її інструменти керування — лише через підтвердження людини; звіти в пульті лишаються видимими. ## 3. Звідки Свєта бере цифри - **Капітал і гроші бізнесу** — звіт «Капітал» («Фінанси → Партнери» або «Звіти → Капітал»): внески («Внесок партнера», витрати з особистої кишені партнера на бізнес), виведення й виплати, частка прибутку за частками партнерів. - **Прибуток місяця** — «Звіти → P&L по бізнесах», колонка бізнесу. - **Виплата** — розрахунок «Фінанси → Партнери → Виплати»: угоди бізнесу за період, сума − собівартість − комісія з журналу, частка партнера (на товарі — своя, якщо задано), «повертати собівартість». Свєта нічого не рахує вдруге — показує ті самі звіти, що й сторінка «Фінанси». ## 4. Пульт: огляд, капітал, виплати Вкладка «Огляд»: KPI («До виплати партнерам» — головна, «Гроші бізнесу», «Прибуток місяця», «Капітал», «Виплати»), таблиця «Капітал партнерів», блок «Виплати» (партнер, період → «Розрахувати» → «Створити чернетку»; відкрита виплата — «Затвердити», «Виплатити» з гаманцем і датою, XLSX). Це вікно `/crm/ai/sveta` («Відкрити» на картці); налаштування — кружечок «Налаштування»: вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API», «Огляд», «Журнал». ## 5. Перенесення старої Свєти Стара Свєта (сторінки «Перший шар» `/sveta`, власні таблиці внесків, витрат, ручних угод, виплат) працює, доки власник не підтвердить перенесення — це міграція даних, її вирішує власник. Перенесення: 1. партнери Саша й Роман у бренді, частки товарів з довідника собівартостей («ручки» — Роман 66 % з поверненням собівартості); гаманці «Особисті кошти — Роман/Саша», з яких платила стара Свєта, стають кишенями партнерів (витрати з них — внески); 2. внески й виведення → операції «Внесок партнера» / «Виплата партнеру» з рахунку бізнесу; 3. проведені витрати → операції бізнесу (з кишені партнера, якщо платив він); уже записані в журнал — доповнюються бізнесом; 4. комісії угод до дати переходу — зі старого розрахунку (формула майданчика або виправлена рукою) → комісія по угоді, лише де в журналі її ще нема (без подвоєння з комісією каналу); угоди після дати переходу — за правилами каналів («Фінанси → Звірка»); 5. ручні угоди — лише в звіті (створення угод — окремим рішенням); 6. виплати → «Виплати» зі знімком (правка назви чи корекцій суму не обнуляє); сплачені — проведені з датою сплати; 7. звірка зі старою Свєтою за місяць (≤ 1 грн). Спершу — пробний прогін: звіт, нічого не зберігається. Після застосування стара Свєта стає лише для читання (запис → «перенесено в CRM»), повтор нічого не дублює. У пульті — посилання «Стара Свєта» на сторінки «Першого шару». ## Можливі помилки | Як показується | Чому | Що зробити | | --- | --- | --- | | «Оберіть бізнес у налаштуваннях Свєти…» | Бренду «Перший шар» нема і бізнес не обрано | «Налаштування» пульта → «Бізнес» | | «Свєту вимкнено — увімкніть в «Інтеграції → ШІ»» (409) | Чернетку виплати просили у вимкненої Свєти | Увімкнути перемикачем | | «У Свєти вимкнено «Готувати виплати-чернетки…»» (409) | ШІ просить чернетку, а галочку знято | Увімкнути в «Налаштуваннях» або створити чернетку самому | | «партнер … не з бізнесу цього товару» | Частку ставлять товару з папки іншого бізнесу | Перевірити папку товару | | Запис на сторінці «Першого шару» → «перенесено в CRM» (409) | Перенесення вже застосовано | Вносити у «Фінанси» (бізнес «Перший шар»), капітал і виплати — «Фінанси → Партнери» | | Пробний прогін: «рахунок бізнесу не задано» | Не обрано «Рахунок бізнесу» | «Налаштування» пульта → «Рахунок бізнесу» | ## Для ШІ-співробітників Ключ розділу в каталозі — `ai-sveta` (`GET /api/ai/sections/ai-sveta`); доступ — галочка «ШІ Свєта (бухгалтерія бізнесу: партнери, капітал, виплати)» у «Доступах» (Ломі має її типово). Звіти й виплати бізнесу — також розділ `finance` (`finance_capital`, `finance_payout_calc`, `finance_payouts`, `finance_payout_pay`). - `ai_sveta_status` — стан, бізнес, налаштування. - `ai_sveta_summary` — огляд: P&L місяця бізнесу, гроші й капітал, партнери з «до виплати», виплати за станами. - `ai_sveta_payout_calc` (from, to, partner_id) — розрахунок, нічого не пише. - `ai_sveta_payout_create` (values: partner_id, from, to, label, adjustments) — чернетка виплати через кошик «Платежі»; гроші не рухає. - `ai_sveta_settings_save`, `ai_sveta_enabled` — через кошик «Керування іншими ШІ». Не вигадуйте суми й частки — беріть з відповідей інструментів; частки партнерів і бізнес змінює людина. ## Додаткова інформація Пов'язане: [Фінанси](finance.md) (розділ 7в «Партнери, капітал, виплати»), [Бренди і юрособи](settings-brands.md), [ШІ Марія Йосипівна](ai-maria.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md). --- # ШІ Кіт — гра складу з котом Кіктором «ШІ Кіт» — вкладка «Склад → ШІ Кіт», гра для збирачів: за кожну зібрану посилку й перевірку наявності ви отримуєте бали, а на них годуєте й вбираєте свого кота Кіктора, чорного кота-короля складу. Кіт живий: моргає, позіхає, стежить за курсором, муркоче, коли його гладять, і вміє говорити, бо розмову за нього веде ШІ Ломі. У «Структурі» він стоїть окремим типом «ШІ Тварина». ## Можливості - Свій кіт у кожного збирача: ім'я, рівень, ситість, ласка, «разом», бали, серія днів і комбо. - Бали за роботу: посилка Нової Пошти, посилка іншої служби, перевірка наявності (кількість балів налаштовується). - Магазин на 230 речей: їжа, шапки, окуляри, нашийники, іграшки й обстановка, половина — український колорит і меми (сало, борщ, пачка солі, паляниця, кучма, вишиванка, гривня, Пес Патрон, марка «Корабель… Все!», бойовий гусак, трактор, бавовна); усе куплене лишається в «Колекції». - Кілька речей обстановки одночасно: стіна, підлога, біля трону, під стелею, полиця й килимок — кожна річ на своєму місці. - Розмова з котом текстом і голосом: відповідає ШІ Ломі від імені кота, з її доступами, і знає Helomi так само. - Щоденні квести, понад сто досягнень і рейтинг збирачів. - Родове дерево: покоління рядами, у центрі ваш кіт у своєму вбранні; натиск на кота — його історії (у кожного родича дві-три) і серіал «Корона під скотчем». - Картка «ШІ Кіт» у «Структурі» з фото й описом, тип «ШІ Тварина». - Кіктор на сторінці збірки: ходить, радіє кожній позиції, хвалить, танцює на комбо, говорить понад сотнею фраз і розповідає серіал «Корона під скотчем». ## 1. Налаштування Гра належить ШІ Віктору, тому все налаштовується в його пульті: «Інтеграції (головне меню) → ШІ → Віктор → Налаштування → ШІ Кіт». Змінили — діє з наступного відкриття вкладки, без перезапуску. | Налаштування | Що означає | Типово | | --- | --- | --- | | Балів за посилку Нової Пошти / іншої служби / перевірку наявності | Скільки балів дає кожна дія | 1 / 2 / 1 | | Ситість, ласка, «разом» падають за годину на | Як швидко кіт сумує без уваги | 2 / 1,5 / 1 | | Днів без їжі, після яких кіт помирає | Скільки кіт витримує голодним | 5 | | Кіт розмовляє | Вимкнено — кіт лише муркоче, поле розмови сіре | так | | Голос кота | Голос Gemini / Chirp 3 HD для відповідей уголос; без ключа Google — голос браузера | Algieba | | Як звучить кіт | Одне речення про манеру мовлення для голосу Gemini | хитрий кіт-король, неквапно, муркотливо | | Історія кота | Що кіт розповідає про себе; порожньо — типова історія Кіктора | порожньо | | Кіт на збірці | Кіктор у правому нижньому куті сторінки збірки; вимкнено — кота там нема | так | | Кіт розповідає серіал на збірці | Після кожного зібраного замовлення — наступна серія «Корони під скотчем» | так | | Як часто кіт говорить сам, с | У простої кіт раз на стільки секунд може пройтись і щось сказати (15–900) | 45 | | Свої фрази кота на збірці | Кожен рядок — фраза; кіт каже їх разом зі своїми, коли хвалить і коли нудьгує; можна `{name}` і `{today}` | порожньо | | Скільки речей обстановки можна поставити | Скільки речей обстановки стоїть біля кота одночасно (1–16); місць на сцені однаково не більше, ніж у кожного виду | 10 | | Звуки гри | Кіт муркоче, коли його гладять, мяукає, монетки дзенькають, фанфари за досягнення — на сторінці кота й на збірці; вимкнено — гра мовчить для всіх | так | | Гучність звуків гри, % | Наскільки голосно звучить гра: 5 — ледь чутно, 100 — на весь склад | 60 | Вкладку бачать ті, у кого є доступ до розділу «Склад». Пряма адреса — `/crm/kiktor`. ## 2. Як заробити бали Бали нараховуються самі, коли ви натискаєте «Зібрано» на сторінці «Склад» або записуєте підрахунок у запиті «перерахуйте». Посилка Нової Пошти дає 1 бал, будь-якої іншої служби — 2, перевірка наявності — 1. Працюєте щодня — росте серія: з 3-го дня +10 % балів, з 7-го +20 %, з 14-го +30 %, з 30-го +50 %; пропустили день — серія з нуля. Збираєте без пауз довших за 10 хвилин — росте комбо: з ×3 бали множаться на 1,5, з ×5 — на 2, з ×10 — на 3. Бали, серію й комбо видно поруч з ім'ям кота, а статистику дня — у смузі під сценою. ## 3. Догляд за котом Кіт має три шкали: «Ситість» (падає з часом, піднімається їжею з «Магазину»), «Ласка» (росте, коли ви торкаєтесь кота на сцені) і «Разом» (капає, поки ви збираєте замовлення). Настрій кота залежить від шкал: ситий і поглажений — щасливий, голодний — облизується й натякає погодувати. Через 5 діб без їжі кіт помирає; тоді з'являється кнопка «Завести нового кота»: бали, досягнення й речі лишаються, серія днів обнуляється. Ім'я кота змінюється натисканням на ім'я. ### Звуки гри Гра звучить, як справжня: кіт муркоче, коли його гладять, мяукає, дзенькають монетки й лунають фанфари. Звук з'являється після першого натиску на сторінці — так працюють усі браузери. Щоб кіт муркотів: 1. Торкніться кота на сцені — він замуркоче на кілька секунд. 2. Проведіть по коту, не відпускаючи кнопку миші чи пальця, — муркотіння триває, поки гладите. Що ще звучить: покупка — монетка, їжа — хрумкання й задоволене «мяу», вдягнути чи поставити річ — «поп», нове досягнення — дзвіночки, новий рівень — фанфари, виконаний квест — дзвін, новий кіт — чарівний перелив. Голодний кіт після погладжування жалібно мяукає, сонний спершу хропе. На збірці: нове замовлення — «мрр», кожна позиція — короткий звук, що вищає до кінця замовлення, усе відмічено — дзвіночок, «Зібрано» — монетка і стрибок, комбо — переливи, повернули менеджеру — сумне «мяу». Кнопка з дзвіночком біля поля розмови вмикає й вимикає звуки гри на цьому пристрої. Для всіх звуки вимикаються в «Інтеграції → ШІ → Віктор → Налаштування → ШІ Кіт → Звуки гри», там само — «Гучність звуків гри». На телефоні сцена зверху, шкали під нею, вкладки гри прокручуються вбік. ## 4. Розмова з котом Під сценою — поле «Напиши коту»: питайте про посилки, склад, угоди, Helomi або про родину кота. Відповідає ШІ Ломі від імені кота: та сама модель, інструменти, доступи, ліміти й кошик підтверджень, лише говорить котом, коротко й з хитринкою. Кнопка з мікрофоном — сказати голосом, кнопка з динаміком — чи відповідає кіт уголос (пам'ятається на цьому пристрої). Розмова з котом окрема від чату Ломі: її видно у вкладці «Кіт → Розмова з котом», «Очистити розмову» видаляє лише її. Якщо Ломі не підключено (нема ключа ШІ або її вимкнено), кіт відповідає, що зараз мовчить, і пояснює чому. ## 5. Магазин і колекція «Магазин» має шість полиць: «Їжа», «Шапки», «Окуляри», «Нашийники», «Іграшки», «Обстановка» — разом 230 речей, половина з українським колоритом і мемами: сало з часником, борщ, паляниця, пачка солі, вареники, кавун; козацька шапка, чуб-оселедець, каструля-шолом, окуляри «Добрий вечір», шолом пілота «Мрії»; комір вишиванки, коралі, гривня на шнурку, орден «Хоробрий кіт»; Пес Патрон, гусак-розвідник, писанка, бандура, марка «Корабель… Все!»; тризуб на стіні, вишиванка в рамці, петриківка, трактор, генератор, бавовна у вазоні. Їжа одразу піднімає ситість і ласку, решта купується один раз і з'являється в «Колекції». Шапка, окуляри й нашийник — на кота, іграшка — біля лап; одна шапка, одні окуляри, один нашийник і одна іграшка водночас, окуляри носяться разом із шапкою. Купівлі списують бали; не вистачає — кнопка сіра. **Окуляри** — 30 українських: синьо-жовті, з тризубом, вишиванкові, соняшникові, калинові, авіатори Привида Києва, «Бавовна», бойового гусака, тракторних військ, Пса Патрона, писанкові, гривневі, сальні, козака Мамая, петриківські, маска «Буковель», кіно Довженка, «Відбудова», прилад нічного бачення ЗСУ, зірки Євробачення, монокль тата Барона, серця для Зефірки, «Львівська кава», «Київські каштани», «Карпати», «Одеса-мама», «ТТН», склеєні скотчем, «Блекаут» з ліхтариками й бабусині для читання. **Обстановки може бути кілька.** Кожна річ має своє місце на сцені: стіна (5 місць; широкі картини — вишиванка, петриківка, неонова вивіска — лише ліворуч, до двох), підлога (5 місць; трактор, навантажувач і лавка займають по два), біля трону (2), під стелею (2), полиця (1) і килимок (1). «Поставити» додає річ поруч з уже поставленими, «Прибрати» знімає лише її. Над полицею «Обстановка» видно «Поставлено N з M» і скільки місць зайнято за видами; місця нема — кіт підкаже, що зняти. Скільки речей можна поставити разом, задає «Скільки речей обстановки можна поставити» в налаштуваннях (типово 10). ## 6. Квести, досягнення й рейтинг «Квести» — три завдання на день (наприклад, «зібрати 10 посилок»), за виконане бали нараховуються одразу, нові квести — опівночі. «Досягнення» — понад сто за зібране, серії, комбо, рівні, колекцію й догляд за котом; за кожне — бонусні бали. «Рейтинг» — збирачі за балами, з рівнем і рекордом дня. Кожні 100 очок досвіду — новий рівень; досвід дають збірки, перевірки й квести. ## 7. Історія й родина Вкладка «Родина» — родове дерево кота з історіями кожного родича і серіалом «Корона під скотчем». У центрі дерева — ваш кіт у своєму вбранні, довкола — мама, тато, бабуся, сестра, брат, кохана й кошенята, окремо — миша Шуршик, вічний суперник. Дерево йде поколіннями: «Старші» (бабуся Маркіза), «Батьки» (мама Мурка й тато Барон), «Кіктор і рідні» (сестра Ласка, брат Пухлик, кохана Зефірка й ваш кіт), «Діти» (кошенята Скотч, Пупирка й Наліпка) і «Поза родиною» (Шуршик). На телефоні пара короля стоїть першим рядком, решта — під нею. Щоб прочитати історії родича: 1. Відкрийте «ШІ Кіт → Родина». 2. Натисніть на кота в дереві — сторінка сама прокрутиться до його картки. 3. Прочитайте, хто він, і його історії: у кожного родича дві-три, наприклад «Посилка, що муркотіла» в мами Мурки чи «Листи без жодної коми» в тата Барона. Ваш кіт обраний одразу — під ним «Історії Кіктора»: хто він, звідки ім'я, як став королем складу, його секрет і характер. Свою історію кота можна вписати в «Інтеграції → ШІ → Віктор → Налаштування → ШІ Кіт → Історія кота». Під карткою — серіал «Корона під скотчем», який кіт розповідає на збірці по серії після кожного зібраного замовлення. Тут видно серії, які вже прозвучали на цьому пристрої, і номер наступної; «Прочитати всі 30 серій» показує весь сезон. Кіт знає історії родини й розповідає їх у розмові. ## 8. ШІ Кіт у «Структурі» У «Структурі» кіт — картка «ШІ Кіт» з фото Кіктора у відділі «Склад», керівник — ШІ Віктор. Тип картки «ШІ Тварина» стоїть поруч із «ШІ Програма» й «ШІ Агент»: кіт не робить кроків циклу й не має свого пульта, він говорить через Ломі. «Відкрити» в картці веде у вкладку гри. Тип і опис можна змінити в картці, як у будь-якого ШІ. ## 9. Кіт на збірці На сторінці збірки («Склад → Зміна → Взяти») у правому нижньому куті живе Кіктор, той самий, що в грі, у вашому вбранні. Він не сидить на місці: ходить уздовж краю, стежить очима за курсором, моргає й позіхає, на кожну відмічену позицію підстрибує, від «Зібрано» стрибає, на комбо танцює, сумує, коли замовлення повертають менеджеру, а в простої (3 хвилини без дій) засинає й прокидається від роботи. Торкніться кота — муркоче (і чутно, якщо «Звуки гри» ввімкнено) й тулиться, ласка зараховується, як у грі. Кіт говорить бульбашкою над собою: вітається на початку зміни, коментує нове замовлення, хвалить за позиції й «Зібрано» (з балами й комбо гри), підказує натиснути «Зібрано», коли все відмічено, підбадьорює, коли замовлення відкладають у кінець черги чи повертають менеджеру, жартує про склад і свою родину в простої, а зранку, в обід і ввечері — про час дня. Усього понад сто фраз. Після кожного зібраного замовлення — наступна серія історії «Корона під скотчем»: миша Шуршик поцупила корону, і вся родина допомагає її знайти (30 серій, далі історія починається знову; на якій серії ви зупинились, пам'ятає браузер). Кота на збірці вимикають і налаштовують у пульті Віктора, група «ШІ Кіт» (див. [налаштування](#1-налаштування)). На телефоні кіт менший і стоїть над нижньою панеллю збірки. Якщо в системі ввімкнено зменшення руху, кіт не ходить і не стрибає, лише моргає. ## Можливі помилки | Як показується | Чому | Що зробити | | --- | --- | --- | | «Кіт зараз мовчить» у полі розмови | Розмову вимкнено в налаштуваннях Віктора | «Віктор → Налаштування → ШІ Кіт → Кіт розмовляє» | | «Мяу. Говорити мене навчила Ломі, а вона зараз мовчить: …» | Ломі вимкнено або нема ключа ШІ | Увімкнути Ломі; додати ключ моделі в «Інтеграції → ШІ» | | Кнопка «Купити» сіра, підказка «Не вистачає N балів» | На купівлю не вистачає балів | Зібрати ще посилки або виконати квест | | Кнопка «Завести нового кота» замість поля | Кіт помер від голоду | Завести нового; речі й бали лишаються | | Бали не нарахувались за посилку | «Зібрано» натиснув інший збирач | Бали йдуть тому, хто натиснув «Зібрано» на сторінці «Склад» | | «На підлозі вже нема місця — зніміть щось…» (так само «На стіні», «Біля трону», «Під стелею», «Полиця», «Килимок») | Усі місця цього виду зайняті; трактор, навантажувач і лавка займають по два | «Прибрати» одну річ того ж виду й поставити нову | | «Широкі речі вміщаються лише дві…» | Уже висять дві широкі картини (вишиванка, петриківка, неонова вивіска) | Прибрати одну з них | | «Більше N речей обстановки не вміщається…» | Досягнуто ліміту з налаштувань | Прибрати річ або збільшити «Скільки речей обстановки можна поставити» | ## Для ШІ-співробітників Окремих інструментів у кота нема: гра — дані Віктора (`/api/viktor/cat*`), а говорить кіт через Ломі (`/api/olya/chat` з `persona=kiktor`). Ломі від імені кота користується своїми інструментами й доступами, нічого нового кіт не дозволяє. Про гру розповідайте за цією статтею (`help("kiktor")`); бали не обіцяйте й не нараховуйте, їх дають лише збірки й перевірки. Налаштування гри — через `ai_viktor_settings_save` з ключами групи «ШІ Кіт» (`cat_points_np`, `cat_talk`, `cat_voice`, `cat_story`, `cat_buddy`, `cat_buddy_every`, `cat_buddy_phrases`, `cat_decor_max`, `cat_sfx`, `cat_sfx_volume`…); стан кота на збірці (`buddy`) віддає той самий `/api/viktor/cat`, за тими ж правилами підтвердження, що й решта налаштувань Віктора. ## Додаткова інформація Пов'язане: [ШІ Віктор](ai-viktor.md), [Ломі](kamila.md), [Структура](structure.md), [Склад і товари](products.md).