Discourse AI - Помощник

[Discourse]

Это руководство объясняет, как настроить и использовать функцию Helper плагина Discourse AI, включая её возможности и параметры конфигурации.

Требуемый уровень пользователя: Администратор

Helper помогает пользователям в взаимодействии внутри сообщества, например, при создании тем, написании постов и чтении контента. Он разработан для повышения продуктивности пользователей и улучшения общего качества вкладов.

Возможности

В редакторе (composer)

Примечание: В этой демонстрации в редакторе уже был написан текст.

При создании новых тем или ответов Helper предлагает следующие возможности:

• Генерация заголовков тем, тегов и категорий на основе содержимого
• Вычитка текста — включая проверку грамматики и орфографии
  • Горячие клавиши для Windows: CTRLALTP
  • Горячие клавиши для MacOS: ⌘⌥ P
• Перевод выделенного текста на язык форума по умолчанию
• Создание таблиц в формате Markdown
• Пользовательские промпты для различных преобразований текста
• Просмотр и управление предложенными изменениями от ИИ
• Автоматические подписи к загруженным изображениям с помощью ИИ
• Преобразование любых написанных дат в формат, удобный для Markdown, с помощью умных дат

При чтении тем и постов

При просмотре форума Helper может:

• Переводить выделенный текст на язык интерфейса пользователя
• Объяснять смысл выделенного текста в контексте темы
• Вычитка текста — включая проверку грамматики и орфографии
• Пользовательские промпты для различных преобразований текста
• Helper — Автоматические заголовки чат-веток

Включение Helper

Требования

Необходимо настроить как минимум одну большую языковую модель (LLM) от провайдера.

Если ваш сайт размещён на платформе Discourse

Вы можете выбрать нашу CDCK Hosted Small LLM из списка LLM.

Для начала работы вы можете настроить их на странице настроек Discourse AI — Большие языковые модели (LLM).

• OpenAI
• Anthropic
• Azure OpenAI
• AWS Bedrock с доступом к Anthropic
• Конечные точки HuggingFace
• Собственный хостинг открытой LLM
• Google Gemini
• Cohere
• SambaNova
• Mistral
• Open Router
• Groq

Конфигурация

1. Перейдите в раздел Администрирование → Настройки → Discourse AI.
2. Убедитесь, что включена настройка discourse ai enabled.
3. Перейдите на вкладку «Features» (Функции) в панели администратора ИИ.
4. Выберите фильтр «Unconfigured» (Не настроено) и найдите раздел Helper.
5. Нажмите «Edit» (Изменить) в разделе Helper.
6. Включите функцию Helper, установив флажок ai helper enabled.
7. Настройте любые другие связанные с Helper параметры, находясь здесь ^[1].

Функция Helper состоит из нескольких подмножеств, включая проверку текста, предложение заголовков, объяснение, иллюстрацию постов и другие. В настройках Helper вы можете использовать агентов по умолчанию, назначенных каждой функции, или настроить альтернативных агентов.

Для управления агентами и подключёнными к ним моделями LLM перейдите в Администрирование → Настройки → Discourse AI → Агенты.

Настройка функций Helper

Вы можете выборочно включать или отключать конкретные функции Helper с помощью настройки ai helper enabled features, которая находится на странице функций Helper. Доступные опции включают:

• suggestions: Управляет кнопками предложений для заголовков, категорий и тегов.
• context_menu: Управляет меню для пользовательских промптов, перевода и проверки текста.
• image_caption: Включает автоматические подписи к изображениям с помощью ИИ через функцию авто-подписи или кнопку «Caption with AI» (Подписать с помощью ИИ).

Технические вопросы и ответы

Не видите кнопку ИИ рядом с заголовком, тегом или категорией?

• Helper в редакторе требует наличия минимум 40 символов в редакторе для появления и работы.

Как работает функция «Объяснить» (Explain)?

• Функция «Объяснить» использует заголовок темы, содержимое поста и выделенный текст в качестве контекста для генерации вывода LLM.

Какие существуют варианты использования пользовательских промптов?

• Пользовательские промпты можно использовать для различных целей, например, для изменения тональности или перевода на конкретные языки.

Насколько точны переводы Helper?

• Хотя переводы обычно надёжны, они могут быть менее точными для редких языков.

Ограничения

• Мы рекомендуем ограничить доступ Helper для определённых групп пользователей, чтобы контролировать расходы, связанные с использованием сторонних провайдеров LLM.

---

1. Например:

   • Ограничить использование Helper в редакторе с помощью настройки composer ai helper allowed groups.

   • Ограничить доступ к функции Helper в постах с помощью настройки post ai helper allowed groups.

   ↩︎

[EricGT]

Sorry I can’t give this topic a like at present. Don’t take that to mean I don’t like what the AI is doing, I think that part is great.

