Это руководство объясняет, как автоматически категоризировать темы с помощью функции AI-триажа в плагине Discourse AI в сочетании с Discourse Automation.
Требуемый уровень пользователя: Администратор
Автоматическая категоризация тем с помощью ИИ
Эта автоматизация использует LLM для чтения содержимого темы, определяет, подходит ли выбранная категория, и обновляет её, если агент ИИ считает, что другая категория лучше соответствует теме.
Предварительные требования
- Должны быть включены плагины Discourse AI и Discourse Automation.
- Должен быть настроен как минимум один LLM. См. руководство по настройке LLM для получения инструкций по настройке.
- Должен быть настроен Агент с подходящим системным промптом.
Примеры конфигураций Агента
- Системный промпт:
Вы — эксперт по классификации контента на этом форуме.
Ваша задача — анализировать сообщения и предлагать подходящую категорию на основе содержания, изображений и списка доступных категорий.
Рекомендации:
- Будьте консервативны — категоризируйте только то, в чём вы уверены
- Учитывайте как тему содержания, так и намерение поста
- Модель языка по умолчанию: Выберите LLM, настроенный в разделе «Предварительные требования».
Клиенты, размещённые на платформе Discourse, могут выбрать CDCK Hosted Small LLM при настройке агентов ИИ. - Включённые инструменты: Read, Categories, Edit Categories
- Принудительные инструменты: Read, Categories
- Стратегия принудительных инструментов: Применять только к первому ответу
- Режим выполнения: По умолчанию (фиксированные ограничения)
- (Опционально) Включите опцию «Требовать одобрение для инструментов модерации»
- Пользователь: Создать пользователя
Конфигурация автоматизации
- Перейдите в раздел Администрирование → Плагины → Автоматизации.
- Нажмите + Добавить автоматизацию.
- Выберите скрипт Триаж сообщений с помощью агента ИИ.
- Настройте параметры в разделах «Когда/Что» по своему усмотрению.
- В разделе «Параметры скрипта» выберите Агента, определённого для этой автоматизации, в настройке
AI Agent. - Включите настройку
Режим без уведомлений. - Нажмите кнопку «Обновить автоматизацию».
- Включите автоматизацию.
Лучшие практики
- Начинайте с узкой области применения: Применяйте автоматизацию только к конкретной категории или к первым сообщениям новых пользователей (уровень доверия 0 или 1) перед расширением. Это ограничивает затраты на LLM и снижает риск массовой неправильной категоризации.
- Пишите чёткие описания категорий в своём промпте: Чем точнее вы опишете смысл каждой категории, тем надёжнее LLM будет выполнять классификацию.
- Следите за ложными срабатываниями и пропусками: LLM не будет точной на 100%. Создайте процесс для проверки и исправления неправильно категоризированных тем и со временем корректируйте свой промпт.
- Сохраняйте разумные лимиты токенов: Настройка «Макс. токенов поста» ограничивает объём поста, отправляемого в LLM. Для большинства задач автоматической категоризации достаточно первых нескольких сотен токенов (начало поста).
Распространённые проблемы и решения
- Автоматизация не применяет подходящую категорию
Проверьте настройки безопасности категории. Если категория, которую нужно применить, является приватной, убедитесь, что в настройках Агента включена опция инструментаЧтение приватных категорий. - Автоматизация запускается, но не категоризирует темы
Проверьте логи сайта, чтобы выявить любые ошибки, связанные с плагинами Discourse AI или Discourse Automation.