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

1Де шукати ШІ

• Інтеграції›ШІ«Інтеграції → ШІ» — картка кожного ШІ організації, шаблони каталогу, яких ще нема, і картка «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM». Нижче — «Ключі моделей» (Anthropic, OpenAI, Kimi, Gemini).
• Налаштування›Команда›ШІ-співробітники«Налаштування → Команда → ШІ-співробітники» — той самий перелік рядками; клік по рядку відкриває налаштування ШІ: у ШІ з вікном — у його вікні, у Ломі й Остапа — тут же.
• «Структура компанії» — картка ШІ у своєму відділі; «Відкрити» веде у вікно ШІ.

Ключ моделі потрібен лише тоді, коли модель викликає сам Helomi (Ломі, чат з агентом): Інтеграції›ШІ›Anthropic (Claude)«Інтеграції → ШІ → 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/<id> (рядок у Налаштування›Команда›ШІ-співробітники«Налаштування → Команда → ШІ-співробітники»). Її шапка — та сама, що у вікна, плюс кружечки «Відкрити вікно», «Чат з агентом», «Журнал», «?», «Згорнути» і той самий «⋮». Стара адреса /crm/settings/ai-employees/<id> ШІ з вікном сама веде у вікно з налаштуваннями — місце налаштувань одне.

Вкладки — саме в такому порядку: Налаштування · API · Огляд · Журнал; вкладка — у адресі (tab=…), тож оновлена сторінка відкривається на ній же. Старі адреси ?tab=access і ?tab=connect відкривають «Налаштування» (одразу на «Доступах і лімітах») і «API». На телефоні вкладки гортаються вбік, поля — в один стовпець.

Форма будується з налаштувань шаблону групами. Угорі перемикач «Для всіх» (діють для всієї організації) і «Для мене» (лише для вас; спільні поля показано сірим з підписом «спільне»). «Скинути до типових» — на групу. Внизу — «Скасувати» і «Зберегти».

Характер

Перша група в кожного ШІ: якою людиною він є для вас. Типові значення — ті, з якими ШІ працював досі.

Далі — групи самого ШІ (черга, пороги, етапи, розклад, тексти) — у статті кожного ШІ. У Ломі — ще «Робота», «Голос», «Екран Ломі» (стаття «Ломі»).

Доступи й ліміти

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

• «Права творця» — «Свої розділи», «Свої ШІ-агенти», «Свої розширення (код)» (стаття «ШІ-творець»). Типово вимкнені; над ними — жовте попередження: видавайте лише тому ШІ, якому довіряєте.
• «Інтеграції» → «Налаштування інтеграцій» — ШІ читає й пропонує зміни в картках перевізників (Нова Пошта, Укрпошта, Meest, Rozetka Delivery); кожна зміна чекає «Підтвердити» адміністратора, ключі й токени ШІ не бачить (стаття «Інтеграції — вхід для ШІ»). Разом із галочкою ставиться розділ «Інтеграції».
• «Розділи» — інструменти ШІ є лише для відмічених розділів; «ШІ Віктор», «ШІ Ростік»… — доступ до «Входу для ШІ» цього агента (так Ломі чи Остап ним керують). «Працює з усіма компаніями й брендами» — інакше лише з тими, що відмічені в «Користувачах».
• «Спочатку запитати» — «Видалення», «Масові дії», «Платежі й гроші», «Відправка назовні (SMS, листи, ТТН)», «Керування іншими ШІ». Під кожною галочкою — що станеться; зняли — жовте попередження, що ШІ робитиме це без вашого «Підтвердити». Такі дії чекають підтвердження 24 години.
• «Ліміти» — «Запитів на хвилину» (типово 60), «Дій на день» (5 000; 0 — без ліміту), «Токенів моделі на місяць» (0 — без ліміту; вичерпано — ШІ «спить» до нового місяця).
• «Зберегти доступи» — діють з наступного запиту ШІ.

«Налаштування CRM» для ШІ закриті завжди: змінювати поля, воронки, права й налаштування компанії ШІ не може. Єдиний виняток — налаштування перевізників з доступом «Налаштування інтеграцій», і лише через «Підтвердити» адміністратора.

5API

Як ШІ підключають ззовні й чим ним керують інші ШІ: «Вхід для ШІ», токени, файл сесії, адреси MCP і REST. Тут видно, що саме бачать і можуть Ломі, Остап, ваш Claude чи своя програма.

Вхід для ШІ

Чим цей ШІ керується ззовні: картка /api/ai/sections/ai-<ключ> з інструментами ai_<ключ>_* (стан, налаштування, крок, черга, увімкнути/вимкнути, головні дії) — кожен з підписом «читає» чи «змінює» і, якщо дія небезпечна, «питає людину». Нижче — стаття для ШІ (help("ai-<ключ>")) і хто з мозків має доступ: Ломі чи Остап, у кого в «Доступах і лімітах» стоїть галочка «ШІ <ім'я>» (ім'я веде в їхні налаштування). Для мозку (Ломі, Остап) — навпаки: перелік ШІ, якими він керує, з «Відкрити» і «Вхід для ШІ».

Токени й підключення

• «Модель» — «Провайдер» і «Модель» (список приходить з ключа), «Зберегти модель». «Без моделі — зовнішній ШІ» означає, що думає ваш ШІ на своєму боці.
• «Токени · N» — «Новий токен» (показується один раз, скопіюйте одразу), таблиця з «Початок» і «Останнє використання», «Відкликати» (діє миттєво — над таблицею про це жовте попередження; спершу створіть новий токен).
• «Файл сесії — підключити свій чат без ключа API» — навичка для Claude або файл .md для ChatGPT, Kimi, Gemini. В Остапа це головна дія вкладки: чорна «Створити ключ і завантажити файл» і три кроки скачав›кинув у чат›ШІ заходить у CRM і робить«скачав → кинув у чат → ШІ заходить у 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 (провайдер не «Без моделі»). Під відповіддю видно, які дії виконано, а дія, що чекає згоди, — карткою з «Підтвердити» / «Відхилити». Історія чату зберігається у вашому браузері.
• «⋮» у шапці налаштувань: «Вимкнути» / «Увімкнути», «Скинути налаштування до типових» (питає «так чи ні»: зміни «Для всіх» зникнуть, «Для мене» лишаються), «Видалити» (питає; токени відкликаються одразу, журнал лишається). Вимкнений співробітник не працює і файл сесії не отримує.
• Результати дій — повідомленням поверх сторінки: «зроблено» зникає саме, помилка висить, поки не закриєте.

На телефоні шапка стискається до імені й стану, вкладки гортаються вбік, чат — на весь екран.