2.14.1. Розпізнавання ШІ

Функціонал ШІ-розпізнавання дозволяє автоматично аналізувати вміст документів чи зображень. Штучний інтелект опрацьовує текст документа, ідентифікує ключові дані та встановлює відповідність між ними та визначеними атрибутами системи.

Чим відрізняється ШІ-розпізнавання від IDP?

У платформі також існує розпізнавання за допомогою технології IDP (Intelligent document processing), яке існувало в системі задовго до появи ШІ-розпізнавання. Ви можете переглянути основні відмінності цих двох типів розпізнавань у таблиці нижче:

Критерій	ШІ-розпізнавання	IDP-розпізнавання
Принцип роботи	Аналіз документа як єдиного тексту з розумінням контексту та семантики	Фокус на структурі документа, розпізнавання зон та їх вмісту
Типи документів	Працює з неструктурованими документами різноманітних форматів.	Оптимізоване для конкретних типів документів
Необхідність тренування	Не потребує додаткового тренування на зразках документів	Вимагає попереднього тренування на конкретних шаблонах
Провайдери	• OpenAI • Azure OpenAI • DeepSeek • Grok • Gemini • Claude	• Azure Form Recognizer • Google

2.14.1.1. Налаштувати розпізнавання ШІ

Щоб налаштувати розпізнавання документів за допомогою штучного інтелекту, виконайте наступні етапи:

1. Створіть підписку на модель ШІ та згенерувати ключ — створіть акаунт бажаного провайдера ШІ та створіть API-ключ, щоб налаштувати інтеграцію провайдера з платформою Scriptum.

2. Додайте модель ШІ — налаштуйте інтеграцію провайдера з платформою Scriptum.

3. Створіть сценарій ШІ — у платформі існує Системний сценарій для розпізнавання документів — sys_doc_recognize. Цей сценарій підходить для більшості типових документів і не потребує додаткового налаштування.

   Коли доцільно створювати власний сценарій ШІ?

   Для нестандартних випадків, ви можете створити власний користувацький сценарій для більш точного розпізнавання. Рекомендуємо створювати власний сценарій на основі дублікату системного сценарію sys_doc_recognize, оскільки він уже містить необхідні системні змінні. Наприклад, змінна docTypes передає до сценарію інформацію про типи документів платформи. Відтворити подібний функціонал шляхом ручного створення змінних є складно та не рекомендовано.

4. Створіть шаблон розпізнавання — в межах шаблону ви можете задати які саме типи документів бажаєте розпізнавати.

5. Налаштуйте або створіть ярлик для розпізнавання — підключіть створений шаблон розпізнавання до ярлика.

6. Налаштуйте атрибути типу документа — додайте описи до атрибутів, щоб покращити результат розпізнавання.

2.14.1.1.1. Створити підписку на модель ШІ та згенерувати ключ

Ви можете обрати один з наступних провайдерів:

Платформа OpenAI

1. Перейдіть на сайт OpenAI platform.

2. Виберіть кнопку Start building.

   

3. В полі Organization name 1 введіть довільну назву організації, а потім в полі What best describes you 2 виберіть Not technical.

4. Виберіть кнопку Create organization 3.

   

5. Виберіть I'll invite my team later.

   

6. В полі API key name 1 введіть довільну назву для ключа.

7. Поле Project name 2 залиште без змін.

8. Виберіть кнопку Generate API Key 3.

   

9. Виберіть кнопку Copy, щоб скопіювати згенерований ключ.

   

10. Вставте цей ключ за допомогою комбінації клавіш Ctrl+C в будь-яке безпечне місце, наприклад в нотатки. Цей ключ стане вам у пригоді у подальших етапах налаштувань.

    Увага:

    Після закриття цього вікна, з міркувань безпеки, ви більше не зможете побачити цей ключ у платформі OpenAI. Тому якщо ви не збережете цей ключ, то доведеться генерувати новий.

11. Виберіть кнопку Continue.

    

12. Виберіть суму, на яку бажаєте поповнити ваш баланс 1, а потім виберіть кнопку Purchase credits 2.

    

13. Введіть ваші платіжні дані 1, а потім виберіть кнопку Add payment method 2.

    

14. Перейдіть до наступного етапу налаштувань: Додати модель ШІ.

Служба Azure OpenAI

1. Перейдіть на сайт Azure OpenAI Service.

2. Виберіть кнопку Create with Azure AI Foundry.

   

3. Виберіть кнопку Sign in to get started.

   

4. В полі Email 1 введіть електронну пошту на яку бажаєте зареєструвати акаунт, а потім виберіть кнопку Next 2.

   

5. Перейдіть у вашу електронну пошту, відкрийте лист від Microsoft, а потім скопіюйте код підтвердження, щоб підтвердити вашу електронну пошту.

6. В полі Enter code 1 вставте код, який ви скопіювали з листа, а потім виберіть кнопку Next 2.

   

7. В полі Phone введіть ваш номер телефону 1, а потім виберіть кнопку Text me 2, щоб отримати СМС підтвердження на ваш номер.

   

8. В полі Verification code 1 введіть код з СМС повідомлення, а потім виберіть кнопку Verify code 2.

   

9. В полі Address line 1 1 введіть адресу, а потім в полі City 2 введіть місто, які відображатимуться в рахунку.

10. В полі Postal code 3 введіть ваш поштовий індекс, який відображатиметься в рахунку.

11. Установіть прапорець I represent that I am… 4, щоб погодитись з умовами договору, а потім виберіть кнопку Next 5.

    

12. Заповніть дані вашої банківської картки 1, які використовуватимуться в подальших транзакціях, а потім виберіть кнопку Next 2.

    

13. Установіть прапорець No technical support… 1, щоб відмовитись від платних послуг підтримки вашого акаунту, а потім виберіть кнопку Sign up 2, щоб завершити реєстрацію.

    

