# Tutoriel fenêtre Agents VS Code

> Connectez LLMoxy dans la fenêtre Agents de VS Code avec un point de terminaison personnalisé, configurez la clé API et l'ID du modèle, et faites utiliser vos propres modèles aux sessions Agent Host.

Site web : [https://code.visualstudio.com/ (cliquez pour accéder au téléchargement !)](https://code.visualstudio.com/)

Références officielles : [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)

> **📌 À propos de la fenêtre Agents**
> La fenêtre Agents est l'espace de travail d'agents autonome de VS Code : elle sert à créer des sessions, choisir un modèle et suivre les tâches. Cet article explique uniquement comment y configurer LLMoxy, sans détailler la gestion des sessions.

## Préparation

- [VS Code](https://code.visualstudio.com/) est installé (une version stable récente ou Insiders est conseillée)
- Un jeton est créé dans la console LLMoxy, voir [Obtenir un jeton](https://fr.llmoxy.com/docs/get-started/get-token)
- Il est conseillé d'utiliser un jeton du groupe **default** (modèles textuels GPT) ; ne mélangez pas avec une clé de génération d'images

Informations de connexion :

| Élément | Valeur |
| --- | --- |
| Passerelle | `https://llmoxy.com` |
| Chat Completions | `https://llmoxy.com/v1/chat/completions` |
| Clé API | Le jeton copié depuis la console |
| Modèles recommandés | `gpt-6-astra`, `grok-4.7` |

L'agent doit pouvoir appeler des outils : dans la configuration du modèle, `toolCalling` doit valoir `true`, sinon le modèle n'apparaît pas dans la liste des modèles de la fenêtre Agents.

## Ouvrir la fenêtre Agents

Au choix :

- Cliquez sur **Open in Agents** dans la barre de titre
- Dans la palette de commandes (`Ctrl+Shift+P` / `⌘⇧P`), exécutez **Chat: Open Agents Window**
- Exécutez `code --agents` dans le terminal

![Interface de la fenêtre Agents](https://fr.llmoxy.com/docs-assets/tutorial-vscode-agents/agents-window.png)

Lors de la création d'une session, choisissez l'espace de travail, l'Agent harness et le modèle de langage dans la zone de saisie.

![Zone de saisie d'une nouvelle session](https://fr.llmoxy.com/docs-assets/tutorial-vscode-agents/new-session.png)

## Autoriser Agent Host à utiliser vos propres modèles

Les sessions de la fenêtre Agents passent par Agent Host. Pour utiliser un modèle avec votre propre clé comme LLMoxy, activez d'abord l'option expérimentale.

1. Ouvrez les paramètres (`Ctrl+,` / `⌘,`)
2. Recherchez `agentHost.byok`
3. Cochez **Chat > Agent Host: Byok Models Enabled** (`chat.agentHost.byokModels.enabled`)

Si vous ne souhaitez pas vous connecter à GitHub et n'utiliser que LLMoxy, cochez aussi **Chat > Agent Host: Allow Signed Out When Usable** (`chat.agentHost.allowSignedOutWhenUsable`).

Vous pouvez aussi l'écrire directement dans `settings.json` :

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

> **💡 Astuce**
> Ces deux options sont désactivées par défaut. Sans les activer, les modèles LLMoxy sont visibles dans la vue Chat, mais impossibles à sélectionner dans la fenêtre Agents.

## Ajouter un point de terminaison personnalisé LLMoxy

Utilisez le **Custom Endpoint** (point de terminaison personnalisé) de VS Code, et n'utilisez plus l'ancienne entrée OpenAI Compatible, désormais obsolète.

### 1. Ouvrir la gestion des modèles de langage

Dans la zone de saisie de Chat ou de la fenêtre Agents, ouvrez le sélecteur de modèle puis cliquez sur l'engrenage **Manage Language Models**, ou exécutez **Chat: Manage Language Models** dans la palette de commandes.

![Sélecteur de modèle dans la zone de saisie de Chat](https://fr.llmoxy.com/docs-assets/tutorial-vscode-agents/model-picker.png)

![Gestionnaire de modèles de langage](https://fr.llmoxy.com/docs-assets/tutorial-vscode-agents/language-models-editor.png)

### 2. Ajouter un point de terminaison personnalisé

1. Cliquez sur **Add Models**
2. Choisissez **Custom Endpoint**
3. Saisissez `LLMoxy` comme nom de groupe (il s'affichera dans la liste des modèles)
4. Renseignez le nom affiché et la clé API (jeton LLMoxy)
5. Choisissez **Chat Completions** comme type d'API

![Choisir le fournisseur de modèles](https://fr.llmoxy.com/docs-assets/tutorial-vscode-agents/add-provider.png)

### 3. Modifier chatLanguageModels.json

VS Code ouvre `chatLanguageModels.json`. Enregistrez le contenu ci-dessous (remplacez la clé par votre propre jeton) :

```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
      }
    ]
  }
]
```

Après l'enregistrement, **GPT-6 Astra** et **Grok 4.7** doivent apparaître dans le sélecteur de modèle. Sinon, redémarrez VS Code une fois.

## Changer de modèle dans la fenêtre Agents

1. Ouvrez la fenêtre Agents, puis créez ou sélectionnez une session
2. Dans le sélecteur de modèle de la zone de saisie, choisissez un modèle sous LLMoxy
3. Pour un modèle de raisonnement, cliquez sur **>** à côté du nom afin de définir le Thinking Effort (par exemple Low / Medium / High)

![Sous-menu Thinking Effort](https://fr.llmoxy.com/docs-assets/tutorial-vscode-agents/thinking-effort.png)

Le sélecteur affiche quelque chose comme `GPT-6 Astra · High`. La session mémorise ce niveau d'effort.

> **⚠️ Attention**
> Dans un espace de travail non approuvé (Restricted Mode), le sélecteur n'affiche que **Auto**. Approuvez d'abord l'espace de travail.
> Copilot Entreprise peut désactiver **Bring Your Own Language Model Key in VS Code** ; un administrateur doit alors l'activer dans les politiques GitHub Copilot.

## Questions fréquentes

- **Aucun modèle LLMoxy dans la fenêtre Agents** : vérifiez que `chat.agentHost.byokModels.enabled` est activé et que `toolCalling` vaut `true` pour ce modèle
- **422 / model not found** : vérifiez que `id` correspond à celui de la console, par exemple `gpt-6-astra`, `grok-4.7`
- **401 / Invalid token** : lors de la copie du jeton, n'incluez ni espaces ni retours à la ligne ; vérifiez que la clé n'est pas désactivée et que le quota n'est pas dépassé
- **Adresse incorrecte** : choisissez **Chat Completions** comme type d'API et saisissez `https://llmoxy.com/v1/chat/completions` dans `url`
- **Une clé de génération d'images échoue avec un modèle textuel** : pour la génération d'images, utilisez la clé dédiée du « groupe de génération d'images GPT Image 2 » et ne la mélangez pas avec les modèles textuels

Ceci est la version markdown de https://fr.llmoxy.com/docs/code-tutorials/vscode-agents.
