# Окно Agents в VS Code

> Подключите LLMoxy в окне Agents VS Code через пользовательскую конечную точку, настройте API Key и ID модели и разрешите сеансам Agent Host использовать собственные модели.

Сайт: [https://code.visualstudio.com/ (нажмите для перехода к загрузке!)](https://code.visualstudio.com/)

Официальная документация: [AI language models in VS Code](https://code.visualstudio.com/docs/agent-customization/language-models), [Use the Agents window](https://code.visualstudio.com/docs/copilot/agents/agents-window)

> **📌 Об окне Agents**
> Окно Agents — отдельное рабочее место агента в VS Code: в нём создаются сеансы, выбираются модели и отслеживаются задачи. Здесь рассказано только о том, как подключить LLMoxy; управление сеансами не рассматривается.

## Подготовка

- Установлен [VS Code](https://code.visualstudio.com/) (рекомендуется свежая стабильная версия или Insiders)
- Создайте токен в консоли LLMoxy, см. [Получить API-ключ](https://ru.llmoxy.com/docs/get-started/get-token)
- Рекомендуется токен группы **default** (текстовые модели GPT); не смешивайте с ключом для генерации изображений

Данные для подключения:

| Параметр | Значение |
| --- | --- |
| Шлюз | `https://llmoxy.com` |
| Chat Completions | `https://llmoxy.com/v1/chat/completions` |
| API Key | токен, скопированный из консоли |
| Рекомендуемые модели | `gpt-6-astra`, `grok-4.7` |

Агент должен уметь вызывать инструменты, поэтому в конфигурации модели необходимо задать `toolCalling` равным `true`, иначе она не появится в списке моделей окна Agents.

## Открытие окна Agents

Любым из способов:

- Нажмите **Open in Agents** в строке заголовка
- В палитре команд (`Ctrl+Shift+P` / `⌘⇧P`) выполните **Chat: Open Agents Window**
- Выполните в терминале `code --agents`

![Интерфейс окна Agents](https://ru.llmoxy.com/docs-assets/tutorial-vscode-agents/agents-window.png)

При создании сеанса в области ввода выберите рабочее пространство, Agent harness и языковую модель.

![Область ввода нового сеанса](https://ru.llmoxy.com/docs-assets/tutorial-vscode-agents/new-session.png)

## Разрешение Agent Host использовать собственные модели

Сеансы в окне Agents работают через Agent Host. Чтобы использовать модели со своим ключом, как LLMoxy, сначала включите экспериментальный переключатель.

1. Откройте настройки (`Ctrl+,` / `⌘,`)
2. Найдите `agentHost.byok`
3. Отметьте **Chat > Agent Host: Byok Models Enabled** (`chat.agentHost.byokModels.enabled`)

Если вы не хотите входить в GitHub и используете только LLMoxy, отметьте также **Chat > Agent Host: Allow Signed Out When Usable** (`chat.agentHost.allowSignedOutWhenUsable`).

Можно также записать их прямо в `settings.json`:

```json
{
  "chat.agentHost.byokModels.enabled": true,
  "chat.agentHost.allowSignedOutWhenUsable": true
}
```

> **💡 Подсказка**
> Оба параметра по умолчанию выключены. Если их не включить, модели LLMoxy будут видны в представлении Chat, но недоступны для выбора в окне Agents.

## Добавление пользовательской конечной точки LLMoxy

Подключайтесь через **Custom Endpoint** (пользовательская конечная точка) в VS Code, не используйте устаревший пункт OpenAI Compatible.

### 1. Откройте управление языковыми моделями

В поле ввода Chat или окна Agents откройте селектор моделей и нажмите значок шестерёнки **Manage Language Models** либо выполните в палитре команд **Chat: Manage Language Models**.

![Селектор моделей в поле ввода Chat](https://ru.llmoxy.com/docs-assets/tutorial-vscode-agents/model-picker.png)

![Менеджер языковых моделей](https://ru.llmoxy.com/docs-assets/tutorial-vscode-agents/language-models-editor.png)

### 2. Добавьте пользовательскую конечную точку

1. Нажмите **Add Models**
2. Выберите **Custom Endpoint**
3. В качестве имени группы введите `LLMoxy` (оно отображается в списке моделей)
4. Укажите отображаемое имя и API Key (токен LLMoxy)
5. В качестве типа API выберите **Chat Completions**

![Выбор поставщика моделей](https://ru.llmoxy.com/docs-assets/tutorial-vscode-agents/add-provider.png)

### 3. Отредактируйте chatLanguageModels.json

VS Code откроет `chatLanguageModels.json`. Сохраните его, как показано ниже (замените ключ на свой токен):

```json
[
  {
    "name": "LLMoxy",
    "vendor": "customendpoint",
    "apiKey": "${input:llmoxyApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "gpt-6-astra",
        "name": "GPT-6 Astra",
        "url": "https://llmoxy.com/v1/chat/completions",
        "apiType": "chat-completions",
        "toolCalling": true,
        "vision": true,
        "thinking": true,
        "maxInputTokens": 922000,
        "maxOutputTokens": 128000,
        "supportsReasoningEffort": ["low", "medium", "high", "xhigh", "max"],
        "reasoningEffortFormat": "chat-completions"
      },
      {
        "id": "grok-4.7",
        "name": "Grok 4.7",
        "url": "https://llmoxy.com/v1/chat/completions",
        "apiType": "chat-completions",
        "toolCalling": true,
        "vision": true,
        "thinking": true,
        "maxInputTokens": 500000,
        "maxOutputTokens": 128000
      }
    ]
  }
]
```

После сохранения в селекторе моделей должны появиться **GPT-6 Astra** и **Grok 4.7**. Если их нет, перезапустите VS Code.

## Переключение модели в окне Agents

1. Откройте окно Agents, создайте или выберите сеанс
2. В селекторе моделей в поле ввода выберите модель из группы LLMoxy
3. Для моделей с рассуждением нажмите **>** рядом с названием и задайте Thinking Effort (например, Low / Medium / High)

![Подменю Thinking Effort](https://ru.llmoxy.com/docs-assets/tutorial-vscode-agents/thinking-effort.png)

Селектор покажет что-то вроде `GPT-6 Astra · High`. Сеанс запомнит выбранный уровень усилия.

> **⚠️ Внимание**
> В недоверенном рабочем пространстве (Restricted Mode) селектор показывает только **Auto**. Сначала доверьте рабочее пространство.
> В корпоративном Copilot может быть отключён параметр **Bring Your Own Language Model Key in VS Code**; администратору нужно включить его в политике GitHub Copilot.

## Частые вопросы

- **В окне Agents нет моделей LLMoxy**: убедитесь, что включён `chat.agentHost.byokModels.enabled` и у модели `toolCalling` равен `true`
- **422 / model not found**: проверьте, что `id` совпадает с консолью, например `gpt-6-astra`, `grok-4.7`
- **401 / Invalid token**: при копировании токена не захватывайте пробелы и переводы строки; убедитесь, что ключ не отключён и лимит не превышен
- **Неверный адрес**: выберите тип API **Chat Completions**, а в `url` укажите `https://llmoxy.com/v1/chat/completions`
- **Ключ для генерации изображений не работает с текстовыми моделями**: для генерации изображений используйте отдельный ключ из «группы генерации изображений GPT Image 2» и не смешивайте его с текстовыми моделями

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/vscode-agents.
