# Craft Agent

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

Language: fr

> Connecter aicentos à Craft Agent — connexion personnalisée compatible OpenAI, valable pour le client de bureau comme pour craft-cli

La connexion LLM de Craft Agent prend en charge le type `Custom`, décrit officiellement comme « n'importe quelle URL, n'importe quel endpoint compatible OpenAI ou compatible Anthropic ». Pointez la Base URL vers aicentos : le client de bureau comme `craft-cli` peuvent l'utiliser.

## Prérequis

Créez d'abord dans la console une clé dédiée pour Craft Agent (nommez-la par exemple `craft-agent`), pour suivre facilement la consommation par clé.

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

Installez le client de bureau :

```bash
curl -fsSL https://thecraftagents.com/install-app.sh | bash
```

Le mode headless server et l'usage en ligne de commande pure sont également pris en charge.

## Configuration à renseigner

| Champ             | Valeur                                                                                        |
| ----------------- | --------------------------------------------------------------------------------------------- |
| Type de connexion | Custom (personnalisé)                                                                         |
| Protocole         | `openai-completions`, ou `anthropic-messages`                                                 |
| Base URL          | `https://aicentos.com/v1` (compatible OpenAI) / `https://aicentos.com` (compatible Anthropic) |
| API Key           | clé créée dans la console                                                                     |
| Modèle            | nom du modèle dans la « place de marché des modèles » de la console                           |

## Étapes de configuration

Client de bureau : ouvrez les connexions LLM dans les réglages, ajoutez-en une, choisissez le type Custom et renseignez les champs du tableau ci-dessus.

Équivalent en ligne de commande :

```bash
export AICENTOS_API_KEY="sk-votre-clé-API"
craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model votre-nom-de-modèle \
  "bonjour"
```

Vous pouvez aussi modifier directement le fichier de configuration `~/.craft-agent/config.json` :

```json
{
  "llmConnections": [
    {
      "providerType": "pi_compat",
      "baseUrl": "https://aicentos.com/v1",
      "customEndpoint": { "api": "openai-completions" },
      "models": [{ "id": "votre-nom-de-modèle" }],
      "defaultModel": "votre-nom-de-modèle"
    }
  ]
}
```

La clé n'est pas écrite en clair dans la configuration : elle est stockée dans `credentials.enc`, dans le même répertoire. Renseignez-la une fois via l'interface et ne modifiez pas ce fichier à la main.

## Test

```bash
craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model votre-nom-de-modèle \
  "Présente-toi en une phrase"
```

Si la réponse revient normalement, la connexion fonctionne. Retournez ensuite dans la console consulter la consommation pour confirmer que la requête est bien imputée à cette clé.

## Remarques

* Gardez `providerType` sur `pi_compat`, c'est l'identifiant de son endpoint personnalisé ; le remplacer par le nom d'un provider intégré ferait passer par les modèles officiels.
* `models` doit être renseigné à la main : la liste des modèles n'est pas récupérée automatiquement. Le nom doit correspondre exactement à celui de la « place de marché des modèles » de la console (voir [Modèles pris en charge](https://docs.aicentos.com/fr/billing/models-list)).
* Avec l'endpoint compatible Anthropic, la Base URL est `https://aicentos.com`, sans `/v1`, et `--provider` devient `anthropic`.
* L'emplacement des menus du client de bureau varie selon les versions ; si vous ne les trouvez pas, fiez-vous à la syntaxe de `config.json`.

## Liens utiles

* [Documentation Craft Agents](https://thecraftagents.com/docs)
* [Dépôt craft-agents](https://github.com/craft-ai-agents/craft-agents-oss)