Ассистенты и лимиты
Ассистент — это связка промпта, лимитов и (опционально) инструментов. Каждый ассистент получает собственные ключи доступа и работает независимо от остальных.
Из чего состоит ассистент
| Поле | Что это |
|---|---|
| Промпт | Системная инструкция — определяет характер и поведение ассистента |
| Формат ответа | Текст — обычный ответ; JSON — ассистент отвечает строго валидным JSON (полезно для встраивания в свой UI без парсинга произвольного текста) |
| Режим сбора данных | Full/Minimal/None — см. ниже |
| Лимиты | Ограничения на частоту и объём сообщений — см. ниже |
Лимиты
| Лимит | Смысл | Дефолт |
|---|---|---|
maxMessagesPerChat | Сколько сообщений максимум может быть в одном чате. При достижении — ошибка LimitExceeded, нужно начинать новый чат | 200 |
maxMessageLength | Максимальная длина одного сообщения пользователя в символах | 8000 |
requestsPerMinute | Общий бюджет запросов в минуту на ассистента — распределяется между всеми посетителями сразу, это не персональный лимит на одного человека. 0 — без лимита | 60 |
maxRequestsPerDay | Задел на будущее: поле сохраняется и валидируется, но пока не применяется бэкендом — сообщения не будут блокироваться по этому лимиту | 0 (без лимита) |
allowGuestChats | Разрешить ли гостевые (pk_) чаты — без него hosted-ссылка и публичный ключ работать не будут, отправка сообщения вернёт 403 | true |
Частая ошибка: если посетители жалуются на «слишком много запросов» (
429) при небольшой посещаемости — проверьтеrequestsPerMinute: это лимит на всех сразу, а не на одного человека, и высокая одновременная нагрузка от разных посетителей исчерпывает его быстрее, чем кажется.
Режим сбора данных (dataCollection)
Определяет, что сохраняется о посетителе чата вместе с каждым сообщением.
| Режим | Что сохраняется |
|---|---|
Full | IP, X-Forwarded-For, User-Agent, fingerprint, URL страницы, referrer — максимум для аналитики и персонализации |
Minimal | Только необходимое для работы чата. PII покупателя (имя, email, телефон), даже если передано в запросе, не сохраняется — остаётся только externalId |
None | Аналогично Minimal по составу, но с намерением собирать как можно меньше |
IP-адрес сохраняется всегда, независимо от режима — это нужно для защиты от злоупотреблений (rate-limiting, блокировка абьюзеров) и не отключается настройкой.
Если у ассистента режим не задан явно — используется defaultDataCollectionMode вашего аккаунта
(раздел «Настройки»).
Тариф и провайдер модели
У ассистента нет отдельной настройки «провайдер модели» — какая модель и провайдер обрабатывают запросы, определяет тариф, привязанный к ассистенту (вкладка «Тариф» на странице ассистента). Вы выбираете тариф по цене и лимитам из каталога доступных вам тарифов (публичных — видны всем, приватных — если администратор выдал доступ), а не модель напрямую. Тариф может использовать резервного провайдера при сбоях основного — это происходит автоматически, без вашего участия.
Если тариф не выбран явно, действует иерархия: тариф промпта → тариф ассистента → тариф вашего аккаунта → платформенный тариф по умолчанию. Посмотреть, какой тариф сейчас применяется, можно на той же вкладке «Тариф».