14. Перейдіть на сайт Azure OpenAI Studio.

15. В лівому верхньому куті виберіть піктограму 1, а потім виберіть Create a resource 2.

    

16. В полі пошуку 1 введіть Azure openAI, а потім в результатах пошуку знайдіть сервіс Azure openAI та виберіть кнопку Create 2.

    

17. Під полем Resource group виберіть Create new 1.

18. В полі Name 2 введіть довільну назву, а потім виберіть кнопку OK 3.

    

19. В полі Name 1 введіть довільну назву, а потім в полі Pricing tier 2 виберіть Standard S0.

20. Виберіть кнопку Next 3.

    

21. Виберіть кнопку Next.

    

22. Виберіть вкладку Deployments.

    

23. Виберіть кнопку Deploy model 1, а потім виберіть Deploy base model 2.

    

24. Виберіть кнопку Deploy.

    

25. Виберіть піктограму , щоб скопіювати ключ.

    

26. Вставте цей ключ за допомогою комбінації клавіш Ctrl+C в будь-яке безпечне місце, наприклад в нотатки. Цей ключ стане вам у пригоді у подальших етапах налаштувань.

27. Перейдіть до наступного етапу налаштувань: Додати модель ШІ.

Платформа DeepSeek

1. Перейдіть на сайт DeepSeek platform.

2. Виберіть кнопку Sign up, щоб зареєструватись.

   

3. В полі Email address 1 введіть вашу електронну пошту.

4. В полі Password 2 введіть бажаний пароль, а потім в полі Confirm password 3 введіть ваш пароль ще раз.

   

5. Виберіть кнопку Send code 1, щоб підтвердити вашу електронну пошту. Після цього, на вказану вами електронну пошту надійде код з шести чисел.

6. В полі Code 2 введіть код, який надійшов на вашу електронну пошту, а потім виберіть кнопку Sign up 3, щоб завершити реєстрацію.

   

7. Перейдіть у секцію Top up.

   

8. В секції Amount 1 виберіть суму, на яку бажаєте поповнити ваш баланс.

9. Виберіть кнопку Next step 2.

   

10. Виберіть один з доступних способів оплати: PayPal A або банківська картка B.

    

11. Введіть ваші дані для оплати 1, а потім виберіть кнопку Pay 2.

    

12. Перейдіть в секцію API keys 1, а потім виберіть кнопку Create new API key 2.

    

13. В полі Name введіть довільне імʼя для ключа, а потім виберіть кнопку Create API key.

    

14. У вікні Create new API key виберіть кнопку Copy, щоб скопіювати згенерований ключ.

    

15. Вставте цей ключ за допомогою комбінації клавіш Ctrl+C в будь-яке безпечне місце, наприклад в нотатки. Цей ключ стане вам у пригоді у подальших етапах налаштувань.

    Увага:

    Після закриття цього вікна, з міркувань безпеки, ви більше не зможете побачити цей ключ у платформі DeepSeek. Тому якщо ви не збережете цей ключ, то доведеться генерувати новий.

16. Перейдіть до наступного етапу налаштувань: Додати модель ШІ.

Платформа Grok

1. Перейдіть на сайт xAI API console.

2. Виберіть Sign up.

   

3. В полі Email 1 введіть вашу електронну пошту, а потім виберіть кнопку Submit 2.

   

4. Заповніть решту полів для створення профілю 1, а потім виберіть кнопку Continue 2.

   

5. Перейдіть у вашу електронну пошту, відкрийте лист від xAI, а потім виберіть Validate my email address, щоб підтвердити вашу електронну пошту.

   

6. Після підтвердження ви побачите вікно Email verified. Ви можете закрити цю вкладку браузера, та повернутись на попередню вкладку, в якій проходили попередні кроки інструкції.

   

7. Установіть прапорці навпроти пунктів про згоду з умовами користування та підтвердження повноліття 1, а потім виберіть кнопку Continue 2.

   

8. На стартовій сторінці вашого профілю виберіть кнопку Create an API key.

   

9. Виберіть кнопку Set up billing, щоб налаштувати оплату за користуванням API.

   

10. В секції Billing address виберіть Edit.

    

11. Заповніть всі обовʼязкові поля для формування рахунку 1, а потім виберіть кнопку Save 2.

    

12. В секції Payment methods виберіть Add method, щоб додати спосіб оплати.

    

13. Виберіть спосіб оплати 1, а потім заповніть поля про його деталі 2.

14. Виберіть кнопку Save card 3.

    

15. Виберіть Purchase credits, щоб поповнити баланс.

    

16. В полі Custom amount 1 введіть суму, на яку бажаєте поповнити рахунок, а потім виберіть кнопку Proceed 2.

    

17. Виберіть кнопку Purchase credits, щоб підтвердити поповнення балансу.

    

18. Відкрийте вкладку 1, а потім виберіть кнопку Create API key 2.

    

19. В полі Name 1 введіть довільну назву для ключа, а потім виберіть кнопку Save 2.

    

20. Виберіть кнопку щоб скопіювати API ключ.

    

21. Вставте цей ключ за допомогою комбінації клавіш Ctrl+C в будь-яке безпечне місце, наприклад в нотатки. Цей ключ стане вам у пригоді у подальших етапах налаштувань.

    Увага:

    Після закриття цього вікна, з міркувань безпеки, ви більше не зможете побачити цей ключ у платформі. Тому якщо ви не збережете цей ключ, то доведеться генерувати новий.

22. Перейдіть до наступного етапу налаштувань: Додати модель ШІ.

Платформа Gemini

1. Перейдіть на сайт Gemini API.

2. Виберіть кнопку Get a Gemini API Key.

   

3. Виберіть кнопку Get API key.

   

