Власні розділи
Власний розділ — розділ, якого нема серед стандартних, але потрібен саме вашій компанії: ремонти, проєкти, заявки, гарантійні випадки. Його пише ваш ШІ одним файлом (дані, свій вигляд і логіка) або ви збираєте в конструкторі без коду: назва, іконка, етапи, поля, що є в картці; правила передачі створюють з запису угоду, клієнта, задачу чи запис іншого розділу. У меню зліва розділ ставиться перемикачем на його плитці.
На цій сторінці
Можливості
- Галерея «Власні розділи»: плитки розділів і прозорий квадрат «+ Додати розділ» — туди перетягують файл розділу від ШІ.
- «У меню зліва» на плитці (і відділ меню), порядок — перетягуванням плиток. Окремого пункту «Розділи» в меню нема.
- Файл розділу від ШІ: дані, своя сторінка й агент одним файлом; ШІ-співробітник з правом творця встановлює сам (стаття Розділ від ШІ).
- Назва розділу й запису, іконка з фірмового набору, опис «Для чого розділ (бачать люди й ШІ)».
- Етапи з кольорами й позначкою «завершальний»; дошка за етапом або за полем-списком.
- «Що є в картці»: відповідальний, клієнт, угода, бренд, нотатки, файли.
- Поля тим самим конструктором «Типи даних», що в угод і клієнтів: обов'язковість, «при створенні», «у списку» діють і у формі, і в API.
- Список, дошка, картка-шторка з нотатками, файлами й журналом.
- Правила передачі: новий запис або етап → угода, клієнт, задача, запис іншого розділу.
- Окремий доступ до кожного розділу; імпорт і експорт XLSX; архів.
1Налаштування: галерея і новий розділ
Налаштування›Типи даних›Власні розділи«Налаштування → Типи даних → Власні розділи» — галерея: кожен розділ плиткою (іконка, назва, що всередині — «код · сторінка, агент, дані» або «конструктор · N записів», хто створив), останній — прозорий квадрат «+ Додати розділ».
Файл від ШІ (з кодом і своїм виглядом):
- «Інструкція для ШІ» — збережіть файл і дайте його своєму ШІ (Claude, ChatGPT, Gemini) разом з описом розділу; або «+ Розділ» → «Скопіювати завдання для ШІ».
- ШІ віддасть файл розділу (
.sgsection.jsonабо.html). Перетягніть його в квадрат «+ Додати розділ» (або «+ Розділ» → «Вибрати файл»). - Відкриється перевірка: «Що буде зроблено», «Зауваги», «Помилки». Якщо такий розділ уже є — «Оновити «…»» або «Окремий розділ поруч».
- «Показати в меню зліва» (і відділ меню) → «Встановити» / «Оновити».
ШІ-співробітник зробить сам: напишіть Ломі чи іншому ШІ «Зроби розділ Ремонти…» — з правом творця він встановить розділ сам, у галереї з'явиться плитка, а в меню зліва її ставите ви.
Конструктор без коду:
- «+ Розділ» → «Зібрати вручну».
- Заповніть «Назва розділу» (наприклад, «Ремонти»), «Назва запису» («Ремонт»), «Іконка», «Опис».
- «Етапи (дошка)»: назви, кольори, порядок «Вище» / «Нижче», позначка «завершальний»; «без етапів», якщо етапи не потрібні.
- «Дошка за»: «за етапом», за полем-списком або «без дошки».
- «Що є в картці»: «Відповідальний», «Клієнт», «Угода», «Бренд», «Нотатки», «Файли».
- «Розділ увімкнено» → «Створити». З'явиться плитка в галереї.
Меню зліва: на плитці — «У меню зліва» і відділ меню («основний список» або відділ, як він називається в меню). Пункт бачать усі, кому розділ доступний; сховати лише для себе — «Моє меню». Порядок пунктів — перетягуванням плиток.
«⋮» на плитці: «Відкрити», «Налаштувати розділ» / «Налаштувати дані», «Поля», «Таблиця даних» (записи розділу з кодом стандартним списком), «Код і версії», «Файл розділу» (вивантажити, дати ШІ доробити й завантажити назад — «Оновити»), «Видалити».
2Поля розділу
- На плитці ⋮›Поля«⋮ → Поля» або з розділу ⋮›Налаштувати поля«⋮ → Налаштувати поля» — відкриються «Типи даних» цього розділу.
- Додайте поля будь-якого типу; позначте «обов'язкове», «при створенні», «у списку».
- Вбудовані поля (назва, етап, клієнт…) видно з замком: їх не вимкнути, лише налаштувати показ і обов'язковість.
3Передача в інші розділи
- На плитці ⋮›Налаштувати розділ«⋮ → Налаштувати розділ» — блок «Передача в інші розділи» → «+ Правило».
- Коли: новий запис або запис перейшов на етап (наприклад, «Готово»).
- «створити в»: угода, клієнт, задача або інший власний розділ.
- «+ що передати»: поле цілі і що в нього підставити — текст або значення з запису (
{title},{custom.ключ}). - Для угоди, клієнта й задачі можна позначити зв'язок — створене прив'язується до запису.
Приклад: запис перейшов на «Готово» → задача «Видати клієнту». Створення проходить ті самі перевірки, що й вручну: обов'язкові поля цілі мають бути заповнені правилом.
Тригерів і автоматичних задач за налаштуваннями тригерів для записів власних розділів поки нема — лише правила передачі (features.csv: «Тригери й задачі для записів власних розділів» — далі).
4Доступ до розділу
- Кожен власний розділ має свій ключ доступу
x:<коротке ім'я>; сторінка з кодом без своїх даних —xe:<коротке ім'я>. Галочка — у Налаштування›Розділи меню«Налаштування → Розділи меню» (або в картці людини в «Користувачі»). Пункт у меню зліва бачать лише ті, кому розділ доступний. - Людям новий розділ типово відкритий, ШІ-співробітникам — лише якщо адміністратор відкрив його в доступах ШІ.
5Працювати із записами
Записи власного розділу ведуть так само, як угоди: список і дошка етапів, картка-шторка з полями, нотатками, файлами й журналом. Які поля є і що під ними підказано — налаштовує власник розділу в його «Типах даних».
- Пункт розділу в меню зліва (якщо його туди поставили) або «Власні розділи» → плитка → назва.
- Вкладки «Список» і «Дошка» (якщо є етапи або поле-список); фільтр за етапом («усі» або етап), галочка «Архів», «Пошук».
- «+ <Назва запису>» (наприклад, «+ Ремонт»; у порожньому розділі — «Додати перший») → форма з полями «при створенні» → «Створити».
- Клік по запису відкриває картку-шторку: поля (змінюються на місці), етап, відповідальний, клієнт («Телефон або назва»), «Нотатки», «Файли» («Прикріпити файл»), «Журнал».
- На дошці перетягніть картку в іншу колонку — етап зміниться, спрацюють правила передачі.
6Архів і видалення
- «в архів» / «з архіву» у картці запису.
- Видалити запис назавжди може лише адміністратор; інші переносять в архів.
- Розділ без записів можна видалити; розділ із записами — лише вимкнути.
7Імпорт і експорт
«⋮» розділу: «Експорт XLSX» (за поточними фільтрами) і «Імпорт XLSX» (колонки — за назвами полів, обов'язкова колонка «Назва»; спершу перевірка без запису). Також у «⋮»: «Налаштувати поля», «Налаштувати розділ».
Можливі помилки
| Що ви бачите | Чому | Що зробити |
|---|---|---|
| «Назвіть розділ» | Порожня назва розділу | Впишіть назву |
| «У кожного етапу має бути назва» | Порожній етап | Назвіть або видаліть етап |
| «Дошка будується лише за полем-списком цього розділу» | Для дошки вибрано поле іншого типу | Виберіть поле-список або «за етапом» |
| «Заповніть обов'язкові поля: …» | Поле обов'язкове в «Типах даних» | Заповніть поле |
| «Обов'язкові поля не можна очистити: …» | Спроба стерти обов'язкове значення | Впишіть нове значення |
| «У розділі … записів — вимкніть його замість видалення» | Розділ з записами | Вимкніть «Розділ увімкнено» |
| «Видаляє адміністратор; інші — переносять в архів» | Немає права видаляти | Перенесіть запис в архів |
| «Нотатки в цьому розділі вимкнено» / «Файли в цьому розділі вимкнено» | Вимкнено в «Що є в картці» | Увімкніть у налаштуваннях розділу |
| «Потрібна колонка «Назва»» | У файлі імпорту нема колонки назви | Додайте колонку «Назва» |
| «Розділ «…» уже є…» | Файл розділу вже встановлено | У перевірці виберіть «Оновити» або «Окремий розділ поруч» |
| «Файл розділу з помилками: …» | ШІ написав файл з помилками | Покажіть ШІ список «Помилки» з перевірки — він виправить |
| «У меню зліва ставиться розділ зі сторінкою…» | У розділу лише агент | Додайте сторінку або лишіть розділ поза меню |
| Перемикач «У меню зліва» неактивний | Розділ вимкнено або нема сторінки | Увімкніть розділ |
Для ШІ-співробітників
Власний розділ видно в каталозі за коротким ім'ям: describe_section("<slug>") повертає поля, етапи й обов'язкові. Потрібен доступ до розділу x:<slug> (і «Власні розділи»).
| Інструмент | Що робить |
|---|---|
records_meta | Опис розділу: етапи, поля, обов'язкові, відповідальні |
records_list | Записи з q, stage, responsible_id, client_id, archived |
records_get | Картка запису: поля, нотатки, журнал |
records_create | Новий запис (обов'язкові поля — з «Типів даних»); передавайте idempotency_key |
records_update | Змінити запис: етап, поля, відповідальний |
ШІ з правом творця встановлює цілий розділ файлом (дані, сторінка, агент): sections_package_guide → sections_package_check → sections_package_install, свій розділ вивантажує sections_package_export і оновлює з update; перелік — sections_gallery. Інструкція — стаття Розділ від ШІ. У меню зліва розділ ставить людина.
ШІ з правом творця «Свої розділи» може також створювати власні розділи й поля по одному інструментами sections_list, sections_create, sections_update, sections_rule_targets, sections_delete (порожній свій розділ; спочатку запитати), fields_list, fields_create, fields_update, fields_builtin_update, fields_delete (спочатку запитати) — і змінювати лише створене собою.
Чого не робити:
- Не вигадувати
slugі назви етапів — брати зrecords_meta. - Не змінювати розділи, створені людьми або іншими ШІ.
- Не видаляти записи: інструмента видалення нема, у людини це робить лише адміністратор.
Додаткова інформація
- Пов'язані статті: Розділ від ШІ: файл розділу, Розширення (код), Імпорт і експорт, Угоди, Завдання.
Цю саму статтю читають ШІ-співробітники Helomi: help("custom-sections")