Это руководство объясняет, как автоматически помечать темы с помощью функции AI-сортировки в плагине Discourse AI в сочетании с Discourse Automation.
Требуемый уровень пользователя: Администратор
Помечать темы с помощью AI
Эта автоматизация использует LLM для чтения содержимого темы и решения, следует ли применять определённые теги. При настройке в параметрах автоматизации она также может учитывать все теги сайта.
Требования
- Плагины Discourse AI и Discourse Automation должны быть включены.
- Должен быть настроен хотя бы один LLM. Инструкции по настройке см. в руководстве по настройке LLM.
- Должен быть настроен Агент с подходящим системным промптом.
Конфигурации агента для справки
- Системный промпт:
Вы — эксперт по классификации контента и помощник по тегированию этого форума.
Ваша задача — анализировать сообщения и предлагать подходящие теги на основе содержимого, изображений и предоставленного списка доступных тегов.
Рекомендации:
- Предлагайте только теги из предоставленного списка доступных тегов
- Будьте консервативны — помечайте только то, в чём уверены
- Учитывайте как тему контента, так и цель сообщения
Вы всегда должны отвечать валидным JSON в точном формате:
{"tags": ["tag1", "tag2"], "confidence": 85}
- tags: массив названий тегов из доступного списка
- confidence: целое число от 0 до 100, отражающее уровень вашей уверенности
Если теги не подходят, используйте: {"tags": [], "confidence": 0}
- Формат ответа агента в JSON:
{
"tags": "[строка]",
"confidence": "целое число"
}
- Модель языка по умолчанию: Выберите LLM, настроенный в разделе Требования.
Клиенты с размещённым на Discourse сервисом могут выбрать CDCK Hosted Small LLM при настройке AI-агентов. - Включённые инструменты: Теги
- Принудительные инструменты: Теги
- Стратегия принудительных инструментов: Применять только к первому ответу
- Режим выполнения: По умолчанию (Фиксированные ограничения)
Конфигурации автоматизации
- Перейдите в Администрирование → Плагины → Автоматизация.
- Нажмите + Добавить автоматизацию.
- Выберите скрипт Помечать темы с помощью AI.
- Настройте параметры из раздела Когда/Что по своему усмотрению.
- В параметре
AI Agentиз раздела Параметры скрипта выберите агента, определённого для этой автоматизации. - Укажите, как AI будет выбирать теги, в параметре
Tag Selection Mode.- Использовать конкретный список тегов (настроен в параметре
Available Tags) - Позволить AI обнаруживать и использовать любые теги сайта.
- Использовать конкретный список тегов (настроен в параметре
- Нажмите кнопку Обновить автоматизацию.
- Включите автоматизацию.
Лучшие практики
- Начинайте с узкого охвата: Применяйте автоматизацию только к конкретной категории или к первым сообщениям новых пользователей (уровень доверия 0 или 1) перед расширением. Это ограничивает затраты на LLM и снижает риск массового неверного тегирования.
- Пишите чёткие описания тегов в промпте: Чем точнее описания значения каждого тега, тем надёжнее LLM будет классифицировать контент.
- Контролируйте ложные срабатывания и пропуски: LLM не будет точен на 100%. Создайте процесс проверки и исправления неверно помеченных тем, а также со временем корректируйте свой промпт.
- Сохраняйте разумные лимиты токенов: Параметр «Max Post Tokens» ограничивает объём сообщения, отправляемого в LLM. Для большинства задач тегирования достаточно первых нескольких сотен токенов (начало сообщения).
Распространённые проблемы и решения
- Теги не применяются автоматизацией
Проверьте права доступа к тегам. Если есть ограниченные теги, которые должны применяться, убедитесь, что параметр автоматизацииAllow Restricted Tagsвключён. - Автоматизация запускается, но не помечает темы
Проверьте логи сайта, чтобы выявить любые ошибки, связанные с плагинами Discourse AI или Discourse Automation.