4. Установіть прапорець I consent to the Google APIs Terms… 1, а потім виберіть кнопку I accept 2.

   

5. Виберіть кнопку Create API key.

   

6. Виберіть кнопку Copy, щоб скопіювати API ключ.

   

7. Вставте цей ключ за допомогою комбінації клавіш Ctrl+C в будь-яке безпечне місце, наприклад в нотатки. Цей ключ стане вам у пригоді у подальших етапах налаштувань.

   Увага:

   Після закриття цього вікна, з міркувань безпеки, ви більше не зможете побачити цей ключ у платформі. Тому якщо ви не збережете цей ключ, то доведеться генерувати новий.

8. Перейдіть до наступного етапу налаштувань: Додати модель ШІ.

Платформа Claude

1. Перейдіть на сайт Anthropic API.

2. Виберіть кнопку Start building.

   

3. В полі Email 1 введіть вашу електронну пошту, на яку бажаєте зареєструвати акаунт, а потім виберіть кнопку Continue with email 2.

   

4. Перейдіть у вашу електронну пошту, відкрийте лист від Anthropic, а потім виберіть Sign in to Anthropic Console, щоб підтвердити вашу електронну пошту.

   

5. В полі What's your full name 1 введіть ваше імʼя та прізвище, а потім в полі What should we call you 2 введіть ваше імʼя.

6. Установіть прапорець I'm at least 18 years old… 3, щоб підтвердити повноліття, а потім виберіть кнопку Continue 4.

   

7. Виберіть тип вашого акаунту, наприклад, Individual, щоб створити особистий акаунт.

   

8. Виберіть вкладку Get API keys, щоб згенерувати ключ.

   

9. В полі Key Name 1 внесіть зміни в назву ключа. Ви можете назвати ключ Scriptum, щоб було зрозуміло місце застосування даного ключа.

10. Виберіть кнопку Create API Key 2.

    

11. В полі API KEY виберіть Copy, щоб скопіювати створений ключ.

    

12. Вставте цей ключ за допомогою комбінації клавіш Ctrl+C в будь-яке безпечне місце, наприклад в нотатки. Цей ключ стане вам у пригоді у подальших етапах налаштувань.

    Увага:

    Після закриття цього вікна, з міркувань безпеки, ви більше не зможете побачити цей ключ у платформі. Тому якщо ви не збережете цей ключ, то доведеться генерувати новий.

13. На цьому етапі, ваш ключ готовий до використання. На вашому балансі вже лежать безкоштовні 5$, які вам було надано за реєстрацію. Ви можете перейти до наступних етапів налаштувань або ж поповнити ваш баланс на додаткову суму.

Щоб поповнити баланс, виконайте наступні кроки:

14. Виберіть кнопку Continue.

    

15. Виберіть кнопку Manage API keys.

    

16. Перейдіть в секцію Billing.

    

17. Виберіть кнопку Add Credit Card.

    

18. В полі Current Balance 1 введіть суму, на яку бажаєте поповнити баланс.

19. В секції Credit Card 2 введіть дані вашої банківської картки з якої бажаєте поповнити баланс.

20. Виберіть кнопку Buy credits 3, щоб підтвердити купівлю.

    

21. Перейдіть до наступного етапу налаштувань: Додати модель ШІ.

2.14.1.1.2. Додати модель ШІ

1. У панелі навігації, виберіть робочий стіл Студія 1.

2. Виберіть групу ярликів ШІ Центр 2, а потім виберіть ярлик Моделі ШІ 3.

   

3. У панелі інструментів, виберіть Додати модель 4.

4. У розкривному списку виберіть LLM модель 5.

   

5. Установіть прапорець потрібного постачальника обробки даних 1, відповідно до підписки, яку ви оформили на попередньому етапі інструкції.

6. Установіть прапорець Я прочитав(ла) і погоджуюсь з політикою обробки даних обраного провайдера 2.

7. Виберіть кнопку Далі 3.

   

8. Виконайте решту кроків відповідно до вибраного постачальника.

Постачальник Azure OpenAI

9. У полі Ключ 1 вставте значення з поля API key 1 у ресурсі Azure OpenAI, який ви створили у розділі Створити підписку на службу Azure OpenAI (кроки 16–21).

10. У полі Термін дії ключа 2 виберіть дату, до якої цей ключ буде дійсним.

    

11. Якщо в попередньому полі ви вказали дату, можете також установити прапорець Повідомити адміністратора за 15 днів до закінчення дії ключа.

12. У полі URL-адреса 1 вставте значення з поля Azure OpenAI endpoint у ресурсі Azure OpenAI, який ви створили у розділі Створити підписку на службу Azure OpenAI (кроки 16–21).

13. У полі Ідентифікатор розгортання 2 вставте значення з поля Deployment name розгортання (deployment), яке ви створили у розділі Створити підписку на службу Azure OpenAI (кроки 23–24).

    

14. Виберіть кнопку Перевірити API-ключ. Якщо ключ дійсний, з’явиться повідомлення API-ключ дійсний.

    

15. Установіть прапорець Я розумію, що використання API буде оплачено з мого рахунку 1. Це означає, що використання моделі оплачуватиметься відповідно до тарифів провайдера, у якого ви оформили підписку.

16. Виберіть кнопку Далі 2.

    

17. У полі Назва 1 введіть назву для доданої моделі.

18. У полі Опис 2 вкажіть призначення моделі.

    

19. Установіть прапорець Модель за замовчуванням 1, якщо бажаєте автоматично використовувати цю модель для цього провайдера. Якщо ви додасте іншу модель цього ж провайдера, ця модель буде вибрана за замовчуванням.

20. Виберіть кнопку Додати 2.

    

Постачальники OpenAI, DeepSeek, Grok, Gemini, Claude

