> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Генерування за допомогою ШІ

> Використовуйте моделі ШІ для створення тексту або структурованих даних у робочому процесі

<Tip>
  Наполегливо рекомендуємо створювати автоматизації за допомогою дії «Запуск сценарію», оскільки вона охоплює всі типи дій, зокрема ті, які інакше довелося б створювати вручну. Просто опишіть свої вимоги ШІ в чаті.

  Зверніть увагу: якщо ви додасте дії вручну, ШІ надалі не розпізнаватиме й не змінюватиме їх.
</Tip>

## Створення за допомогою ШІ

Відкрийте AI Chat на правій бічній панелі таблиці й опишіть бажаний результат.

ШІ зробить усе: вибере правильний тригер і відповідні дії, зіставить поля й автоматично налаштує весь робочий процес.

Достатньо один раз описати мету — і робочий процес готовий без ручного налаштування.

Надсилає запит великій мовній моделі й повертає текст або структурований JSON. Використовуйте цю дію, щоб класифікувати, видобувати, узагальнювати або генерувати дані на основі записів.

## Налаштування

| Параметр       | Обов’язковий | Опис                                                                                                                        |
| -------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| Запит          | Так          | Ваша інструкція для ШІ. Натисніть **+**, щоб вставити динамічні змінні з попередніх кроків                                  |
| Модель         | Ні           | Виберіть модель. Стандартно використовується системна модель. Також доступні моделі з підтримкою зору й міркування          |
| Температура    | Ні           | Керує випадковістю: 0 = найдетермінованіший результат, 1 = найтворчіший. Стандартне значення зазвичай становить близько 0,7 |
| Тип результату | Ні           | **Текст** (стандартно) — повертає текст довільної форми. **JSON** — повертає структурований JSON за визначеною вами схемою  |
| Вкладення      | Ні           | Завантажуйте зображення, PDF, документи Word або файли Excel. Потрібна модель із підтримкою зору                            |

## Можливості моделей

| Тег            | Значення                                                                                            |
| -------------- | --------------------------------------------------------------------------------------------------- |
| **Зір**        | Може читати й аналізувати зображення, PDF, документи Word і файли Excel, додані до запиту           |
| **Міркування** | Повертає відповідь і покрокове обґрунтування (ланцюжок міркувань), що корисно для складного аналізу |

Сторонні моделі ШІ можна підключити через **Простір → Налаштування → Інтеграції**. Це дає змогу використовувати моделі OpenAI, Anthropic, Google та інших постачальників.

## Як налаштувати

1. Додайте до робочого процесу дію **Генерування за допомогою ШІ**.
2. Напишіть **Запит**. Це інструкція, якої дотримуватиметься ШІ. Натисніть **+**, щоб вставити динамічні значення — наприклад, текст звернення до служби підтримки, вміст надісланої форми або опис продукту.
3. (Необов’язково) Виберіть **Модель**, якщо хочете використовувати певну модель замість стандартної.
4. (Необов’язково) Налаштуйте **Температуру**. Нижчі значення (0–0,3) дають послідовніші й передбачуваніші результати. Вищі значення (0,7–1,0) — різноманітніші й творчіші.
5. (Необов’язково) Змініть **Тип результату** на **JSON**, якщо потрібні структуровані дані. Визначте схему JSON, щоб ШІ знав, у якому форматі повертати результат.
6. (Необов’язково) Додайте **Вкладення**, якщо ШІ має читати документи або зображення (потрібна модель із підтримкою зору).
7. Збережіть дію. Відповідь ШІ буде доступна наступним крокам через засіб вибору змінних **+**.

## Поради зі складання запитів

Якість результату ШІ значною мірою залежить від вашого запиту. Ось практичні рекомендації:

* **Будьте конкретними.** Замість «Класифікуй це» напишіть «Класифікуй це звернення до служби підтримки за однією з категорій: Оплата, Технічна проблема, Обліковий запис, Інше».
* **Наводьте в запиті приклади.** Покажіть ШІ очікуваний результат:
  ```
  Класифікуй наведене нижче звернення до служби підтримки. Поверни лише назву категорії.

  Категорії: Оплата, Технічна проблема, Обліковий запис, Інше

  Приклади:
  - "Я не можу ввійти у свій обліковий запис" → Обліковий запис
  - "У моєму рахунку неправильна сума" → Оплата
  - "API повертає помилку 500" → Технічна проблема

  Звернення: {{Ticket Description}}
  ```
* **Визначте формат результату.** Якщо потрібен певний формат, укажіть це: «Поверни лише назву категорії й нічого більше» або «Поверни об’єкт JSON із ключами: category, confidence, reason».
* **Зосередьтеся на одному завданні.** Один запит на одне завдання працює краще, ніж прохання до ШІ виконати кілька завдань одночасно.

## Результат JSON

