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

Для чего нужен раздел

Раздел "Настройки агента" позволяет настроить все аспекты работы созданного агента — от базовых параметров и подключения платформ до тонкой настройки поведения ИИ, лимитов использования и монетизации.

Как попасть в раздел

• Через список агентов: Кликните на иконку настроек (⚙️) на карточке агента
• Через дашборд агента: Кнопка "Settings" в правом верхнем углу
• Прямая ссылка: /agents/:id/settings
• Необходимые права: Владелец агента или администратор организации

General settings (Основные настройки)

Базовая информация агента

Название агента (Name)

• Обязательное поле
• Отображается пользователям в чате
• Можно изменить в любое время
• Не влияет на URL или идентификатор агента

Тип видимости (Visibility)

• Private — доступен только вам по прямой ссылке
• Corporate — доступен всем сотрудникам вашей организации
• Public — виден всем пользователям в каталоге агентов

Требуемый план подписки (Required subscription Plan)

• Доступно только для публичных агентов
• Ограничивает доступность по типу подписки пользователя
• Варианты: Anonim, Free, Premium, Pro, Enterprise

Язык агента (Language)

• Основной язык общения агента
• Влияет на качество ответов
• Можно выбрать из предустановленного списка

Иконка агента (Icon)

• URL изображения или код иконки из библиотеки Iconify
• Примеры Iconify: mdi:robot, heroicons:chat-bubble-left
• Отображается в списке агентов и при общении

Настройка платформ

Агент может работать на различных платформах одновременно:

Web-платформа

• Всегда включена — нельзя отключить
• Не требует дополнительной настройки
• Основной способ доступа к агенту

Telegram-платформа

• Опционально — можно включать/отключать
• Требует добавления токена бота для активации
• После добавления токена webhook настраивается автоматически

Добавление Telegram-бота:

1. Получите токен от @BotFather
2. В карточке Telegram-платформы нажмите "Add Token"
3. Вставьте полученный токен
4. Система автоматически настроит webhook и активирует бота

Удаление Telegram-бота:

1. Нажмите "Remove Token" в карточке платформы
2. Токен будет удален, платформа отключена
3. Бот перестанет отвечать на сообщения

Опасная зона (Danger Zone)

В нижней части страницы находится кнопка удаления агента:

• Необратимое действие — восстановление невозможно
• Удаляются все данные: настройки, история чатов, аналитика
• Агент становится недоступен на всех платформах

AI settings (Настройки ИИ)

Выбор типа агента

Первый шаг — выбор типа агента из каталога:

Интерфейс выбора

• Текущий тип показывает активную конфигурацию с версией и статусом
• "Change agent type" — открывает каталог доступных типов
• "Change version" — выбор другой версии текущего типа
• "More info" — подробная информация о типе агента

Каталог типов агентов

• Отображаются стабильные версии агентов
• Каждый тип оптимизирован под конкретные задачи
• Показывается количество доступных версий
• Возможность выбрать конкретную версию

Статусы версий

• Stable (зеленый) — рекомендованная стабильная версия
• Beta (желтый) — тестовая версия с новыми функциями
• Development (синий) — версия в разработке
• Deprecated (красный) — устаревшая версия, требует обновления

Настройки графа (Graph Settings)

После выбора типа агента доступны специфичные настройки:

Динамические поля

• Набор полей зависит от выбранного типа агента
• Автоматически загружаются с сервера
• Включают различные типы полей: текст, числа, выбор, объекты

Типичные настройки

• Модель ИИ — выбор языковой модели
• Системный промпт — инструкции для поведения агента
• Температура — уровень креативности ответов (0.0-1.0)
• Максимальная длина ответа — лимит токенов
• Контекстное окно — размер памяти агента

Автосохранение

• Изменения сохраняются автоматически через 500мс
• Нет необходимости нажимать кнопку "Сохранить"
• Индикатор загрузки при смене типа агента

Limits (Лимиты)

Система лимитов позволяет контролировать использование агента на двух уровнях:

Общие лимиты (General Limits)

Период учета (Usage Period)

• Ежедневно — лимиты сбрасываются каждые 24 часа
• Еженедельно — сбрасываются каждую неделю
• Ежемесячно — сбрасываются каждый месяц

Основные ограничения

• Максимум сообщений за период — общее количество сообщений
• Максимум токенов за период — суммарное потребление токенов
• Максимум одновременных пользователей — параллельные сессии

Лимиты по правилам (Rule-Based Limits)

Позволяют настроить индивидуальные ограничения для разных категорий пользователей:

Создание правила

1. Нажмите "Add Rule"
2. Настройте условия соответствия (Match Conditions):
   • Тип пользователя — Anonymous, Registered, Corporate
   • План подписки — Free, Premium, Pro, Enterprise
   • Подписка на агента — Subscribed/Not Subscribed
3. Установите лимиты:
   • Приоритет правила — порядок применения (выше = раньше)
   • Сообщений в день — лимит сообщений
   • Токенов в день — лимит токенов