9. В полі Ключ 1 вставте посилання на API-ключ, який ви згенерували на попередньому етапі.

10. В полі Термін дії ключа 2 виберіть дату, до котрої даний ключ буде дійсним.

11. Поставте галочку Повідомити адміністратора за 15 днів до закінчення дії ключа 3.

12. Виберіть кнопку Перевірити API-ключ 4. Після цього, в разі якщо ваш ключ дійсний, ви побачите повідомлення API-ключ дійсний.

    

13. Поставте галочку Я розумію, що використання API буде оплачено з мого рахунку 1. Це означає, що всі кошти згідно з тарифом вашого провайдера в якому ви оформили підписку.

14. Виберіть кнопку Далі 2.

    

15. В секції Модель 1 виберіть один з наступних варіантів:

    • Рекомендована модель: кожен провайдер має декілька моделей, але платформа Scriptum завжди рекомендуватиме саме ту, яка найкраще підходить для роботи з документами. Наприклад: платформа OpenAI має моделі gpt-5-mini, gpt-5.3, gpt-5.2, gpt-4.1-mini та багато інших. Платформа Scriptum рекомендує вам саме модель gpt-5-mini.
    • Користувацька модель: якщо вам не підходить та модель, яку рекомендує платформа, ви можете вибрати будь-яку іншу модель, яку має ваш провайдер. При виборі цього варіанту, у вас зʼявиться поле Користувацька модель 2, де ви зможете обрати одну з моделей, яку пропонує ваш провайдер.

16. Виберіть кнопку Далі 3.

    

17. В полі Назва 1 введіть назву для доданої моделі.

18. В полі Опис 2 введіть призначення моделі.

19. Поставте галочку Модель за замовчуванням 3, якщо бажаєте автоматично використовувати цю модель для цього провайдера. Тобто, якщо ви захочете додати ще одну модель ШІ такого ж самого провайдера, то вибрана вами модель буде обиратись за замовчуванням.

20. Виберіть кнопку Додати 4.

    

2.14.1.1.3. Створити шаблон розпізнавання

1. У панелі навігації, виберіть робочий стіл Студія 1.

2. Виберіть групу ярликів Центр ШІ 2, а потім групу ярликів Розпізнавання документів 3.

3. Виберіть ярлик Шаблони розпізнавання 4, а потім у панелі інструментів виберіть + 5.

   

4. Заповніть поля використовуючи підказки в таблиці нижче.

   

Поле	Опис
Код*	Код повинен бути унікальним. Код повинен бути коротким (зазвичай до 10 символів). Використовуйте тільки латинські букви та цифри.
Найменування*	Введіть назву шаблону.
Опис	За потреби, введіть короткий опис призначення шаблону.
Метод розпізнавання*	Виберіть варіант Сценарій ШІ.
Сценарій ШІ*	Виберіть зі списку потрібний вам сценарій ШІ. У списку будуть відображені лише сценарії ШІ типу Розпізнавання документа. Ви також можете обрати системний сценарій sys_doc_recognize — який розроблений щоб розпізнавати як один, так і декілька документів одночасно.
Типи документів	Виберіть один з варіантів: Дозволити всі типи — тоді користувач зможе розпізнавати усі типи документів, до яких має доступ. Обрати типи — шаблон розпізнаватиме лише вказані типи документів. При виборі цього варіанту зʼявиться поле для вибору потрібних типів документів.

5. У панелі інструментів виберіть піктограму Зберегти A або Зберегти та закрити B.

   

2.14.1.1.4. Налаштувати ярлик для розпізнавання

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

1. Створіть ярлик або відкрийте один із системних ярликів типу Документи. Під час створення зверніть увагу на наступні кроки.

   

2. При створенні ярлика перейдіть у вкладку Типізовані 1.

3. У полі Типи документів 2 виберіть типи документів, з якими користувачі працюватимуть у цьому ярлику.

   Для розпізнавання платформа використовує лише ті типи документів, які одночасно вибрані і в ярлику, і в шаблоні розпізнавання (перетин списків). Тому якщо тип документа вибрано лише в одному місці (лише в ярлику або лише в шаблоні), він не потрапить до списку типів для розпізнавання.

   

4. Виберіть кнопку Налаштування дій.

   

5. Установіть прапорець дії Розпізнати документ 1.

6. В полі Доступні шаблони розпізнавання 2 виберіть зі списку потрібний шаблон (наприклад той, який ви створили у попередньому розділі).

   Примітка:

   Ви можете обрати декілька шаблонів розпізнавання в межах одного ярлика. Таким чином, користувач при натисканні іконки розпізнавання зможе самостійно обрати потрібний шаблон.

7. Виберіть кнопку Зберегти 3.

   

8. У панелі інструментів виберіть піктограму Зберегти A або Зберегти та закрити B.

   

2.14.1.1.5. Налаштувати атрибути типу документа

Цей крок є необовʼязковим, але може суттєво підвищити якість розпізнавання. Налаштування атрибутів типу документа буде корисним у випадках, коли для розпізнавання використовується:

• системний сценарій sys_doc_recognize
• користувацькі сценарії, які працюють зі змінною documentTypes

Змінна documentTypes передає до LLM не лише Назву, Код та Тип атрибутів типу документа, а й вміст поля Опис, заданий під час створення або редагування атрибута. Тому ви можете додати додатковий контекст у поле Опис. LLM використовує цей опис, щоб точніше зрозуміти, де саме шукати значення та як його інтерпретувати.

---

Приклад:

У цьому атрибуті ми хочемо зберігати інформацію про адресу, тому описуємо для LLM, де саме цю інформацію варто шукати в документі:

Зазвичай знаходиться на першій сторінці документа. Записується від руки. Розташоване під полями «Поверх» та «Локація».

2.14.1.2. Розпізнати документ за допомогою ШІ

