Skip to Content
aicentos

Craft Agent

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

Dernière mise à jour:

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é.

Installez le client de bureau :

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

ChampValeur
Type de connexionCustom (personnalisé)
Protocoleopenai-completions, ou anthropic-messages
Base URLhttps://aicentos.com/v1 (compatible OpenAI) / https://aicentos.com (compatible Anthropic)
API Keyclé créée dans la console
Modèlenom 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 :

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 :

{
  "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

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).
  • 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