Discord
Добавьте подписанное взаимодействие /ask в приложение и сервер Discord.
Добавьте подписанное взаимодействие /ask в приложение и сервер Discord.
Создайте приложение Discord#
Следуйте официальному быстрому старту приложений Discord и обзору взаимодействий. Создайте приложение в Discord Developer Portal и соберите:
| Поле Make Agent Fast | Расположение в Discord | Назначение |
|---|---|---|
| Application ID | General Information | Идентифицирует приложение и команду |
| Public Key | General Information | Проверяет подписанные Ed25519 взаимодействия; ровно 64 шестнадцатеричных символа |
| Токен бота | Страница Bot | Проверяет приложение и регистрирует /ask; держите в секрете |
Сброс токена бота немедленно аннулирует предыдущий. Public Key не секретен, но должен принадлежать тому же приложению, что и токен бота.
Подключите и зарегистрируйте /ask#
Откройте страницу Коннекторы сайта, выберите Discord, введите три значения и нажмите Подключить.
Make Agent Fast проверяет токен бота против конечной точки приложения Discord и отклоняет Public Key, не совпадающий с приложением. Он нормализует опечатанный Application ID к реальному ID аутентифицированного приложения, затем создаёт или обновляет глобальную команду /ask question, не удаляя другие команды приложения.
После сохранения скопируйте показанный Interactions Endpoint URL в General Information → Interactions Endpoint URL в Discord и сохраните. Discord отправляет подписанный PING; Make Agent Fast проверяет подпись и возвращает требуемый PONG.
Установите и протестируйте#
Используйте настройки установки Discord, чтобы авторизовать приложение на тестовом сервере с разрешениями, требуемыми для команд приложения. Распространение глобальной команды может занять время.
Запустите /ask, заполните обязательную опцию question и отправьте. Make Agent Fast подтверждает взаимодействие до короткого дедлайна Discord, запускает агента, затем редактирует отложенный исходный ответ. История диалога привязана к пользователю Discord, поэтому более поздние запросы /ask могут сохранять контекст.
Текущий коннектор только текстовый. Он не читает голосовые каналы, вложения, обычные сообщения каналов или личные сообщения; только зарегистрированное взаимодействие /ask входит в агента.
Ротация или отключение#
Если токен бота раскрыт, сбросьте его в Discord, обновите коннектор и проверьте /ask снова. Если меняется само приложение, обновите все три значения и Interactions Endpoint URL для этого приложения.
Отключение или удаление коннектора не удаляет приложение Discord или глобальную команду. Удалите приложение с серверов и удалите устаревшие учётные данные провайдера отдельно при выводе из эксплуатации.
Решение проблем#
| Симптом | Решение |
|---|---|
| Коннектор отклоняет поля | Используйте токен бота и 64-символьный Public Key из одного приложения |
| Discord отклоняет конечную точку | Подтвердите публичный HTTPS, вставьте сгенерированную конечную точку и пересохраните учётные данные перед повтором |
/ask отсутствует | Подтвердите установку/авторизацию команды, дождитесь глобального распространения и переподключитесь для повторной регистрации |
| Взаимодействие сообщает, что приложение не ответило | Проверьте, что коннектор включён, и изучите ошибки Make Agent Fast/Discord; проверка подписи конечной точки должна пройти |
| Другие сообщения чата игнорируются | Ожидаемо; интеграция обрабатывает только /ask |
| Ответ обрезан | Ответы сообщений Discord ограничены 2 000 символами |
Никогда не раскрывайте токен бота в клиентском коде, репозиториях, логах или скриншотах.