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

# ШІ-творець

ШІ-творець — ШІ-співробітник, якому адміністратор дав право додавати своє: власні розділи з полями й етапами, своїх ШІ-агентів і розширення кодом. Він керує лише тим, що створив сам; розділи, налаштування, агентів і код людей він не змінює, а все створене ним підписано його іменем.

## Можливості
- «Свої розділи» — створює власні розділи з полями, етапами й передачею даних в угоди, клієнтів, задачі та інші розділи.
- «Свої ШІ-агенти» — створює й підключає агентів з доступами не ширшими за свої.
- «Свої розширення (код)» — пише свої сторінки й агентів кодом у стилі 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).