fix: PageHead header alignment, analytics proxy, and infra improvements (#64)

🤖 Pull request created from `various-fixes` containing PageHead
breadcrumbs and navigation alignment fixes, Umami analytics proxy, and
infrastructure updates.
This commit is contained in:
deytenit authored and GitHub committed 2026-10-24 16:52:49 +03:00
1 parent ff5a50bad8
commit 9ee672504f
110 files changed
+2649 -1760

No files matched your search

@@ -3,34 +3,34 @@ title: Интеграция разговорного ИИ
weight: 4
---
**Цель:** Интегрировать большие языковые модели (LLM), управляя контекстом и ограничениями тайм-аута Discord.
**Цель:** подключить большие языковые модели (LLM), настроить управление контекстом и уложиться в тайм-ауты Discord.
## 1. Стратегия управления контекстом
Разговоры требуют истории, чтобы быть связными.
Чтобы диалог оставался связным, модели нужна история сообщений:
- **Область видимости (Scoping):** `Map<GuildID, Map<UserID, Message[]>>`
- **Ключ гильдии (Guild Key):** Предотвращает утечки между серверами.
- **Ключ пользователя (User Key):** Предотвращает путаницу между пользователями в публичных каналах.
- **Жизненный цикл:** Реализуйте "скользящее окно" (например, последние 50 сообщений) для предотвращения разрастания контекста.
- **Ключ сервера (Guild Key):** изолирует контекст и защищает от утечек данных между серверами.
- **Ключ пользователя (User Key):** разделяет реплики разных участников в публичных каналах.
- **Жизненный цикл:** настройте «скользящее окно» (например, последние 50 сообщений), чтобы контекст не разрастался.
## 2. Потоковая передача ответов
LLM работают медленно, а Discord требует быстрых ответов (тайм-аут 3 секунды).
LLM генерируют ответ постепенно, а Discord ждёт реакции не дольше 3 секунд.
{{% steps %}}
### Шаг 1: Отложенное взаимодействие (Defer Interaction)
### Шаг 1: Отложенный ответ (Defer Interaction)
Немедленно вызовите `interaction.deferReply()`. Это даст вам 15 минут.
Сразу вызовите `interaction.deferReply()`. Это продлит время ожидания ответа до 15 минут.
### Шаг 2: Вызов LLM
### Шаг 2: Запрос к LLM
Асинхронно вызовите ваш ИИ-сервис.
Асинхронно отправьте запрос к ИИ-сервису.
### Шаг 3: Редактирование ответа
### Шаг 3: Отправка ответа
Когда данные поступят, используйте `interaction.editReply(content)`.
Когда ответ готов, вызовите `interaction.editReply(content)`.
{{% /steps %}}
## 3. Пример реализации
@@ -52,5 +52,5 @@ export async function execute(interaction, controller) {
```
> [!WARNING]
> **Затраты на API:**
> API ИИ часто тарифицируются по токенам. Внедрите строгие лимиты запросов (rate limits) для пользователей в вашем Контроллере, чтобы предотвратить злоупотребления.
> **Расходы на API:**
> Провайдеры ИИ обычно тарифицируют запросы по токенам. Настройте в контроллере строгие лимиты запросов (rate limits) для пользователей, чтобы избежать лишних расходов.