#AI-співробітник · Посібник з налаштування для адміністратора

Цей документ допоможе вам швидко розібратися, як налаштовувати та керувати AI-співробітниками, крок за кроком провівши вас через весь процес — від сервісів моделей до призначення завдань.

#I. Перед початком

#1. Системні вимоги

Перед налаштуванням переконайтеся, що ваше середовище відповідає таким умовам:

• Встановлено NocoBase 2.0 або новішої версії
• Увімкнено плагін AI-співробітника
• Наявний принаймні один доступний сервіс великих мовних моделей (наприклад, OpenAI, Claude, DeepSeek, GLM тощо)

#2. Розуміння двошарової архітектури AI-співробітників

AI-співробітники поділяються на два шари: "Визначення ролі" та "Налаштування завдань".

Шар	Опис	Характеристики	Функція
Визначення ролі	Базова особистість та ключові здібності співробітника	Стабільна та незмінна, як "резюме"	Забезпечує послідовність ролі
Налаштування завдань	Конфігурація для різних бізнес-сценаріїв	Гнучке налаштування	Адаптація до конкретних завдань

Простими словами:

"Визначення ролі" визначає, хто цей співробітник, "Налаштування завдань" визначає, що він має робити зараз.

Переваги такого дизайну:

• Роль залишається незмінною, але може виконувати завдання в різних сценаріях
• Оновлення або заміна завдань не впливає на самого співробітника
• Передумови та завдання незалежні, що спрощує обслуговування

#II. Процес налаштування (5 кроків)

#Крок 1: Налаштування сервісу моделей

Сервіс моделей — це мозок AI-співробітника, тому його потрібно налаштувати в першу чергу.

💡 Детальні інструкції з налаштування дивіться тут: Налаштування сервісу LLM

Шлях: Системні налаштування → AI-співробітник → Сервіс моделей

Натисніть Додати та заповніть таку інформацію:

Пункт	Опис	Примітки
Тип інтерфейсу	Наприклад, OpenAI, Claude тощо	Сумісний із сервісами, що використовують ту ж специфікацію
Ключ API	Ключ, наданий постачальником послуг	Зберігайте конфіденційність та регулярно змінюйте
Адреса сервісу	API Endpoint	Потребує зміни при використанні проксі
Назва моделі	Конкретна назва моделі (наприклад, gpt-4, claude-opus)	Впливає на можливості та вартість

Після налаштування, будь ласка, протестуйте з'єднання. У разі невдачі перевірте мережу, ключ API або назву моделі.

#Крок 2: Створення AI-співробітника

💡 Детальні інструкції дивіться тут: Створення AI-співробітника

Шлях: Керування AI-співробітниками → Створити співробітника

Заповніть основну інформацію:

Поле	Обов'язково	Приклад
Ім'я	✓	viz, dex, cole
Псевдонім	✓	Viz, Dex, Cole
Статус увімкнення	✓	Увімкнено
Короткий опис	-	"Експерт з аналізу даних"
Основний промпт	✓	Див. Посібник з промпт-інжинірингу
Вітальне повідомлення	-	"Привіт, я Viz…"

Потім прив'яжіть щойно налаштований сервіс моделей.

Рекомендації щодо написання промптів:

• Чітко визначте роль, тон та обов'язки співробітника
• Використовуйте слова на кшталт "повинен", "ніколи не" для підкреслення правил
• Завжди, коли це можливо, додавайте приклади, уникайте абстрактних описів
• Обмежуйтеся 500–1000 символами

Чим чіткіший промпт, тим стабільніша робота AI. Можете звернутися до Посібника з промпт-інжинірингу.

#Крок 3: Налаштування навичок

Навички визначають, що співробітник "може робити".

💡 Детальні інструкції дивіться тут: Навички

Тип	Область можливостей	Приклад	Рівень ризику
Фронтенд	Взаємодія зі сторінкою	Зчитування даних блоків, заповнення форм	Низький
Модель даних	Запити та аналіз даних	Агрегована статистика	Середній
Робочий процес	Виконання бізнес-процесів	Користувацькі інструменти	Залежить від робочого процесу
Інше	Зовнішні розширення	Веб-пошук, операції з файлами	Залежить від ситуації

Рекомендації щодо налаштування:

• 3–5 навичок на співробітника — найоптимальніше
• Не рекомендується вибирати всі навички, оскільки це може призвести до плутанини
• Вимкніть автоматичне використання (Auto usage) перед важливими операціями

#Крок 4: Налаштування бази знань (необов'язково)

Якщо вашому AI-співробітнику потрібно запам'ятовувати або посилатися на великий обсяг матеріалів, наприклад, інструкції до продуктів, FAQ тощо, ви можете налаштувати базу знань.

💡 Детальні інструкції дивіться тут:

• Огляд бази знань AI
• Векторна база даних
• Налаштування бази знань
• RAG (Retrieval-Augmented Generation)

Для цього потрібно додатково встановити плагін векторної бази даних.

Сценарії використання:

• Щоб AI розумів корпоративні знання
• Для підтримки запитань/відповідей та пошуку в документах
• Для навчання помічників, спеціалізованих на певній галузі

#Крок 5: Перевірка результату

Після завершення ви побачите аватар нового співробітника в нижньому правому куті сторінки.

Будь ласка, перевірте кожен пункт:

• ✅ Чи правильно відображається іконка?
• ✅ Чи може він вести базову розмову?
• ✅ Чи правильно викликаються навички?

Якщо всі пункти пройдені, налаштування успішне 🎉

#III. Налаштування завдань: Запуск AI в роботу

Раніше ми завершили "створення співробітника". Далі потрібно "запустити його в роботу".

AI-завдання визначають поведінку співробітника на конкретній сторінці або в блоці.

