Это руководство объясняет, как настроить и управлять Агентами для Discourse AI - AI bot.
Требуемый уровень пользователя: Администратор
AI-бот Discourse включает гибкую систему управления Агентами. В этом руководстве рассматриваются:
- Методы взаимодействия с AI-агентами
- Параметры конфигурации
- Расширенные настройки
- Поддерживаемые инструменты
- Возможности кастомизации
Узнайте больше об AI-боте и о том, как его включить в этом руководстве.
Что такое агенты?
Агенты — это мощная функция, позволяющая настраивать поведение AI-движка в вашем форуме Discourse. Они действуют как «системное сообщение», которое направляет ответы и взаимодействия AI, помогая создать более персонализированный и увлекательный пользовательский опыт.
Зачем использовать агентов?
С помощью агентов вы можете адаптировать поведение AI под контекст и тон вашего форума. Хотите ли вы, чтобы AI был более формальным для профессиональной среды, более неформальным для сообщества или даже воплощал конкретного персонажа для ролевой игры — агенты дают вам такую гибкость.
Доступ к агентам для конкретных групп
Кроме того, вы можете настроить систему так, чтобы определенные группы пользователей имели доступ к конкретным агентам. Это означает, что вы можете иметь разное поведение AI для разных разделов вашего форума, еще больше усиливая разнообразие и насыщенность взаимодействий в вашем сообществе.
Взаимодействие с агентами
С агентами можно взаимодействовать несколькими способами:
- Личное сообщение (PM)
- Прямое сообщение в чате (DM)
- Упоминания в каналах чата
- Упоминание в публичной теме через
@example_bot_username
Администраторы могут контролировать, какие методы взаимодействия разрешены для каждого агента, с помощью четырех отдельных переключателей:
- Разрешить личные сообщения: Позволяет пользователям начинать PM с этим агентом (включено по умолчанию)
- Разрешить упоминания в темах: Позволяет использовать
@mentionв темах для запуска ответа - Разрешить прямые сообщения в чате: Позволяет использовать DM в чате с этим агентом (требуется плагин чата)
- Разрешить упоминания в каналах чата: Позволяет использовать
@mentionв каналах чата (требуется плагин чата)
Конфигурация
Чтобы настроить Агентов, перейдите по адресу discourse.example.com/admin/plugins/discourse-ai/ai-agents.
Ключевые параметры конфигурации включают:
- Системный промпт: Направляет ход диалога
- Поддержка Vision: Включите для LLM с поддержкой Vision, например GPT-4 Turbo, Claude 3
- Модель по умолчанию: Обязательна для упоминаемых агентов и агентов с включенной функцией принудительного использования LLM по умолчанию
- Разрешенные группы: Определение прав доступа с использованием групповой безопасности Discourse
- Загрузки: Индексация текстовых файлов для дополнительных знаний (с использованием RAG — Retrieval-Augmented Generation)
- Включенные инструменты: Контроль доступа к определенным инструментам
- Режим выполнения: Выбор между режимом «по умолчанию» и «агентным» (агентный режим включает многошаговое использование инструментов с настраиваемыми лимитами токенов и сжатием)
Вот пример экрана полной конфигурации AI-агента:
Расширенные параметры конфигурации
Редактор агентов предлагает несколько расширенных опций:
- Temperature и top_p (сэмплирование по ядру): Контроль креативности против предсказуемости
- Max context posts: Ограничение количества постов, передаваемых LLM для истории — меньше постов снизит затраты, но заставит AI «забыть» о старом контенте (недоступно в агентном режиме)
- Режим выполнения: «По умолчанию» для ответов в один проход, «Агентный» для многошагового использования инструментов с:
- Max turn tokens: Бюджет токенов для агентного выполнения
- Compression threshold: Порог сжатия контекста в процентах (20–99%)
- Показывать размышления: Отображение процесса рассуждения AI пользователям (включено по умолчанию)
- Требовать одобрение: Требовать человеческое одобрение перед выполнением определенных действий
- Принудительное использование LLM по умолчанию: Запретить пользователям переключать LLM для этого агента
- Формат ответа: Настройка структурированного формата вывода
- Примеры: Few-shot примеры для направления поведения AI (пары сообщений пользователь/ассистент)
- Параметры загрузки:
- Chunk tokens: Контроль разделения документов
- Chunk overlap tokens: Установка перекрытия между чанками
- Search conversation chunks: Количество фрагментов документа, добавляемых к запросам пользователей
- Question consolidator LLM: Выбор LLM для определения вопросов пользователей
- RAG LLM model: Выбор конкретной LLM для обработки RAG
Предварительные требования для поддержки загрузки
Чтобы использовать поддержку загрузки:
- Включите настройку
ai_embeddings_enabled - Настройте модель эмбеддингов через
ai_embeddings_selected_model
Discourse AI поддерживает различные модели эмбеддингов. Клиенты на хостинге получают бесплатный доступ к модели bge-large-en.
Самохостеры или те, кто хочет больше выбора, могут самостоятельно разместить модель эмбеддингов или использовать модели от Open AI, Google (Gemini) и других.
Разделение текста в Discourse AI
Discourse использует рекурсивный разделитель текста по символам, чтобы сохранять абзацы, строки и слова вместе при разделении текста. Вы можете управлять разделением текста, используя разделитель [[metadata ВАШИ МЕТАДАННЫЕ ЗДЕСЬ]]:
[[metadata about cats]]
dлинная история о кошках
[[metadata about dogs]]
dлинная история о собаках
Этот метод предотвращает «загрязнение чанков», гарантируя, что в каждый чанк включаются только релевантные данные.
Отладка AI-агентов
Чтобы отладить вашего агента:
- Добавьте пользователей в группу, указанную в настройке
ai_bot_debugging_allowed_groups - Пользователи в этой группе увидят кнопку отладки AI в нижней части постов AI
- Нажмите кнопку, чтобы открыть модальное окно интерфейса отладки
Помните: если вы предоставите LLM размытую или бесполезную информацию, ему будет очень сложно преобразовать её в полезную.
Поддерживаемые инструменты
Discourse AI поддерживает различные инструменты, включая:
Всегда доступны
- Категории
- Время
- Поиск
- Чтение
- Схема базы данных
- Настройки поиска
- Контекст настроек
- Случайный выборщик
- Веб-браузер
- Поиск Meta Discourse
- Оценщик JavaScript
- Исследователь
- Флаг поста
- Закрыть тему
- Скрыть тему
- Заблокировать пост
- Удалить тему
- Редактировать пост
- Редактировать категорию
- Установить таймер темы
- Установить медленный режим
- Переместить посты
- Выдать значок
Интеграция с GitHub
- Контент файла GitHub
- Diff запроса на слияние (Pull Request) GitHub
- Поиск файлов GitHub
Эти три инструмента всегда доступны. Дополнительно:
- Поиск кода GitHub требует заполнения настройки
ai_bot_github_access_token
Условные инструменты
- Теги и Редактировать теги: Доступны, когда на вашем сайте включена функция тегирования
- Генерация изображений (Image, Create Image, Edit Image): Требуется кастомный инструмент генерации изображений, настроенный через административный интерфейс
- Поиск Google: Требует заполнения настроек
ai_google_custom_search_api_keyиai_google_custom_search_cx - Артефакты (Create Artifact, Update Artifact, Read Artifact): Доступны, когда
ai_artifact_securityустановлено в lax, hybrid или strict - Назначение: Доступно, когда установлен плагин Assign
- Отметить как решенное: Доступно, когда установлен плагин Solved
Некоторые инструменты требуют дополнительной конфигурации или API-ключей.
Поддержка пользовательских инструментов
Вы можете создать свои собственные инструменты, используя поддержку пользовательских инструментов.
Кастомизация системных агентов
- Создайте нового агента
- Скопируйте и вставьте системный промпт из агента, который вы хотите кастомизировать
- Измените при необходимости
- Опционально отключите оригинальный системный агент, чтобы избежать дублирования
Кастомизация поиска
Чтобы кастомизировать поиск для нового агента:
- Создайте нового агента
- Добавьте инструмент «search»
- Настройте параметры поиска, включая:
- Базовый поисковый запрос
- Максимальное количество результатов поиска
- Опцию включения приватных тем
Это позволяет делегировать права на поиск, увеличить количество результатов или ограничить поиск определенными разделами вашего сайта.
