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

# Настройка агента и версии

> Заполните настройки агента, проверьте черновик и восстановите нужную версию.

# Настройка агента и версии

Откройте нужного агента в **Автоматизации → Агенты**. Основные параметры находятся на одной странице. Изменения образуют черновик и сохраняются автоматически; кнопка **Опубликовать** создаёт отдельную рабочую версию.

## Основные поля

| Поле                        | Что указывать                                       | Ограничение                         |
| --------------------------- | --------------------------------------------------- | ----------------------------------- |
| **Название**                | Понятное имя для списка агентов                     | до 120 символов                     |
| **Короткое описание**       | Одно предложение о назначении                       | до 280 символов                     |
| **Инструкции**              | Роль, правила ответа, допустимые действия и запреты | до 32 000 символов                  |
| **Модель**                  | Совместимую модель из списка                        | доступность проверяется при запуске |
| **Подключённые приложения** | Только то, что нужно для задачи                     | подключение задаётся отдельно       |

Для ответа «в обработке заказа» можно написать: «Используй только сведения из подключённого источника. Не обещай срок, если его нет. В конце предложи уточнить номер заказа». Так правило остаётся проверяемым, а ответ не выглядит как шаблонная гарантия.

## Дополнительные параметры

Раскройте **Дополнительно**, когда обычных инструкций недостаточно.

| Параметр                       | Когда менять                                            | Диапазон       |
| ------------------------------ | ------------------------------------------------------- | -------------- |
| **Формат ответа**              | Выберите JSON, только если получатель ожидает структуру | текст или JSON |
| **Лимит стоимости запуска, ₽** | Ограничьте расход одного запуска                        | шаг 0,01 ₽     |
| **Разнообразие ответов**       | Уменьшите для строгих формулировок                      | от 0 до 2      |
| **Максимум токенов ответа**    | Сократите для коротких ответов                          | от 1 до 32 768 |
| **Максимум шагов**             | Ограничьте сложную задачу                               | от 1 до 64     |
| **Время запуска, секунд**      | Дайте время ожиданию внешнего действия                  | от 10 до 3 600 |

Начните с небольшого лимита, короткого ответа и малого числа шагов. Это облегчает проверку ошибки и не превращает тест в долгий запуск.

## Версии и восстановление

В **Дополнительном разделе** выберите **Версии**. Здесь видны сохранённые и опубликованные снимки. Если рабочий вариант оказался хуже, нажмите **Восстановить в черновик** у нужной версии. Затем проверьте восстановленный черновик и нажмите **Опубликовать**, чтобы он стал новой рабочей версией. Восстановление не меняет уже начатые запуски.

## Типичные ошибки

* JSON выбран, но агент отвечает обычным текстом: верните текстовый формат или уточните в инструкциях ожидаемую структуру.
* Лимит слишком мал: сократите задачу или скорректируйте лимит.
* Нужна предыдущая настройка: восстановите её в черновик, проверьте и опубликуйте.

Дальше: [создание, импорт и клон](/agents/templates-generator), [проверка черновика](/agents/chat-traces-retry).