Якщо для параметра «Тип результату» вибрати **JSON**, ШІ повертає структуровані дані замість довільного тексту. Це корисно, коли потрібно видобути кілька фрагментів інформації та окремо використати їх у наступних кроках.

Приклад запиту для результату JSON:

```
Видобудь наведену нижче інформацію з цього електронного листа з рахунком. Поверни JSON із такими ключами:
- vendor_name (рядок)
- invoice_number (рядок)
- amount (число)
- due_date (рядок у форматі YYYY-MM-DD)

Текст листа: {{Email Body}}
```

ШІ поверне приблизно такий результат:

```json theme={null}
{
  "vendor_name": "Компанія Acme",
  "invoice_number": "INV-2024-001",
  "amount": 1250.00,
  "due_date": "2024-03-15"
}
```

Після цього кожен ключ JSON доступний наступним крокам як окрема змінна, тож можна зіставити `vendor_name` з одним полем, `amount` — з іншим тощо.

## Моделі з підтримкою зору та вкладення

Моделі з підтримкою зору можуть аналізувати зображення й документи. Додайте файли до запиту, і ШІ «прочитає» їх:

* **Зображення:** знімки екрана, фотографії, діаграми, графіки.
* **PDF:** рахунки, договори, звіти.
* **Файли Word / Excel:** документи й електронні таблиці.

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

Обов’язково виберіть модель із тегом **Зір**. Моделі без підтримки зору ігноруватимуть вкладення.

## Система кредитів

Кожен виклик дії «Генерування за допомогою ШІ» витрачає кредити залежно від:

* Використаної **моделі** (потужніші моделі коштують більше кредитів за токен).
* **Кількості токенів**, що обробляються (вхідних і вихідних).

Точну вартість у кредитах показано на панелі тестування після тестового запуску. Стежте за використанням кредитів у налаштуваннях облікового запису, особливо якщо дія «Генерування за допомогою ШІ» виконується в циклі для багатьох записів.

## Конкретні приклади запитів

### Класифікація

```
Класифікуй цей відгук клієнта як позитивний, негативний або нейтральний.
Поверни лише результат класифікації.

Відгук: {{Feedback Text}}
```

### Видобування даних

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

Текст: {{Message Body}}
```

### Узагальнення

```
Узагальни наведені нижче нотатки зустрічі трьома пунктами.
Зосередься на завданнях і прийнятих рішеннях.

Нотатки: {{Meeting Notes}}
```

### Створення вмісту

```
Напиши професійного листа для продовження спілкування з {{Customer Name}} щодо запиту про {{Product Name}}.
Обсяг не має перевищувати 150 слів. Згадай, що ми відповімо протягом 24 годин.
```

### Переклад

```
Переклади наведений нижче текст із {{Source Language}} на {{Target Language}}.
Збережи початкове форматування.

Текст: {{Content}}
```

## Коли використовувати

* **Класифікація звернень до служби підтримки за темою.** Автоматично розподіляйте вхідні звернення за категоріями, щоб спрямовувати їх відповідній команді.
* **Видобування структурованих даних із рахунків або листів.** Розподіляйте суми, дати, імена й номери посилань в окремі поля.
* **Узагальнення довгих текстових полів.** Перетворюйте нотатки зустрічей, описи або коментарі на короткі резюме.
* **Створення персоналізованого вмісту листів.** Створюйте власний текст листа на основі даних запису.
* **Аналіз зображень і документів.** Використовуйте моделі з підтримкою зору для читання завантажених рахунків, квитанцій або знімків екрана.

## Поради

* Використовуйте **панель тестування**, щоб удосконалити запит перед активацією автоматизації. Виконуйте тести з реальними даними, щоб перевірити формат і якість результату.
* Для послідовних результатів (особливо під час класифікації) задайте для температури значення 0 або близьке до 0.
* Режим результату JSON надійніший, якщо в запиті наведено чітку схему. Завжди перелічуйте очікувані ключі та їхні типи.
* Якщо ви обробляєте багато записів у [Циклі](../logic/loop-run), робіть запити стислими, щоб зменшити використання токенів і витрати кредитів.
* Підключайте додаткових постачальників ШІ через **Простір → Налаштування → Налаштування ШІ**, якщо стандартні моделі не відповідають вашим потребам. Докладніше див. у розділі [Власні моделі ШІ](/uk/basic/ai/custom-model).

<Tip>Підключайте сторонні моделі ШІ через **Простір → Налаштування → Налаштування ШІ**.</Tip>

## Пов’язані матеріали

* [Цикл (пакетна обробка)](../logic/loop-run) — обробка кількох записів за допомогою ШІ за один запуск автоматизації
* [Запуск сценарію](/uk/basic/automation/ai/scripting/runscript) — власна логіка, що виходить за межі генерування на основі запитів
* [Надсилання електронного листа](/uk/basic/automation/actions/communication/send-email-overview)
* [Оновлення запису](/uk/basic/automation/actions/records/update-record)