> Для получения чистого Markdown любой страницы добавьте .md к URL страницы.  
> Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.  
> Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.  
> Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к MCP‑серверу по адресу https://api.vega.chat/docs/_mcp/server.

# Плагины

Плагины VEGA расширяют возможности любой модели, внедряя или изменяя запрос или ответ, чтобы добавить такие функции, как обработка PDF, автоматический ремонт JSON и сжатие контекста. В отличие от [инструментов сервера](/docs/guides/features/server-tools) (которые модель может вызывать 0‑N раз), плагины всегда выполняются один раз при включении. Плагины можно включать для отдельного запроса через API или задавать как значения по умолчанию для всех ваших API‑запросов на странице [Настройки плагинов](https://api.vega.chat/settings/plugins).

## Доступные плагины

VEGA в настоящее время поддерживает следующие плагины:

| Плагин                     | Описание                                                                                                                                                     | Документация                                                       |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| **Web Search** (устарел)   | Расширяет ответы LLM результатами поиска в реальном времени. Вместо этого используйте [`openrouter:web_search` server tool](/docs/guides/features/server-tools/web-search). | [Web Search](/docs/guides/features/plugins/web-search)           |
| **PDF Inputs**             | Парсит и извлекает содержимое из загруженных PDF‑файлов                                                                                                    | [PDF Inputs](/docs/guides/overview/multimodal/pdfs)              |
| **Response Healing**       | Автоматически исправляет некорректные JSON‑ответы от LLM‑ов                                                                                                 | [Response Healing](/docs/guides/features/plugins/response-healing) |
| **Pareto Router**          | Устанавливает уровень качества кода по умолчанию для роутера кода Pareto                                                                                   | [Pareto Router](/docs/guides/routing/routers/pareto-router)      |
| **Context Compression**   | Сжимает подсказки, превышающие окно контекста модели, используя метод middle‑out truncation                                                             | [Message Transforms](/docs/guides/features/message-transforms)    |

## Включение плагинов через API

Плагины включаются добавлением массива `plugins` в запрос завершения чата. Каждый плагин идентифицируется своим `id` и может включать необязательные параметры конфигурации.

```typescript title="TypeScript"
const response = await fetch('https://api.vega.chat/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {{API_KEY_REF}}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: '{{MODEL}}',
    messages: [
      {
        role: 'user',
        content: 'What are the latest developments in AI?'
      }
    ],
    plugins: [
      { id: 'web' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);
```

```python title="Python"
import requests

response = requests.post(
  "https://api.vega.chat/api/v1/chat/completions",
  headers={
    "Authorization": f"Bearer {{API_KEY_REF}}",
    "Content-Type": "application/json",
  },
  json={
    "model": "{{MODEL}}",
    "messages": [
      {
        "role": "user",
        "content": "What are the latest developments in AI?"
      }
    ],
    "plugins": [
      {"id": "web"}
    ]
  }
)

data = response.json()
print(data["choices"][0]["message"]["content"])
```

```bash title="cURL"
curl https://api.vega.chat/api/v1/chat/completions \
  -H "Authorization: Bearer {{API_KEY_REF}}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "{{MODEL}}",
    "messages": [
      {
        "role": "user",
        "content": "What are the latest developments in AI?"
      }
    ],
    "plugins": [
      {"id": "web"}
    ]
  }'
```

## Использование нескольких плагинов

Вы можете включить несколько плагинов в одном запросе:

```json
{
  "model": "openai/gpt-5.2",
  "messages": [...],
  "plugins": [
    { "id": "web", "max_results": 3 },
    { "id": "response-healing" }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": { ... }
  }
}
```

## Настройки плагинов по умолчанию

Администраторы организаций и отдельные пользователи могут задавать настройки плагинов по умолчанию, которые применяются ко всем API‑запросам. Это удобно для:

* Включения таких плагинов, как веб‑поиск или исправление ответов, по умолчанию для всех запросов  
* Установки согласованных конфигураций плагинов без изменения кода приложения  
* Принудительного применения настроек плагинов, которые нельзя переопределить отдельными запросами  

Чтобы задать настройки плагинов по умолчанию:

1. Перейдите в [Настройки > Плагины](https://api.vega.chat/settings/plugins)  
2. Включите/выключите плагины, чтобы задать их состояние по умолчанию  
3. Нажмите кнопку «Configure», чтобы настроить параметры плагина  
4. При желании включите «Prevent overrides», чтобы принудительно применять настройки ко всем запросам  

В организациях страница настроек плагинов доступна только администраторам.

Когда включена опция «Prevent overrides» для плагина, отдельные API‑запросы не могут отключить или изменить конфигурацию этого плагина. Это полезно для обеспечения политики на уровне всей организации.

### Приоритет плагинов

Настройки плагинов применяются в следующем порядке приоритета:

1. **Настройки уровня запроса**: конфигурации плагинов в массиве `plugins` отдельных запросов  
2. **Настройки аккаунта**: параметры, заданные на странице настроек плагинов  

Если плагин включён в настройках аккаунта, но не указан в запросе, будет использована конфигурация по умолчанию. Если плагин указан в запросе, его настройки переопределят значения по умолчанию.

Если вы хотите, чтобы настройки аккаунта имели приоритет, включите «Prevent overrides» в конфигурации плагина. После этого генерации не смогут переопределить эти настройки.

### Отключение плагина по умолчанию

Если плагин включён по умолчанию в настройках вашего аккаунта, вы можете отключить его для конкретного запроса, передав `"enabled": false` в массиве `plugins`:

```json
{
  "model": "openai/gpt-5.2",
  "messages": [...],
  "plugins": [
    { "id": "web", "enabled": false }
  ]
}
```

Это отключит плагин веб‑поиска для данного запроса, даже если он включён в настройках аккаунта.

## Варианты моделей как ярлыки плагинов

Вариант `:online` и плагин веб‑поиска устарели. Вместо этого используйте [`openrouter:web_search` server tool](/docs/guides/features/server-tools/web-search).

Некоторые плагины имеют удобные ярлыки в виде вариантов моделей. Например, добавление `:online` к идентификатору любой модели включает веб‑поиск:

```json
{
  "model": "openai/gpt-5.2:online"
}
```

Это эквивалентно:

```json
{
  "model": "openai/gpt-5.2",
  "plugins": [{ "id": "web" }]
}
```

Смотрите раздел [Model Variants](/docs/guides/routing/model-variants) для получения дополнительной информации о доступных ярлыках.