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é.
- Console : https://aicentos.com
- Créer une clé : https://aicentos.com/keys
- Recharger le portefeuille : https://aicentos.com/wallet
Installez le client de bureau :
curl -fsSL https://thecraftagents.com/install-app.sh | bashLe 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 :
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
providerTypesurpi_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. modelsdoit ê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--providerdevientanthropic. - 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.