> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakestudio.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция с ИИ

> Настройка LLM-провайдеров, оценки предметов, семантического поиска и безопасности в settings/ai.yml.

Настройки модуля искусственного интеллекта находятся в `settings/ai.yml`.

## Провайдеры

| Провайдер    | Модели                                                                              | Особенности                                                                              |
| :----------- | :---------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |
| **GEMINI**   | `gemini-3.8-flash`, `gemini-3.7-flash`, `gemini-3.6-flash`, `gemini-3.5-flash-lite` | Низкая задержка, мультимодальность, длинный контекст.                                    |
| **CLAUDE**   | `claude-opus-4-8`, `claude-sonnet-4-6`, `claude-haiku-4-5`                          | Сильное рассуждение, кодинг и точное следование инструкциям.                             |
| **GROK**     | `grok-4.6`, `grok-4.5`, `grok-4.3`                                                  | API xAI, сильный reasoning и agentic/tool-calling возможности.                           |
| **OPENAI**   | `gpt-5.6`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`                           | Официальный API OpenAI, reasoning, vision, tools и длинный контекст.                     |
| **DEEPSEEK** | `deepseek-v4-pro`, `deepseek-v4-flash`, `deepseek-v4-flash-vision-exp`              | Сильное reasoning и кодинг, низкая стоимость токенов, Vision у экспериментальной модели. |
| **QWEN**     | `qwen3.8-max-0902`, `qwen3.8-flash`, `qwen3.8-27b`, `qwen3.7-plus`                  | Мультимодальность, reasoning, 1M контекст и развитые agentic-возможности Alibaba Cloud.  |
| **MISTRAL**  | `mistral-medium-3.5`, `mistral-small-4`, `mistral-large-3`, `ministral-3-14b`       | Мультимодальность, reasoning и coding; API Mistral AI.                                   |
| **GROQ**     | `openai/gpt-oss-120b`, `openai/gpt-oss-20b`, `qwen/qwen3.6-27b`, `qwen/qwen3.8-27b` | Очень высокая скорость инференса благодаря LPU; поддержка tool calling и JSON Schema.    |
| **OLLAMA**   | Локальные модели                                                                    | Локальный инференс без внешних обращений.                                                |
| **CUSTOM**   | OpenAI-совместимый эндпоинт                                                         | OpenRouter, vLLM или прокси-серверы.                                                     |

## Балансировка ключей и моделей

Поддерживается указание нескольких API-ключей и моделей с автоматическим переключением:

```yaml theme={null}
enabled: true
provider: GEMINI

default_settings:
  api_keys:
    - "AIzaSyD-FirstKey..."
    - "AIzaSyD-SecondKey..."

  # FAILOVER - переключение на следующий ключ при ошибке или исчерпании лимита.
  # ROUND_ROBIN - циклическое распределение запросов по очереди.
  # RANDOM - случайный выбор живого ключа.
  key_strategy: FAILOVER
  key_cooldown_minutes: 10

  models:
    - "gemini-3.5-flash"
    - "gemini-3.5-flash-lite"

  model_strategy: FAILOVER
  cache_ttl_minutes: 30 # Время кэширования ответов в ОЗУ
```

## Модули

Каждый модуль настраивается в секции `routing` и может иметь собственные модели, промпты и ключи.

### price\_advisor (Оценка стоимости)

* **Команда:** `/ah ai price`
* Анализирует материал, прочность, уровень зачарований и их синергию. Возвращает справедливую цену, цену для быстрой продажи и максимальную планку.

### smart\_search (Семантический поиск)

* **Команда:** `/ah ai search <запрос>`
* Преобразует запрос на естественном языке в ключевые слова материалов и категорию аукциона.
* Примеры:
  * `сет брони на пвп` -> `NETHERITE`, категория `ARMOR`.
  * `дерево для стройки` -> `LOG`, категория `BLOCKS`.
  * `зельки хила` -> `POTION`, категория `CONSUMABLES`.

### market\_digest (Сводка рынка)

* **Команда:** `/ah ai digest`
* Формирует краткую сводку торговой активности на сервере за последние 24 часа.

### deal\_finder (Поиск выгодных предложений)

* Сканирует активные лоты и находит товары, выставленные значительно ниже среднерыночной цены.

### anti\_fraud (Антифрод)

* Выявляет аномальные сделки с завышенными ценами для предотвращения перелива валюты и RMT.

### auto\_buyer (Фильтр автоскупщика)

* Защищает автопокупку сервера от эксплойтов: отклоняет переименованные фейки, сломанные вещи без «Починки» и завышенные цены.

## Лимиты и безопасность

Ограничения одновременных подключений и защита от спама настраиваются в секции `security`:

```yaml theme={null}
security:
  max_concurrent_requests: 5 # Максимум параллельных запросов к API
  ip_rate_limiting: true     # Учет суточного лимита по IP игрока
  multiserver_sync: true     # Синхронизация лимитов между серверами сети
```

### Permissions

| Permission                              | Описание                                                             |
| :-------------------------------------- | :------------------------------------------------------------------- |
| `cakeauction.ai.price`                  | Доступ к `/ah ai price`                                              |
| `cakeauction.ai.search`                 | Доступ к `/ah ai search`                                             |
| `cakeauction.ai.deals`                  | Доступ к анализу выгодных предложений                                |
| `cakeauction.ai.antifraud`              | Доступ к отчетам антифрода                                           |
| `cakeauction.ai.bypass`                 | Обход кулдаунов и суточных лимитов                                   |
| `cakeauction.ai.limit.<число>`          | Общий суточный лимит запросов (например: `cakeauction.ai.limit.100`) |
| `cakeauction.ai.<модуль>.limit.<число>` | Суточный лимит на конкретный модуль                                  |