ИИ-агент (маркетолог)

Модуль ТЗ: 5.10 · ИИ-агент

Что это

ИИ-агент — «маркетолог» для рекламы на Wildberries. Вы ставите задачу обычными словами («снизь расход по этому товару», «настрой рекламу»), а агент понимает её, предлагает конкретный план действий на реальных показателях вашего товара и — только после вашего подтверждения — применяет безопасные изменения в автобиддере. Всё, что агент сделал, остаётся в истории, а созданное можно откатить.

Как это работает: четыре шага

Шаг	Что происходит	Страница
Приём задачи	Агент распознаёт, что вы хотите, и вытаскивает параметры; при неясности задаёт уточняющий вопрос	Приём задач
План действий	Агент смотрит реальные метрики рекламы (показы, расход, ДРР, заказы) и предлагает действия с обоснованием	План действий
Выполнение	После подтверждения применяются допустимые действия; опасные значения отклоняются	Выполнение действий
История	Журнал действий агента с результатами	История действий

Что агент может предложить и сделать

Действие	Что означает
Создать стратегию управления ставками	Новая стратегия автобиддера с целевым значением, например ДРР
Изменить ставки	Корректировка ставок на заданный процент
Задать лимит бюджета	Дневной лимит расхода по кампании
Остановить автоуправление кампанией	Агент отключает автобиддер кампании; откат включает его обратно

Как пользоваться

1. Выберите кабинет WB и опишите задачу в разделе «ИИ-агент».
2. Проверьте, как агент понял задачу, и получите план с обоснованием.
3. Планы, ожидающие решения, собираются в очереди подтверждений: подтвердите или отклоните каждый. Решение принимается один раз.
4. Следите за результатом в истории; при необходимости запустите откат.

Ограничения

• Без подтверждения ничего не выполняется. Агент только предлагает.
• Защитные границы. Значения вне допустимых диапазонов (например, изменение ставок более чем на 50 % за раз, дневной бюджет вне диапазона 1–1 000 000 ₽) отклоняются и не применяются.
• Ставки и бюджеты меняются инструментами автобиддера внутри «Оптимы»; агент не «обходит» правила модуля и не выполняет действий, для которых нет безопасной операции.
• Качество плана зависит от данных: если по товару за период нет показателей, агент это отметит и предложит общий план.
• Если сервис нейросети недоступен, «Оптима» сообщит об этом — повторите позже. На запросы к нейросети действуют лимиты: не более 30 запросов в час с одного адреса и суточный лимит объёма на пользователя.
• В истории видны только ваши действия.

Связанные страницы

• Автобиддер, Стратегии ставок
• Журнал аудита
• ИИ-помощник

Для интеграторов

• Эндпоинты /ai-agent/…: tasks/parse, tasks/plan, actions/execute, actions/rollback, actions/history, approvals (+ approvals/{id}/approve|reject). Контракт — в Swagger.
• Подтверждения хранятся в БД (ADR-0061): решение однократно, повторное — 409; доступ по кабинету.
• Выполнение пишет записи аудита ai-agent.action.* с metadata.wbAccountId; история строится по ним.
• Архитектура ИИ-слоя — ИИ-подсистема. Код — backend/src/modules/ai-agent, Compodoc.