💡 Детальні інструкції дивіться тут: Завдання

#1. Завдання рівня сторінки

Застосовується до всієї сторінки, наприклад, "Аналіз даних на цій сторінці".

Точка входу для налаштування: Налаштування сторінки → AI-співробітник → Додати завдання

Поле	Опис	Приклад
Заголовок	Назва завдання	Аналіз конверсії етапів
Контекст	Контекст поточної сторінки	Сторінка списку лідів
Повідомлення за замовчуванням	Попередньо встановлена розмова	"Будь ласка, проаналізуйте тенденції цього місяця"
Блок за замовчуванням	Автоматично пов'язати з колекцією	таблиця лідів
Навички	Доступні інструменти	Запит даних, генерація діаграм

Підтримка кількох завдань: Один AI-співробітник може бути налаштований на виконання кількох завдань, які представлені користувачеві у вигляді опцій для вибору:

Рекомендації:

• Одне завдання має бути зосереджене на одній меті
• Назва має бути чіткою та зрозумілою
• Кількість завдань слід обмежувати 5–7

#2. Завдання рівня блоку

Підходить для роботи з певним блоком, наприклад, "Перекласти поточну форму".

Спосіб налаштування:

1. Відкрийте конфігурацію дій блоку
2. Додайте "AI-співробітника"

3. Прив'яжіть цільового співробітника

Порівняння	Рівень сторінки	Рівень блоку
Обсяг даних	Вся сторінка	Поточний блок
Деталізація	Глобальний аналіз	Детальна обробка
Типове використання	Аналіз тенденцій	Переклад форм, вилучення полів

#IV. Найкращі практики

#1. Рекомендації щодо налаштування

Пункт	Рекомендація	Причина
Кількість навичок	3–5	Висока точність, швидка відповідь
Автоматичне використання	Вмикайте обережно	Запобігає помилковим операціям
Довжина промпта	500–1000 символів	Баланс швидкості та якості
Мета завдання	Єдина та чітка	Запобігає розгубленості AI
Робочий процес	Використовуйте після інкапсуляції складних завдань	Вищий показник успішності

#2. Практичні поради

Починайте з малого, оптимізуйте поступово:

1. Спочатку створіть базових співробітників (наприклад, Viz, Dex)
2. Увімкніть 1–2 основні навички для тестування
3. Переконайтеся, що завдання виконуються нормально
4. Потім поступово розширюйте кількість навичок та завдань

Постійний процес оптимізації:

1. Запустіть початкову версію
2. Зберіть відгуки користувачів
3. Оптимізуйте промпти та налаштування завдань
4. Тестуйте та циклічно покращуйте

#V. Часті запитання

#1. Етап налаштування

З: Що робити, якщо збереження не вдається? В: Перевірте, чи заповнені всі обов'язкові поля, особливо сервіс моделей та промпт.

З: Яку модель обрати?

• Для коду → Claude, GPT-4
• Для аналізу → Claude, DeepSeek
• Чутливі до вартості → Qwen, GLM
• Для довгих текстів → Gemini, Claude

#2. Етап використання

З: AI відповідає занадто повільно?

• Зменшіть кількість навичок
• Оптимізуйте промпт
• Перевірте затримку сервісу моделей
• Розгляньте можливість зміни моделі

З: Виконання завдання неточне?

• Промпт недостатньо чіткий
• Занадто багато навичок призводять до плутанини
• Розбийте завдання на менші частини, додайте приклади

З: Коли слід вмикати автоматичне використання (Auto usage)?

• Можна вмикати для завдань типу запиту
• Рекомендується вимикати для завдань, що змінюють дані

З: Як змусити AI обробляти певну форму?

В: Якщо це конфігурація рівня сторінки, вам потрібно вручну вибрати блок.

Якщо це конфігурація завдання рівня блоку, контекст даних прив'язується автоматично.

#VI. Додаткова література

Щоб зробити ваших AI-співробітників ще потужнішими, ви можете продовжити читати такі документи:

Щодо налаштування:

• Посібник з промпт-інжинірингу - Техніки та найкращі практики для написання високоякісних промптів
• Налаштування сервісу LLM - Детальні інструкції з налаштування сервісів великих моделей
• Створення AI-співробітника - Створення та базове налаштування AI-співробітників
• Співпраця з AI-співробітником - Як ефективно взаємодіяти з AI-співробітниками

Розширені функції:

• Навички - Детальне розуміння налаштування та використання різних навичок
• Завдання - Розширені техніки налаштування завдань
• Вибір блоку - Як призначати блоки даних для AI-співробітників
• Джерело даних - Налаштування та керування джерелами даних
• Веб-пошук - Налаштування можливості веб-пошуку для AI-співробітників

База знань та RAG:

• Огляд бази знань AI - Вступ до функції бази знань
• Векторна база даних - Налаштування векторної бази даних
• База знань - Як створювати та керувати базою знань
• RAG (Retrieval-Augmented Generation) - Застосування технології RAG

Інтеграція робочих процесів:

• Вузол LLM - Текстовий чат - Використання текстового чату в робочих процесах
• Вузол LLM - Мультимодальний чат - Обробка мультимодальних вхідних даних, таких як зображення та файли
• Вузол LLM - Структурований вивід - Отримання структурованих відповідей AI

#Висновок

Найважливіше при налаштуванні AI-співробітників: спочатку запустіть, потім оптимізуйте. Спочатку успішно запустіть першого співробітника, а потім поступово розширюйте та допрацьовуйте.

Ви можете виконувати усунення несправностей у такому порядку:

1. Чи підключений сервіс моделей?
2. Чи не забагато навичок?
3. Чи чіткий промпт?
4. Чи чітко визначена мета завдання?

Дотримуючись цих кроків, ви зможете створити справді ефективну команду AI.