Ви можете розпізнати документ за допомогою штучного інтелекту. Це допоможе розпізнати вміст документа та перевести його у відповідні атрибути системи. Перед тим як розпізнати документ за допомогою штучного інтелекту, переконайтеся, що налаштували ШІ-розпізнавання.

Спосіб 1: через системний ярлик

У цьому сценарії, розпізнавання зможе виконувати лише адміністратор платформи.

1. У панелі навігації виберіть робочий стіл Студія 1 > виберіть групу ярликів Центр ШІ 2 > виберіть групу ярликів Розпізнавання документів 3.

2. Виберіть ярлик Журнал розпізнавання 4, а потім у панелі інструментів виберіть + 5.

   

3. В полі Шаблон розпізнавання 1 виберіть потрібний шаблон розпізнавання.

4. Установіть прапорець Автоматично створити документ 2, якщо бажаєте, щоб після розпізнавання автоматично створювався документ з розпізнаними даними. Якщо цей прапорець не встановлено, ви зможете переглянути результат розпізнавання та вручну підтвердити створення документа.

   
   Увага:

   Якщо розпізнані дані не відповідають правилам валідації атрибута, система підсвітить такий атрибут червоним у вікні попереднього перегляду (яке доступне при вимкненому автоматичному створенні документа) — ви зможете виправити значення вручну перед створенням документа. Якщо ж ви увімкнили автоматичне створення документа, документ не буде створено, оскільки система не зможе автоматично виправити помилку валідації.

5. В панелі інструментів поля Файл виберіть +. Ви можете завантажити одразу декілька файлів.

   
   Примітка:

   Файл має відповідати типу документа, який ви підключили в ярлику та шаблоні розпізнавання.

   Приклад: якщо до ярлика та шаблону ви додали тип документа Заява на відпустку, то в поле файл вам, найімовірніше, потрібно буде завантажити заяву конкретного працівника: Заява на відпустку Івана Гончара.

   Примітка:

   Якщо ви завантажили одразу декілька файлів, ви можете використати нижнє меню, щоб перемикатись між завантаженими файлами.

   

6. Виберіть кнопку Розпізнати.

   

7. Подальші кроки залежать від того, чи обрали ви опцію З попереднім переглядом:

Варіант 1: ви не обрали Автоматично створити документ

8. Ви побачите ваш завантажений документ та результат розпізнавання. За потреби ви можете внести зміни до значень атрибутів 1, а потім вибрати Створити документ 2, щоб підтвердити збереження результату.

   

9. Якщо результат розпізнавання вам не підходить і ви не бажаєте його зберігати — просто закрийте вкладку.

Примітка:

Якщо ви завантажили одразу декілька файлів і встановили прапорець З попереднім переглядом, відкриється сторінка з такими деталями: загальний прогрес розпізнавання A, а також статус кожного окремого документа B.

Якщо під час розпізнавання виникли помилки, відповідні записи будуть додатково згруповані у вкладці Помилки 1 для зручного перегляду. У цій вкладці ви можете відкрити документ, який спричинив помилку 2, переглянути деталі помилки 3 та, за потреби, повторити спробу розпізнавання 4.

Після завершення процесу розпізнавання ви можете вибрати будь-який розпізнаний документ зі списку 1, за потреби відредагувати результат розпізнавання 2, а потім вибрати Створити документ 3, щоб підтвердити збереження результату.

Варіант 2: ви обрали Автоматично створити документ

10. Ви отримаєте сповіщення від платформи про початок процесу розпізнавання.

    

11. Якщо розпізнавання буде успішно завершено, ви отримаєте додаткове сповіщення. У тексті повідомлення виберіть Деталі, щоб переглянути результат розпізнавання, або Створений документ, щоб одразу відкрити створений документ.

    

    Ліворуч відображатиметься завантажений вами файл A, а праворуч його атрибути з розпізнаними даними B.

    

12. Виберіть Відкрити документ, якщо бажаєте переглянути створений документ та за потреби відредагувати значення атрибутів.

    

Примітка:

Якщо ви завантажили одразу декілька файлів, відкриється сторінка з такими деталями: загальний прогрес розпізнавання A, а також статус кожного окремого документа B.

Якщо під час розпізнавання виникли помилки, відповідні записи будуть додатково згруповані у вкладці Помилки 1 для зручного перегляду. У цій вкладці ви можете відкрити документ, який спричинив помилку 2, переглянути деталі помилки 3 та, за потреби, повторити спробу розпізнавання 4.

Після завершення процесу розпізнавання ви можете вибрати будь-який розпізнаний документ зі списку 1, а потім вибрати Відкрити документ 2, щоб переглянути створений документ та за потреби відредагувати значення атрибутів.

Спосіб 2: через користувацький ярлик

У цьому сценарії, розпізнавання зможуть виконувати будь-які користувачі платформи, яким адміністратор надасть доступ до ярлика.