The video started from a Draft and most users will start from New Topic so it was a bit confusing for me when I tried this on the OpenAI forum where this is active thinking it should work.

When I started with New Topic I had to enter the title, select a category, skipped adding tags and add two lines in the post before the magic AI options appeared.

Then after adding more text the AI buttons appeared.

---

I do find the post quite useful and you did a nice job, just needs some clarification for users not use to this technology.

[EricGT]

Side note:

In the early days of the Discourse AI there was the ability to have the AI generate a new title for the topic based on the existing text. I used this often as a category moderator when they titles ran long, think wrapped around when viewing in a list. Then the way to do this vanished; I may have missed how it was supposed to be done but now it is back with this.

As a category moderator one can not edit a post and the AI option is next to the title for changing.

Was looking for that in the announcement, might be worth a mention.

---

The following post contains some screenshots.

Suggestion to add for Chat GPT

[Saif (Saif Murtaza)]

@EricGT

The video started from a Draft and most users will start from New Topic so it was a bit confusing for me when I tried this on the OpenAI forum where this is active thinking it should work.

When I started with New Topic I had to enter the title, select a category, skipped adding tags and add two lines in the post before the magic AI options appeared.

Hey @EricGT so the video I put in a note that says that the content is already there. It was trying to make the demo video as short and succinct as possible.

@EricGT

Then after adding more text the AI buttons appeared.

I have the following documented for that reason!

@Saif

Technical FAQ

• How does AI Helper work within Composer? Why am I not seeing the icon?
  • AI Helper uses text content (min 10 words) within Composer and passes that context to a Large Language Model (LLM) to generate topic titles/tags/categories/etc

[JammyDodger]

Little update on this one…

You can now select/deselect AI helper features using the setting ai_helper_enabled_features:

DEV: Add granular control for AI composer helper features

[bekircem]

 ai_helper_model: We couldn't get a response from this model. Check your settings first.

What could be the problem? I’ve identified the Open AI key.

[Falco]

@bekircem

What could be the problem? I’ve identified the Open AI key.

Is your OpenAI API key working? Can you issue a request for that same model from your PC?

[bekircem]

It seems like it’s showing as unused in the OpenAI dashboard. But could it be because the configuration wasn’t completed? How can I verify this on my local machine?

[mattdm (Matthew Miller)]

@JammyDodger

You can now select/deselect AI helper features using the setting ai_helper_enabled_features:

What features are available, and what does each one do?

[Saif (Saif Murtaza)]

@mattdm

What features are available, and what does each one do?

The AI helper in the composer encompasses three main features including suggestions, context_menu, and image_caption

The setting allows us to have granular control of the AI helper by being able to enable/disable those main features.

1. suggestions refers to the the suggestion buttons that appear in the composer next to the title/category/tags. Clicking the suggestion button can suggest topic titles, category, tags, etc.
2. context_menu refers the the menu that appears when you select a portion of text in the composer, i.e. the menu that pops up with the custom prompt/translate/proofread/etc
3. image_caption refers to the “Caption with AI” button that appears when you hover over an uploaded image in the composer preview. This allows you to generate a caption based on the contents of the image.

[mattdm (Matthew Miller)]

Instead of a setting for which features are enabled, how about a setting for each, for which groups each is enabled for (if any)?

[mattdm (Matthew Miller)]

And actually, also… could the context menu items be separated? Ideally the same suggestion — list of groups for each.

[Saif (Saif Murtaza)]

@mattdm

And actually, also… could the context menu items be separated? Ideally the same suggestion — list of groups for each.

I think eventually we would like to move to a system to provide more granular control of features within AI Helper and in other AI features, something in the radar for the future

[Moin]

@Discourse

While writing, you can select text anywhere and ask the AI Helper to proofread, generate a markdown table, or translate into English.

I think “translate to English” is outdated.

@Discourse

While reading topics/posts

• Only for logged-in users
• Translate selected text to English

Now it’s translate to user’s interface language

@Discourse

Within Composer

• Only for logged-in users, can be used when creating a new topic or replying
• Generate topic titles/tags/categories, based on text context content within Composer
• Proofread selected text
• Translate selected text to English

Now it’s translate to forum’s default language

[jrgong]

Is there any way do add additional prompt or instructions to the translation prompt?

In our case we want to offer translations EN->DE and add the instruction to use the informal you (Du) instead of the formal (Sie) you by default.

[EricGT]

@EricGT

Sorry I can’t give this topic a like at present. Don’t take that to mean I don’t like what the AI is doing, I think that part is great.

Really wanted to use strike-through with the text but can’t edit the post.

The first post is really nice and quite useful, so I gave it a thumbs up. I really do appreciate the extra effort put into your post and look forward to reading more.