У бота с тридцатью функциями очень много настроек, и большинство из них имеют смысл только рядом с другой. Помощник по настройке читает конфигурацию вашего сервера и отвечает на вопросы о ней: что делает настройка, что в ней сейчас указано и что нужно изменить, чтобы получить другое поведение.
Он также может предложить изменение - в виде списка «было/стало», который вы читаете и применяете сами. Ничего не применяется без вашего клика.
✨ Где он находится
Панель чата на странице Настройка функции вашего сервера. Откройте её кнопкой 🛠 в правом нижнем углу.
Он принадлежит вашей команде, а не лично вам. Все в команде видят одни и те же разговоры, поэтому коллега может продолжить с того места, где вы остановились, а вы можете прочитать, что уже спрашивали, вместо того чтобы спрашивать снова.
Это второй помощник, наряду с Graph Assistant, а не вместо него. Помощник по графам остаётся в редакторе графов и продолжает делать то же, что делал; этот говорит о функциях вашего сервера. У них общие только настройки модели вашей команды, больше ничего - вопрос одному никогда не блокирует другого.
📖 Он читает вашу актуальную конфигурацию
Не документацию и не то, что функция делала раньше: настройки, которые стоят на этом сервере прямо сейчас.
Для каждой включённой функции ему сообщаются название каждой настройки, её настоящий ключ, тип и значение, которое у вас в ней указано. Настройка, которую вы так и не заполнили, описывается как не задано, а не пропускается, потому что «ничего не происходит, потому что это поле пустое» - как правило, и есть ответ.
Он также знает, какие функции не включены. Спросите о такой функции, и он скажет об этом и объяснит, что её нужно включить на странице «Функции», прежде чем появятся её настройки, - вместо того чтобы выдумывать ответ о настройках, которых нет.
Нажмите Перечитать конфигурацию после того, как что-то изменили. Помощнику передаётся свежее описание вместе со следующим вопросом, поэтому он отвечает на основе того, что сервер содержит сейчас.
✅ Он предлагает, вы применяете
Когда ответ связан с изменением чего-либо, к нему прилагается Посмотреть изменения. Это открывает список «было/стало»: функция, название настройки и её настоящий ключ, текущее значение и предлагаемое значение. Настройка, которую он называет и в которой уже стоит нужное значение, тоже показывается с пометкой Уже так и настроено, чтобы ничто не выглядело изменением, которым не является.
Применить сразу записывает это в настройки вашего сервера - той же записью, которую выполняет страница самой функции, с теми же проверками и той же записью в вашем журнале аудита. Отклонить отклоняет предложение. Повторный вопрос вместо применения тоже отклоняет его: прежнее предложение помечается как Заменено более поздним ответом, а его кнопка пропадает, поэтому вы никогда не сможете применить то, что уже заменили два более новых ответа.
Список пересчитывается в момент, когда вы его открываете, и ещё раз в момент, когда вы применяете, - по настройкам в том виде, в каком они стоят в эту секунду. Если за это время коллега что-то изменил, вы видите его значение в столбце было - предложение часовой давности никогда не вернёт тихо то, что кто-то с тех пор поменял.
Всё или ничего. Если какая-то часть предложения не подходит - несуществующая настройка или значение, которое поле не принимает, - весь пакет отклоняется, и ничего не записывается. Помощнику сообщают, что именно было не так, и он пробует снова, а вы видите причину в ветке.
Есть вещи, которые он не может предлагать вовсе:
- Включение или выключение функции. Это остаётся на странице «Функции». Он подскажет вам перейти туда.
- Любые учётные данные. Он не может их видеть и не может их записывать (см. ниже).
- Функции с собственной страницей, а не формой настроек: Moderation, Automod, Leveling, Reaction Roles, Server Logs, Discord Reports и Discord Tickets. Он знает, что в таких случаях нужно отправить вас туда.
Кто может применять
Чтение предложения и его применение - это два разных права. Любой, кто может пользоваться помощником, видит полный список «было/стало»; для применения нужно право настраивать сервер - то же, что требуется для формы настроек. Без него список по-прежнему можно читать, а кнопка просто недоступна.
🙈 Он никогда не видит ваши учётные данные
В нескольких функциях хранятся секреты: API-ключ для ответов ИИ, секрет S3 для записи аудио, токены для социальных оповещений. Эти значения заменяются на •••••••• ещё до того, как помощнику что-либо сообщат.
Ему говорят, что значение скрыто и почему, поэтому он по-прежнему может сказать «для этой функции ключ настроен» или «у этой функции нет ключа» - полезную половину ответа - без того, чтобы секрет покидал панель. Настройка, которую вы так и не заполнили, остаётся видимо пустой, а не замаскированной, поэтому «настроено» и «не настроено» никогда не выглядят одинаково.
Он не может восстановить скрытое значение, и ему велено никогда не просить вас вставлять такое значение в чат.
🏷 Названия, а не голые ID
Discord хранит каналы и роли как длинные числа, а конфигурацию, зачитанную в ID, невозможно читать. Везде, где панель знает название, оно записывается рядом с ID - 123456789 (#announcements), 987654321 (@Moderator) - чтобы ответ мог называть канал, который вы действительно узнаёте.
💬 Несколько разговоров
У каждой темы своя ветка. Начинайте новую кнопкой +, когда меняете тему: помощник видит только историю одного разговора, поэтому посторонняя прежняя дискуссия не собьёт ответ.
Ветки называются по вашему первому вопросу и сортируются по последнему сообщению. Кнопка 🗑 удаляет ветку вместе со всем, что в ней было сказано, и все в команде видят, как она исчезает. Последнюю оставшуюся ветку удалить нельзя - панели всегда нужно место, куда писать, - как и ту, в которой помощник сейчас работает.
⏳ Один запрос за раз
Пока помощник работает, поле ввода отключено для всей команды, во всех разговорах, и все видят, чей запрос выполняется. У команды одна модель и один счёт; два вопроса одновременно стоили бы вдвое дороже и перебивали бы друг друга.
Кнопка 🛠 показывает то же состояние, когда окно закрыто, так что вы видите, что команда занята, не открывая ничего.
Вопрос по графу и вопрос по конфигурации не блокируют друг друга. Это намеренно отдельные очереди.
👀 Наблюдение за его размышлением
К каждому ответу прилагаются рассуждения помощника, свёрнутые под Показать рассуждение. Откройте их, когда ответ вас удивил: там обычно сказано, какую настройку он прочитал, чтобы прийти к нему, а это быстрее, чем проверять их по одной.
Вопросы подписаны тем, кто их задал, потому что ветка общая.
🧠 Что бот помнит здесь
Если для вашего сервера включена AI Memory, бот отмечает то, что узнаёт о сервере из разговоров в Discord. Помощнику эти заметки могут передаваться вместе с вашим вопросом.
Это выключено, пока вы не включите, и это тот же переключатель, который вы задаёте в панели ⚙ помощника по графам, - он ваш, а не принадлежит окну. Тот, кто разрешил этот источник, имел в виду источник, а не конкретный экран. Когда он включён, чат сообщает об этом над вашим первым сообщением.
То, что он получает, ограничено так же, как и там: сервер, который у вас открыт, и никакой другой; заметки о самом сервере, но никогда не те, что записаны об отдельном участнике; фиксированное число самых последних; каждая обрезана до разумной длины. Они передаются ему как фоновая информация, а не как инструкции.
👥 Кто может им пользоваться
Нужны два права: право видеть сервер и право команды на ИИ-помощника. Оба проверяются при каждом запросе и снова при живом соединении, поэтому ссылка, которой поделились с кем-то вне команды, ничего ему не даёт.
⚙️ Какую модель он использует
Ту же, что и Graph Assistant: по умолчанию модель платформы или собственная модель вашей команды - со своим API-ключом, своей моделью или своим OpenAI-совместимым эндпоинтом. Она задаётся один раз на странице настроек вашей команды, в разделе Модель ассистента, и оба помощника следуют ей.
Если ничего не настроено вообще, окно сообщает об этом, а не завершается ошибкой на вашем вопросе.
💡 Как получить хороший ответ
Спрашивайте о поведении, а не о базе данных:
- «Почему приветственное сообщение не появляется, когда кто-то вступает?»
- «Что сейчас написано в объявлении о повышении уровня и где оно публикуется?»
- «Какие из моих включённых функций пишут в канал, которого больше нет?»
- «Я хочу, чтобы автомод предупреждал, а не удалял - что мне изменить?»
Затем прочитайте рассуждение и либо откройте страницу, которую он называет, либо просмотрите предложенное им изменение.
Если в ответе говорится, что он уже включил или сохранил что-то, это неправда о нём самом. Изменение существует только после того, как вы увидели его в списке «было/стало» и нажали Применить - и после этого оно появляется в вашем журнале аудита под вашим именем.