1. Перейдіть в ярлик, в якому увімкнена та налаштована дія Розпізнати документ. (Див. розділ Налаштувати ярлик для розпізнавання

2. У панелі інструментів виберіть піктограму .

   

3. В полі Шаблон розпізнавання 1 виберіть потрібний шаблон розпізнавання.

4. Установіть прапорець Автоматично створити документ 2, якщо бажаєте, щоб після розпізнавання автоматично створювався документ з розпізнаними даними. Якщо цей прапорець не встановлено, ви зможете переглянути результат розпізнавання та вручну підтвердити створення документа.

   
   Увага:

   Якщо розпізнані дані не відповідають правилам валідації атрибута, система підсвітить такий атрибут червоним у вікні попереднього перегляду (яке доступне при вимкненому автоматичному створенні документа) — ви зможете виправити значення вручну перед створенням документа. Якщо ж ви увімкнили автоматичне створення документа, документ не буде створено, оскільки система не зможе автоматично виправити помилку валідації.

5. В панелі інструментів поля Файл виберіть +. Ви можете завантажити одразу декілька файлів.

   
   Примітка:

   Файл має відповідати типу документа, який ви підключили в ярлику та шаблоні розпізнавання.

   Приклад: якщо до ярлика та шаблону ви додали тип документа Заява на відпустку, то в поле файл вам, найімовірніше, потрібно буде завантажити заяву конкретного працівника: Заява на відпустку Івана Гончара.

   Примітка:

   Якщо ви завантажили одразу декілька файлів, ви можете використати нижнє меню, щоб перемикатись між завантаженими файлами.

   

6. Виберіть кнопку Розпізнати.

   

7. Подальші кроки залежать від того, чи обрали ви опцію З попереднім переглядом:

Варіант 1: ви не обрали Автоматично створити документ

8. Ви побачите ваш завантажений документ та результат розпізнавання. За потреби ви можете внести зміни до значень атрибутів 1, а потім вибрати Створити документ 2, щоб підтвердити збереження результату.

   

9. Якщо результат розпізнавання вам не підходить і ви не бажаєте його зберігати — просто закрийте вкладку.

Примітка:

Якщо ви завантажили одразу декілька файлів і встановили прапорець З попереднім переглядом, відкриється сторінка з такими деталями: загальний прогрес розпізнавання A, а також статус кожного окремого документа B.

Якщо під час розпізнавання виникли помилки, відповідні записи будуть додатково згруповані у вкладці Помилки 1 для зручного перегляду. У цій вкладці ви можете відкрити документ, який спричинив помилку 2, переглянути деталі помилки 3 та, за потреби, повторити спробу розпізнавання 4.

Після завершення процесу розпізнавання ви можете вибрати будь-який розпізнаний документ зі списку 1, за потреби відредагувати результат розпізнавання 2, а потім вибрати Створити документ 3, щоб підтвердити збереження результату.

Варіант 2: ви обрали Автоматично створити документ

10. Ви отримаєте сповіщення від платформи про початок процесу розпізнавання.

    

11. Якщо розпізнавання буде успішно завершено, ви отримаєте додаткове сповіщення. У тексті повідомлення виберіть Деталі, щоб переглянути результат розпізнавання, або Створений документ, щоб одразу відкрити створений документ.

    

    Ліворуч відображатиметься завантажений вами файл A, а праворуч його атрибути з розпізнаними даними B.

    

12. Виберіть Відкрити документ, якщо бажаєте переглянути створений документ та за потреби відредагувати значення атрибутів.

    

Примітка:

Якщо ви завантажили одразу декілька файлів, відкриється сторінка з такими деталями: загальний прогрес розпізнавання A, а також статус кожного окремого документа B.

Якщо під час розпізнавання виникли помилки, відповідні записи будуть додатково згруповані у вкладці Помилки 1 для зручного перегляду. У цій вкладці ви можете відкрити документ, який спричинив помилку 2, переглянути деталі помилки 3 та, за потреби, повторити спробу розпізнавання 4.

Після завершення процесу розпізнавання ви можете вибрати будь-який розпізнаний документ зі списку 1, а потім вибрати Відкрити документ 2, щоб переглянути створений документ та за потреби відредагувати значення атрибутів.

2.14.1.3. Переглянути статус розпізнавання

За допомогою ярлика Журнал розпізнавання ви можете переглянути статус розпізнавання окремих документів або цілих груп. Також ви можете відкрити форму розпізнавання кожного документа, щоб переглянути деталі.

Спосіб 1: для адміністратора

1. У панелі навігації, виберіть робочий стіл Студія 1.

2. Виберіть групу ярликів Центр ШІ 2, а потім групу ярликів Розпізнавання документів 3.

3. Виберіть ярлик Журнал розпізнавання 4.

   

4. Відфільтруйте результати таблиці по колонці Створено, щоб зверху таблиці побачити найновіші розпізнавання.

   

5. Виберіть потрібну групу (якщо ви завантажуєте одразу декілька файлів, вони обʼєднуються у групу) чи документ, статус розпізнавання яких бажаєте переглянути.

   

6. Ви побачите список файлів, які ви імпортували для розпізнавання. В колонці статус ви можете переглянути статус розпізнавання. Див. розділ Значення статусів.

   

Спосіб 2: для користувача

1. Перейдіть в ярлик, в якому виконували масове розпізнавання.

2. В правому верхньому куті виберіть піктограму 1.

3. Виберіть Журнал розпізнавання 2.

   

4. Відфільтруйте результати таблиці по колонці Створено, щоб зверху таблиці побачити найновіші розпізнавання.

   

5. Виберіть потрібну групу (якщо ви завантажуєте одразу декілька файлів, вони обʼєднуються у групу) чи документ, статус розпізнавання яких бажаєте переглянути.

   

6. Ви побачите список файлів, які ви імпортували для розпізнавання. В колонці статус ви можете переглянути статус розпізнавання. Див. розділ Значення статусів.

   

2.14.1.3.1. Значення статусів

• Нове — Це запит на розпізнавання, який стоїть в черзі.

---

• В обробці — система все ще в процесі розпізнавання даного файлу. Зачекайте, поки документ перейде в статус Успіх або Помилка.

---

• Успіх — система успішно розпізнала відповідний документ. Щоб переглянути створений документ, клацніть на запис, а потім у панелі інструментів виберіть Створений документ.

  

  Також ви можете переглянути додаткові деталі розпізнавання у вкладках:

  
  • Документ — містить атрибути розпізнаного документа.
  • [Назва таблиці] — якщо ваш документ містить табличні атрибути, то ви побачите окрему вкладку з назвою та вмістом даної таблиці.
  • Необроблений результат — це усі дані, які ШІ “побачив” у документі: як валідні, так і ті, що не відповідають атрибутам.
  • Витягнуті значення — це фільтрований результат, у якому залишаються лише ті поля, що збігаються із атрибутами типу документа. Тобто саме ці значення система використає для заповнення атрибутів у створеному документі.
  • Журнал обробки — містить помилки, що виникли під час валідації. Наприклад, якщо атрибут Ціна має обмеження ≤500, а у файлі вказано 600, система очистить це поле після розпізнавання. Аналогічно, якщо атрибут очікує дату, а у файлі інший формат, документ створиться з порожнім значенням цього атрибута.

---

• Помилка — система не змогла розпізнати документ, тому документ не було створено. Натисніть на статус, щоб в полі Деталі помилки дізнатись причину.

  

  Також ви можете вибрати кнопку Повторити спробу.

  

2.14.1.4. Налаштувати розрізання файлу

Функціонал Розрізання документа є допоміжним інструментом для підготовки великих багатосторінкових файлів до подальшого розпізнавання документів за допомогою ШІ.

Розрізання виконує дві ключові задачі:

• Готує документ до розпізнавання — система ділить вихідний файл на декілька окремих частин.
• Дозволяє ідентифікувати різні типи документів у складі одного набору сторінок.

---

Приклад:

1. Ви завантажуєте багатосторінковий документ (наприклад, PDF на 80 сторінок).
2. Платформа автоматично розрізає його на рівні частини. Це потрібно для оптимізації роботи LLM-моделі. Чим менші частинки документа ми передаємо в обробку, тим якісним є результат.
3. Підключена модель штучного інтелекту розпізнає кожну частину окремо, визначає тип вмісту та логічні межі документів.
4. На основі розпізнавання система формує окремі документи з чіткими межами, наприклад:
   • Сторінки 1–3 — Резюме
   • Сторінки 4–15 — Договір
   • Сторінки 16–18 — Акт

У результаті з одного великого набору сторінок система автоматично створює структурований набір документів відповідних типів, готових до подальшої роботи у платформі.

---

Щоб налаштувати розрізання, виконайте наступні етапи:

Примітка:

Перед початком налаштування розрізання переконайтесь, що налаштували розпізнавання ШІ.

1. Створіть бізнес-процес для розрізання.
2. Створіть шаблон розпізнавання для виклику процесу.
3. Створіть ярлик для розпізнавання.

2.14.1.4.1. Створити бізнес-процес для розрізання

1. Створіть дефініцію бізнес-процесу. Побудуйте процес, враховуючи ваші потреби. Такий процес може складатись з наступних етапів:

   1. A Розділення документа на рівні частини – це потрібно, щоб оптимізувати роботу моделі штучного інтелекту. Може бути реалізовано за допомогою завдання-сервісу (шаблон Викликати метод сутності). Приклад сценарію виклику з використанням методу split PDF:

      var startPage = execution.getVariable('startPage')
      
      JSON.stringify({
      entity: "dfx_AiExecution",
      method: "splitPDF",
      execParams: {
          ID: execution.getVariable('temp_aiExecutionID'),
          sourceEntity: "dfx_IdpJob",
          sourceID: execution.getVariable('$ID'),
          sourceAttribute: "sourceFile",
          pageRanges: JSON.stringify([[
          startPage ? startPage : 1,
          startPage ? startPage + 15 : 15, 
          ]])
      }
      })

      Метод splitPDF розрізає PDF-документ на один фрагмент із 15 сторінок, починаючи зі сторінки, записаної у змінній startPage. Якщо startPage не задано, береться діапазон 1–15. Цей метод підтримує гнучке задання сторінок для розрізання у вигляді масиву діапазонів і окремих сторінок. Ви можете використовувати такі формати:

      • Діапазон сторінок: [1,6] — сторінки з 1 по 6.
      • Окремі сторінки та діапазони: ['1,2,5-6'] — сторінки 1, 2, 5, 6.
      • Одна сторінка: [1,1] — лише сторінка 1.

   2. B Запуск системного сценарію ШІ для розрізання — штучний інтелект аналізує фрагмент, та розпізнає в ньому діапазони типів документів. Може бути реалізовано за допомогою завдання-сервісу (шаблон Виконання ШІ). У завданні може бути підключено системний сценарій для розрізання: sys_doc_splitter.

   3. C Щоб коректно перетворювати та передавати дані між цими етапами, застосовуйте завдання-сценарій.

   4. В завданні-сервіс (позначеному символом ) ви можете задати сценарій ШІ для розпізнавання.

      Приклад такого процесу:

      

2.14.1.4.2. Створити шаблон розпізнавання для виклику процесу

1. У панелі навігації виберіть робочий стіл Студія 1.

2. Виберіть групу ярликів Центр ШІ 2, а потім групу ярликів Розпізнавання документів 3.

3. Виберіть ярлик Шаблони розпізнавання 4, а потім у панелі інструментів виберіть + 5.

   

4. Заповніть поля, використовуючи підказки в таблиці нижче.

   

Поле	Опис
Код*	Код повинен бути унікальним. Код повинен бути коротким (зазвичай до 10 символів). Використовуйте тільки латинські букви та цифри.
Найменування*	Введіть назву шаблону.
Опис	За потреби, введіть короткий опис призначення шаблону.
Метод розпізнавання*	Виберіть варіант BPMN процес.
Дефініція процесу*	Виберіть зі списку дефініцію процесу, яку ви створили у попередньому розділі.
Версія*	Виберіть один з варіантів: Використовувати останню версію — завжди обирати останню розгорнуту версію дефініції. Використовувати вказану версію — при виборі цього варіанту виберіть потрібну версію в полі Вкажіть версію процесу.
Типи документів	Виберіть один із варіантів: Дозволити всі типи — тоді користувач зможе розпізнавати усі типи документів, до яких має доступ. Обрати типи — шаблон розпізнаватиме лише вказані типи документів. При виборі цього варіанту зʼявиться поле для вибору потрібних типів документів.
Кілька документів	Установіть прапорець.

5. У панелі інструментів виберіть піктограму Зберегти A або Зберегти та закрити B.

   

2.14.1.5. Запустити розрізання файлу

Примітка:

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

Виконайте всі кроки з розділу Розпізнати документ за допомогою ШІ.

Після запуску розпізнавання відобразиться секція з деталями виконання A, де показано кількість розрізаних, розпізнаних і пропущених сторінок. Нижче відображається список виявлених типів документів B.

У панелі Виявлено документів виберіть документ 1, щоб переглянути список атрибутів зі значеннями, які розпізнала LLM-модель 2. За потреби ви можете відредагувати значення атрибутів або ввести нові, якщо значення деяких атрибутів порожні. Щоб зберегти результати розпізнавання та розрізання, виберіть кнопку Створити документ 3. Повторіть цю дію для кожного виявленого документа.

Якщо під час розпізнавання виникли помилки, відповідні записи будуть додатково згруповані у вкладці Помилки 1 для зручного перегляду. У цій вкладці ви можете відкрити документ, який спричинив помилку 2, переглянути деталі помилки 3 та, за потреби, повторити спробу розпізнавання 4.

Якщо автоматичне розрізання некоректно визначило межі документів або пропустило сторінки, ви можете вручну задати діапазон сторінок для кожного документа.

2.14.1.5.1. Вручну задати межі діапазону сторінок

Примітка:

Дії, описані в цьому розділі, можуть виконувати лише користувачі з ролями Admin або Developer.

У деяких випадках автоматичне розрізання може виконуватися некоректно (наприклад, можуть бути неправильно визначені межі документів або пропущені сторінки). У такому випадку ви можете вручну додати відсутні частини без повторного запуску всього процесу розпізнавання.

Наприклад, у вас є файл на 4 сторінки, який система ідентифікувала як 4 окремі документи. Тобто 1 сторінка файлу = 1 документ у системі. Але насправді перші 2 сторінки належать одному документу, а інші 2 сторінки — іншому. У такому випадку ви можете вручну обʼєднати перші 2 сторінки в один документ, а інші 2 сторінки — в інший. Після цього видаліть документи з некоректними діапазонами сторінок, які раніше створила система.

---

Щоб вручну задати межі діапазону сторінок для документа:

1. Відкрийте форму розпізнавання документа, для якого потрібно змінити діапазон сторінок.

2. На формі розпізнавання в секції Виявлено документів клацніть правою кнопкою миші на документ 1, для якого потрібно вручну задати межі діапазону сторінок.

3. У контекстному меню виберіть Створити документ з діапазону 2.

   

4. У полі Сторінки для розпізнавання введіть діапазон сторінок, який потрібно створити.

   

5. Необовʼязково: у полі Шаблон розпізнавання 1 виберіть інший шаблон розпізнавання, який буде застосовано до цього діапазону сторінок.

6. Необовʼязково: змініть значення прапорця Автоматично створити документ 2. Якщо прапорець встановлений, документ буде створено одразу після завершення розпізнавання. Якщо не встановлений — після завершення розпізнавання документ не буде створено, і ви зможете переглянути результат та вручну підтвердити створення документа.

   

7. Виберіть Створити завдання.

   

У секції Виявлено документів зʼявиться новий документ із вказаним діапазоном сторінок.

Щоб видалити документ із некоректним діапазоном сторінок, який система створила раніше, клацніть правою кнопкою миші на цей документ 1, а потім виберіть Видалити 2.

2.14.1.6. Масові дії в ярлику "Журнал розпізнавання"

За допомогою системного ярлика Журнал розпізнавання адміністратор може переглядати статус розпізнавання, а також виконувати дії одразу для кількох записів виконання. Для цього використовується режим множинного вибору. Наприклад, замість того щоб скасовувати кілька розпізнавань по одному, ви можете вибрати кілька записів у журналі та застосувати потрібну дію одночасно до всіх вибраних записів.

Для масової обробки доступні такі дії:

• Скасувати — зупинити розпізнавання. Скасоване розпізнавання можна перезапустити пізніше за потреби. Ця дія доступна для розпізнавань зі статусом В обробці.

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

• Видалити — повністю видалити запис розпізнавання з журналу. Після видалення відновити запис неможливо.

• Створити документ — створити документ у системі на основі результатів виконаного розпізнавання. Ця дія доступна для розпізнавань зі статусом Успіх. Якщо розпізнавання є груповим і його статус Завершено з помилками, Скасовано або Зависання, але принаймні одне з вкладених розпізнавань виконано успішно, створити документ з такого запису в гріді неможливо. У такому разі документ можна створити з форми розпізнавання.

---

Щоб виконати масові дії в ярлику Журнал розпізнавання:

1. У панелі навігації виберіть робочий стіл Студія 1.

2. Виберіть групу ярликів Центр ШІ 2, а потім групу ярликів Розпізнавання документів 3.

3. Виберіть ярлик Журнал розпізнавання 4.

   

4. Увімкніть режим Множинний вибір та встановіть прапорці біля потрібних записів розпізнавання 1.

5. Клацніть правою кнопкою миші та в контекстному меню виберіть потрібну дію 2.

   

Для дій Скасувати, Перезапустити, Створити документ відкриється таблиця, у якій відображатимуться вибрані записи A та кнопка для підтвердження дії B.

Примітка:

Якщо вибраний запис не підтримує обрану дію, для нього буде відображено статус Не застосовується. Це може траплятися, наприклад, якщо ви намагаєтеся скасувати розпізнавання, яке ще не було запущене.