> ## 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.
# Генерация с помощью ИИ
> Используйте модели ИИ для создания текста или структурированных данных в рабочем процессе
Мы настоятельно рекомендуем создавать Автоматизации с помощью действия «Запустить скрипт», поскольку оно поддерживает все варианты поведения действий, включая те, которые иначе пришлось бы создавать вручную. Просто опишите свои требования ИИ в чате.
Обратите внимание: если вы добавите действия вручную, ИИ не сможет распознать или изменить их позднее.
## Создание с помощью ИИ
Откройте ИИ-чат на правой боковой панели Таблицы и опишите, что вам нужно.
ИИ сделает всё сам: выберет подходящий триггер и нужные действия, сопоставит Поля и автоматически настроит весь рабочий процесс.
Достаточно один раз описать цель — и рабочий процесс будет готов без ручной настройки.
Отправляет запрос большой языковой модели и возвращает текст или структурированный 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 Corp",
"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), делайте запросы краткими, чтобы снизить расход токенов и кредитов.
* Подключите дополнительных поставщиков ИИ в разделе **Пространство → Настройки → Настройки ИИ**, если модели по умолчанию вам не подходят. Подробнее см. в разделе [Пользовательские модели ИИ](/ru/basic/ai/custom-model).
Подключите сторонние модели ИИ в разделе **Пространство → Настройки → Настройки ИИ**.
## Связанные материалы
* [Цикл (пакетная обработка)](../logic/loop-run) — обработка нескольких Записей с помощью ИИ за один запуск Автоматизации
* [Запустить скрипт](/ru/basic/automation/ai/scripting/runscript) — пользовательская логика, выходящая за рамки генерации по запросу
* [Отправить письмо](/ru/basic/automation/actions/communication/send-email-overview)
* [Обновить Запись](/ru/basic/automation/actions/records/update-record)