Управление правилами

• Таблица правил показывает все настроенные ограничения
• Редактирование — изменение существующих правил
• Удаление — полное удаление правила
• Автосортировка по приоритету

Настройки по умолчанию

• Применяются когда пользователь не попал ни под одно правило
• Сообщений в день по умолчанию — базовый лимит
• Токенов в день по умолчанию — базовый лимит токенов

Принцип работы лимитов

1. Система проверяет правила по порядку приоритета
2. Применяется первое подходящее правило
3. Если правил нет — используются настройки по умолчанию
4. Общие лимиты проверяются дополнительно к правилам

Monetization (Монетизация)

Статус: Новая функция (бейдж "new")

Основные настройки

Требование подписки

• Переключатель — включить/выключить платный доступ
• Доступно бесплатно — агент доступен всем пользователям
• Требуется подписка — пользователи должны оплатить доступ

Настройки подписки

При включении платного режима доступны:

Ценообразование

• Месячная цена — стоимость подписки на месяц
• Пробный период — количество дней бесплатного доступа (0-365)

Важные ограничения

• Функция находится в разработке
• Не все возможности могут работать корректно
• Рекомендуется тестировать перед запуском

Info (Информация)

Секция для настройки описательной информации агента:

Базовая информация

Приветственное сообщение (Welcome message)

• Первое сообщение, которое видит пользователь
• Многострочное текстовое поле
• Задает тон общения с агентом

Заголовок (Headline)

• Краткое описание возможностей агента
• Отображается в каталоге и карточке агента
• Многострочное поле для детального описания

Описание (Description)

• Подробное описание функций агента
• Помогает пользователям понять назначение
• Используется в публичном каталоге

Управление сценариями использования

Дополнительный компонент для настройки примеров использования агента (детали зависят от конкретной реализации).

Частые сценарии использования

Сценарий 1: Настройка Telegram-бота

1. Перейдите в "General settings"
2. В секции "Platforms" найдите карточку Telegram
3. Нажмите "Add Token"
4. Вставьте токен от @BotFather
5. Дождитесь автоматической настройки webhook
6. Протестируйте бота, отправив сообщение

Сценарий 2: Изменение модели ИИ

1. Откройте вкладку "AI settings"
2. Нажмите "Change agent type" если нужен другой тип
3. Или нажмите "Change version" для смены версии
4. Выберите подходящую конфигурацию
5. Настройте специфичные параметры в появившейся форме
6. Изменения сохранятся автоматически

Сценарий 3: Настройка лимитов для разных пользователей

1. Перейдите в секцию "Limits"
2. В разделе "Rule-Based Limits" нажмите "Add Rule"
3. Настройте условия: например, "Premium пользователи"
4. Установите повышенные лимиты
5. Создайте правило для Free пользователей с базовыми лимитами
6. Настройте значения по умолчанию для остальных

Сценарий 4: Включение монетизации

1. Перейдите в "Monetization"
2. Включите переключатель "Subscription Required"
3. Укажите месячную стоимость
4. Установите пробный период (рекомендуется 7-14 дней)
5. Проверьте как изменился доступ к агенту

Важные ограничения

• Web-платформа всегда включена — нельзя отключить
• Удаление агента необратимо — восстановление невозможно
• Некоторые настройки ИИ зависят от выбранного типа агента
• Монетизация в разработке — может работать нестабильно
• Правила лимитов применяются по приоритету (первое совпадение)

Частые проблемы и решения

Проблема: Telegram-бот не отвечает после добавления токена

Решения:

1. Убедитесь, что токен корректный (должен быть от @BotFather)
2. Проверьте, что веб-хук настроился (появится уведомление)
3. Попробуйте отправить команду /start боту
4. Если не помогает — удалите и добавьте токен заново

Проблема: Настройки ИИ не загружаются

Решения:

1. Обновите страницу — возможна временная недоступность API
2. Попробуйте выбрать другой тип агента
3. Проверьте подключение к интернету
4. Если проблема сохраняется — выберите базовую модель

Проблема: Изменения не сохраняются

Решения:

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

Проблема: Лимиты не работают как ожидается

Решения:

1. Проверьте приоритеты правил — первое совпадение применяется
2. Убедитесь, что условия правил корректны
3. Проверьте настройки по умолчанию
4. Помните: общие лимиты действуют дополнительно к правилам

Проблема: Монетизация не активируется

Решения:

1. Функция в разработке — могут быть сбои
2. Убедитесь, что указана корректная цена
3. Проверьте настройки агента в секции "General"
4. Пока рекомендуется использовать только для тестирования

Что дальше?

После настройки агента рекомендуется:

1. Протестировать агента — проверить работу на всех платформах
2. Настроить аналитику — отслеживать использование и эффективность
3. Создать базу знаний — если агенту нужна специфическая информация
4. Настроить интеграции — подключить дополнительные сервисы