Налаштування підсистеми:
1. Створення API ключа.
1.1 Gemini
Користувачу потрібно авторизуватися у сервісі ШІ через акаунт Google по посиланню https://aistudio.google.com/api-keys.
Користувача зустріне після авторизації наступне вікно:

Зображення 1.1 – Початкове вікно після авторизації в сервісі Gemini API
У лівому нижньому куті для отримання ключа користувач повинен нажати на GET API key за допомогою якого відкриється наступне вікно:

Зображення 1.2 – Вікно управління ключами в сервісі Gemini API.
Дане вікно призначене для управління всіма проектами та ключами, які підв’язані до акаунту Google. Спочатку у користувача який не користується сервісом Gemini Api поля будуть порожні.
Для початку роботи потрібно створити ключ нажавши на кнопку у правому верхньому куті Create API key (Зображення 1.3).

Зображення 1.3 – Вікно управління ключами в сервісі Gemini API.
Користувачу відкриється форма (Зображення 1.4), де він може вказати назву ключа та обрати проект (можна використовувати початковий, або створити власний в полі вибору проекту), в якому буде використовуватись цей ключ та відповідно нажати кнопку «Create key».

Зображення 1.4 – Вікно створення ключа в сервісі Gemini API
Після попередніх дій у користувача з’явиться вікно та буде доступний функціонал зображений на цьому зображені:

Зображення 1.5 – Cтворений ключ в сервісі Gemini API.
Опис функціоналу до зображення 1.5:
1) Копіювання API ключа – копіює ключ в буфер обміну (який потрібно вказати в налаштуваннях).
2) Переглянути витрати – відкриває форму де можна переглянути використання бюджету сервісом.
3) Переглянути статистику використання – інформація про використання (запитів) по ключу.
4) Налаштування оплати – можливість встановити тарифікацію для збільшення можливостей сервісу (для цього потрібно автентифікуватись в Google Cloud та створити акаунт із підв’язаними тарифними даними).
*Без налаштованої оплати буде використовуватись тариф безкоштовний*
1.2 Claude
Користувачу потрібно авторизуватися у сервісі ШІ через акаунт Google по посиланню https://platform.claude.com.
Користувача зустріне після авторизації наступне вікно:

Зображення 1.6 – Початкове вікно після авторизації в сервісі Claude API.
У центральному блоці екрану потрібно нажати на GET API key за допомогою якого відкриється наступне вікно:

Зображення 1.7 – Вікно управління ключами в сервісі Claude API.
Дане вікно призначене для управління всіма проектами та ключами, які підв’язані до акаунту Google. Спочатку у користувача який не користується сервісом Claude Api поля будуть порожні.
Для початку роботи потрібно створити ключ нажавши на кнопку у правому верхньому куті +Create key (Зображення 1.8).

Зображення 1.8 – Вікно управління ключами в сервісі Claude API.
Користувачу відкриється форма (Зображення 1.9), де він може вказати назву ключа та обрати проект (можна використовувати початковий, або створити власний), в якому буде використовуватись цей ключ та відповідно нажати кнопку «Add».

Зображення 1.9 – Вікно створення ключа в сервісі Claude API.
Після попередніх дій у користувача з’явиться вікно в якому він повинен скопіювати ключ та зберегти у себе в захищеному місці:

Зображення 1.10 – Cтворений ключ в сервісі Claude API.
Наступний крок налаштування оплати:

Зображення 1.11 – Налаштування оплати в сервісі Claude API.
Ознайомитись детальніше з налаштуваннями оплати можна перейшовши по посиланню: https://platform.claude.com/docs/en/about-claude/pricing.
2.Початкове налаштування системи у BAS.
Встановлення налаштувань системи проводяться користувачем з «Повними правами» (подалі Адміністратор).
Для початку роботи адміністратор повинен створити налаштування за допомогою довідника «Налаштування підсистеми» та створити запис в ньому (приклад заповнення та опис функціоналу параметрів подано на зображенні 2.1).
*Без введеної організації та ключа API Softex система не буде працювати!

Зображення 2.1 – Приклад створення налаштувань.
Адміністратор може створювати безліч налаштувань та призначити їх користувачу (також може бути одне налаштування на декількох користувачів).
*Призначення налаштування користувачеві є обов’язковим. Без призначеного налаштування користувачу не буде доступно користуватися можливостями системи ШІ.
Для призначення налаштувань користувачеві слід зайти у довідник користувачів та відкрити карточку потрібного нам користувача та у полі зображеному на рисунку 2.2 вибрати потрібні налаштування.

Зображення 2.2 – Призначення налаштувань користувачеві.
Наступний крок це створення та налаштування профіля груп доступу, де потрібно обрати роль «(СФ) Користувач ШІ» (Зображення 2.3).

Зображення 2.3 – Призначення налаштувань користувачеві.
Після запису слід створити групу доступу та підібрати учасників групи яким має бути доступна підсистема ШІ (Зображення 2.4).

Зображення 2.4 – Створення групи доступу.
Наступний етап це створення записів (Зображення 2.5) про очікувані типи документів та базові налаштування для них за допомогою довідника «Типи документів» змінювати та додавати їх може будь-який користувач. Кожен запис в довіднику відображує той документ який буде створено на основі даних ШІ, тобто якщо система має створювати Надходження з різними типами операцій чи визначати номенклатуру у визначені табличні частини, слід створити кілька таких налаштувань з відповідними параметрами. Дані записи використовуються для спрямування ШІ та покращують точність визначення даних.

Зображення 2.5 – Приклад створення Типу документа.
3.Налаштування регламентного завдання (*Опціонально).
*Налаштування регламентного завдання доступне тільки Адміністраторам. Регламентне завдання використовується для автоматичного створення «Первинних документів» та Прихідних на їх основі.
Для створення чи управління регламентним завданням слід перейти у «Мої налаштування» та натиснути на кнопку Регламентне завдання (якщо регламентне завдання раніше не було створене система запропонує його створити) після чого відкриється форма налаштування регламентного завдання (Зображення 3.1).
Адміністратор за допомогою цієї форми може вимикати/вмикати регламентне завдання, створювати розклад для нього і обирати користувача чиї налаштування будуть використовуватись для звернення до сервісу ШІ. Рекомендаційні налаштування розкладу: Кожний день , кожні > 60 секунд.
*Ім’я користувача є обов’язковим параметром до заповнення.

Зображення 3.1 – Управління регламентним завданням.
Також Адміністратор може налаштувати обмін з телеграм ботом та власне автоматичне розпізнання з папки (Зображення 3.2) куди користувачі можуть вантажити файли безпосередньо в файлову систему.
Поле «Шлях для збереження файлів» - каталог куди користувачі можуть вантажити свої файли, та місце де буде створено інші папки для збереження файлів телеграм бота (створиться своя папка у даному каталозі), та створиться папка куди будуть переміщатися оброблені файли користувачів.

Зображення 3.2 – Додаткові налаштування регламентного завдання.
*Якщо не вказана папка, тоді Обмін з Телеграм ботом та можливість вантажити файли у папку є не доступні.
*Якщо вказана тільки папка тоді доступна можливість вантажити користувачам у неї свої файли, обмін з телеграм ботом не доступний.

