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

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

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

Вкладки — саме в такому порядку: **Налаштування · 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("<key>")`: там `intro` (для чого розділ), `wiki.sections` (розділи статті) і `hint` кожного поля. Подробиці одного розділу статті — `help("<key>", "<розділ>")`, а не вся стаття.
- Іншими ШІ (програмами й агентами) керуйте через їхній «Вхід для ШІ»: `describe_section("ai-<key>")` і інструменти `ai_<key>_*`; доступ дає галочка «ШІ <ім'я>» у ваших «Доступах і лімітах». Небезпечне (вимкнути, скинути, змінити налаштування) — через кошик підтверджень.
- Список своїх дій, що чекають людини, — `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).
- Сторінка «Налаштування → Команда → Каталог ШІ» — старий каталог карток ШІ для «Структури» (фото, відділ, відповідальні); це не ШІ-співробітники.