# GitHub Copilot

Source: https://docs.aicentos.com/fr/clients/copilot

Language: fr

> Connecter aicentos à GitHub Copilot Chat via BYOK (clé personnelle) sur le point de terminaison compatible OpenAI

Dans VS Code, GitHub Copilot offre la capacité BYOK (Bring Your Own Key) qui permet de diriger les requêtes de conversation vers un point de terminaison personnalisé compatible OpenAI. Réglez le point de terminaison sur aicentos et renseignez la clé créée dans la console pour utiliser, dans Copilot Chat / Agent, les modèles intégrés par aicentos.

## Prérequis

Créez d'abord, sur la page « API Key » de la console, une clé dédiée pour Copilot (nommez-la par exemple `copilot-vscode` ou `copilot-work`, pour suivre plus facilement sa consommation).

* Console : [https://aicentos.com](https://aicentos.com)
* Créer une clé : [https://aicentos.com/keys](https://aicentos.com/keys)
* Recharger le portefeuille : [https://aicentos.com/wallet](https://aicentos.com/wallet)

Vérifiez aussi que VS Code et l'extension GitHub Copilot Chat de votre machine sont à jour, dans une version prenant en charge les points de terminaison personnalisés ; les versions plus anciennes n'offrent le BYOK que pour les fournisseurs intégrés, sans entrée générique de « point de terminaison personnalisé ».

## Configuration à renseigner

| Champ        | Valeur                                                                     |
| ------------ | -------------------------------------------------------------------------- |
| Provider     | Custom Endpoint (OpenAI Compatible dans les versions antérieures)          |
| Base URL     | `https://aicentos.com/v1`                                                  |
| Type d'API   | Chat Completions (correspond à `https://aicentos.com/v1/chat/completions`) |
| API Key      | clé créée dans la console                                                  |
| Model ID     | nom du modèle dans la « place de marché des modèles » de la console        |
| Tool Calling | `true` (obligatoire pour une utilisation en mode Agent)                    |

## Étapes de configuration

### Méthode 1 : interface graphique

* Ouvrez la vue Chat de VS Code.
* Cliquez sur le sélecteur de modèles au-dessus de la zone de saisie et choisissez **Manage Language Models** (**Manage Models...** dans les versions antérieures).
* Cliquez sur **Add Models** puis sélectionnez **Custom Endpoint** dans la liste des fournisseurs (**OpenAI Compatible** dans les versions antérieures).
* Saisissez le nom du groupe et l'API Key.
* Choisissez **Chat Completions** comme type d'API.
* Complétez les informations du modèle comme demandé : `id` reçoit le nom du modèle de la console, `url` reçoit `https://aicentos.com/v1/chat/completions`.
* Après enregistrement, revenez au Chat et sélectionnez le modèle ajouté dans le menu déroulant.

### Méthode 2 : settings.json

Exécutez **Preferences: Open User Settings (JSON)** dans la palette de commandes, puis ajoutez :

```json
{
  "github.copilot.chat.customOAIModels": {
    "aicentos-gpt": {
      "name": "aicentos GPT",
      "url": "https://aicentos.com/v1/chat/completions",
      "toolCalling": true,
      "vision": false,
      "maxInputTokens": 128000,
      "maxOutputTokens": 16384
    }
  }
}
```

La clé au niveau le plus externe de l'objet (par ex. `aicentos-gpt`) est l'ID de modèle que vous verrez dans le sélecteur de modèles ; il doit être unique.

Documentation officielle de référence : [https://code.visualstudio.com/docs/copilot/customization/language-models](https://code.visualstudio.com/docs/copilot/customization/language-models)

## Test

Après enregistrement des réglages, créez une nouvelle conversation dans le Chat et faites d'abord un test léger avec une invite simple ; si la réponse revient normalement, la connexion est établie, et vous pouvez utiliser les modes Agent / Edit.

## Remarques

* BYOK ne s'applique qu'à **Chat / Agent / Edit** et ne couvre pas la complétion de code en ligne (complétion Tab) ; la recherche sémantique, les embeddings et autres capacités continuent de passer par le service intégré de Copilot.
* Pour une utilisation en mode **Agent**, le modèle doit prendre en charge le **tool calling** et `toolCalling` doit être réglé sur `true` ; sinon le modèle n'apparaît pas dans le sélecteur de modèles.
* Le champ `url` doit contenir l'URL complète `https://aicentos.com/v1/chat/completions`, pas seulement jusqu'à `/v1`.
* `github.copilot.chat.customOAIModels` est l'ancienne écriture ; les versions récentes utilisent `chatLanguageModels.json` avec `customendpoint` ; référez-vous à l'entrée réelle de votre version de VS Code.
* Avec GitHub Copilot Business / Enterprise, l'administrateur peut désactiver le BYOK par stratégie.
* Si le modèle ajouté n'apparaît pas immédiatement, redémarrez VS Code.
* En cas d'erreur, vérifiez successivement : la clé ne contient pas d'espaces superflus, le nom du modèle correspond à la console, le solde du compte est suffisant, le type d'API est bien choisi. En cas de solde insuffisant, rechargez sur [https://aicentos.com/wallet](https://aicentos.com/wallet).