Настройка Agnes AI
Это руководство поможет настроить встроенный AI Agent в XMCL.
Agnes AI бесплатен
Agnes AI полностью бесплатен. Достаточно создать бесплатный API-ключ — никакой оплаты, подписки или банковской карты не требуется.
После настройки вы сможете:
- открывать окно AI Agent;
- разбирать краш-логи встроенным агентом;
- использовать инструменты агента (включение/выключение модов, установка, поиск/правка конфигов и т.д.).
Что понадобится
- Актуальная версия XMCL.
- Доступ в интернет.
- Бесплатный API-ключ Agnes AI.
Шаг 1: Получите API-ключ Agnes AI
- Откройте портал разработчика Agnes AI.
- Войдите в аккаунт или зарегистрируйтесь.
- Создайте API-ключ.
- Скопируйте и сохраните ключ в безопасном месте.
Шаг 2: Откройте настройки Agent в XMCL
- Откройте XMCL.
- Перейдите в Settings -> General.
- Включите Developer Mode.
- Прокрутите до секции AI Agent.
Шаг 3: Заполните поля Agent
В секции AI Agent:
- API Key: вставьте ключ Agnes;
- Model: оставьте по умолчанию, если нет иных требований;
- Endpoint: оставьте по умолчанию, если нет иных требований.
Стандартный endpoint Agnes:
text
https://apihub.agnes-ai.com/v1/chat/completions
Шаг 4: Проверьте, что всё работает
- Нажмите
Ctrl/Cmd + Shift + A, чтобы открыть окно Agent. - Отправьте простую команду, например:
list my installed mods. - Убедитесь, что агент отвечает без ошибки конфигурации.
Устранение проблем
Agent не открывается
- Проверьте, что включен Developer Mode.
- После включения Developer Mode перезапустите XMCL.
Всё ещё показывается предупреждение "не настроено"
- Проверьте API-ключ (без лишних пробелов/переводов строки).
- Убедитесь, что endpoint доступен из вашей сети.
Ошибка запроса / 401 / 403
- Ключ недействителен, просрочен или не имеет прав.
- Сгенерируйте новый ключ в портале Agnes и вставьте снова.
Таймаут запроса
- Проверьте фаервол/прокси.
- Попробуйте снова со стандартным endpoint.
Безопасность
- Относитесь к API-ключу как к паролю.
- Не публикуйте скриншоты, где виден ключ.
- При подозрении на утечку немедленно смените ключ.