# Zed Agent

Source: https://docs.aicentos.com/fr/clients/zed-agent

Language: fr

> Connecter aicentos à l'Agent Panel de Zed via un provider compatible OpenAI

Zed intègre un type de provider compatible OpenAI : en déclarant le point d'accès, les modèles et la longueur de contexte dans `settings.json`, l'Agent Panel peut utiliser les modèles intégrés par aicentos.

## Prérequis

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Zed (nommez-la par exemple `zed-agent`).

* 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)

Zed n'écrit pas la clé API dans `settings.json` : il lit une variable d'environnement homonyme. L'ID du provider est converti en majuscules avec des underscores, auquel s'ajoute le suffixe `_API_KEY`. Ainsi, avec l'ID de provider `aicentos`, la variable d'environnement s'appelle `AICENTOS_API_KEY`.

## Configuration à renseigner

| Champ                           | Valeur                                                              |
| ------------------------------- | ------------------------------------------------------------------- |
| Provider ID                     | personnalisé, par ex. `aicentos`                                    |
| `api_url`                       | `https://aicentos.com/v1`                                           |
| `available_models[].name`       | nom du modèle dans la « place de marché des modèles » de la console |
| `available_models[].max_tokens` | fenêtre de contexte du modèle                                       |
| Clé API                         | variable d'environnement `AICENTOS_API_KEY`                         |

## Étapes de configuration

* Ouvrez le `settings.json` de Zed (commande `zed: open settings` dans la palette de commandes).
* Ajoutez la configuration `language_models.openai_compatible` :

```json
{
  "language_models": {
    "openai_compatible": {
      "aicentos": {
        "api_url": "https://aicentos.com/v1",
        "available_models": [
          {
            "name": "gpt-5",
            "display_name": "GPT-5 (aicentos)",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}
```

* Exportez la variable d'environnement (écrivez-la dans `~/.zshrc` puis rechargez) :

```bash
export AICENTOS_API_KEY="sk-votre-clé-aicentos"
```

* Ouvrez l'Agent Panel et sélectionnez dans le menu déroulant des modèles un modèle de ce provider.

Vous pouvez aussi cliquer sur **Add Provider** dans les réglages de l'Agent et renseigner via l'interface graphique le nom du provider, l'URL API, l'ID du modèle et la fenêtre de contexte.

## Test

Une fois la configuration terminée, créez une nouvelle conversation dans l'Agent Panel et faites d'abord un test léger avec une invite simple ; ne passez aux appels d'outils qu'une fois les retours confirmés.

## Remarques

* `api_url` s'arrête à `https://aicentos.com/v1`, ne le complétez pas en chemin complet `/chat/completions` ; Zed construit lui-même le chemin.
* La clé API ne doit pas être écrite directement dans `settings.json` : utilisez une variable d'environnement (ou enregistrez-la via l'interface de réglages du provider dans le trousseau système) ; une variable d'environnement non vide prime sur le trousseau.
* `max_tokens` correspond à la fenêtre de contexte ; renseignez la valeur réelle du modèle, car une absence entraîne une gestion anormale du contexte.
* Les appels d'outils sont activés par défaut (`capabilities.tools`) ; la saisie d'images et les appels d'outils parallèles sont désactivés par défaut, à activer manuellement si besoin.
* Documentation officielle : [https://zed.dev/docs/ai/llm-providers](https://zed.dev/docs/ai/llm-providers)
* Pour plus de détails, consultez le site de documentation : [https://docs.aicentos.com](https://docs.aicentos.com)