Skip to main content

Installation et authentification

Installez la CLI Bailian et les Skills, configurez l'authentification et vérifiez.

Cette page explique comment installer la CLI Bailian, installer les Skills associées et configurer l'authentification.

Prérequis

  • Accès réseau (soit le registre npm, soit bailian.aliyun.com, selon la méthode d'installation que vous choisissez ci-dessous).
  • Pour la méthode npm : Node.js >= 18.17.0 (vérifiez avec node -v) et npm (vérifiez avec npm -v). Si vous n'avez pas Node.js, ou si votre version est trop ancienne, utilisez plutôt le script d'installation binaire ci-dessous — Node.js n'est pas requis.

Installer la CLI

  • npm (Node.js existant)
  • Script binaire (Node.js non requis)
npm install -g bailian-cli
Même si pnpm / yarn est installé, utilisez npm pour installer bailian-cli — n'utilisez pas pnpm / yarn pour installer la CLI.
Après l'installation, deux commandes sont ajoutées à votre PATH : bl (alias court) et bailian (nom complet). Vérifiez :
bl --version
which bl   # use "where bl" on Windows
Exécutez bl update à tout moment pour vérifier et installer la dernière version de la CLI.
Si vous voyez command not found, vérifiez que le répertoire bin global est dans votre PATH : pour l'installation npm, exécutez npm config get prefix et ajoutez son sous-répertoire bin au PATH ; pour l'installation binaire, ajoutez le chemin imprimé par le script d'installation.

Appeler via Alibaba Cloud CLI

Si l'Alibaba Cloud CLI est installé, appelez les mêmes commandes via aliyun bl :
aliyun bl --version
aliyun bl auth status
L'aide, les exemples, les conseils de récupération et les commandes structurées suivent le point d'entrée aliyun bl. Les identifiants AccessKey fournis par l'hôte Alibaba Cloud CLI sont traités comme des variables d'environnement Alibaba Cloud et n'ont pas besoin d'être enregistrés à nouveau dans la configuration bl.

Installer les Skills

Une fois la CLI vérifiée, installez les Skills associées afin que votre Agent bénéficie de l'ensemble des capacités de Bailian. La méthode recommandée, en une seule étape, est la commande d'amorçage intégrée de la CLI :
bl skill init
Cela installe chaque Skill bailian-* dans le registre (ainsi que le bailian-protocol partagé) en une seule fois, et c'est le chemin d'installation officiellement recommandé. Si bl skill init n'est pas disponible, utilisez plutôt l'outil skills (il nécessite Git sur la machine ; le dernier package skills nécessite Node.js >= 22.20, donc épinglez skills@1.5.18 sur Node.js 18) :
npx skills@1.5.18 add modelstudioai/cli --skill '*' -g
Pour installer une seule Skill, remplacez --skill '*' par son nom ; --list affiche toutes les Skills du référentiel.

Configurer l'authentification

Vous devez vous authentifier avant d'appeler toute API. Choisissez l'une des méthodes ci-dessous en fonction de votre environnement.
  • Connexion à la console (recommandé)
  • API Key standard
  • Token Plan
  • Jeton d'accès AK/SK
  • Variable d'environnement
Idéal pour les installations locales interactives — pas besoin de copier manuellement une API Key. Cette commande ouvre un navigateur pour terminer la connexion et l'autorisation de la console Alibaba Cloud :
bl auth login --console --console-site international
Cela débloque également les fonctionnalités de la console telles que app list et usage free, et configure automatiquement les identifiants nécessaires pour les appels API Key. Si aucun navigateur ne peut être ouvert, utilisez bl auth login --console --console-site international --no-browser pour afficher l'URL de connexion, ou importez un jeton d'accès depuis stdin avec --token-stdin.
Les API Keys standard et les clés d'abonnement Token Plan diffèrent comme suit :
AspectAPI Key standardClé API Token Plan
FacturationPaiement à l'usage (inclut le quota gratuit pour les nouveaux utilisateurs)Déduit de votre quota d'abonnement Token Plan
PortéeAppels de service de modèleAppels aux modèles pris en charge par le Token Plan
Utilisation typiquePas d'abonnement, ou paiement à l'usageAbonnés au Token Plan consommant d'abord le quota du plan
Configurationbl auth login --api-key <Key>bl auth login --config token-plan --api-key <sk-sp-Key> --base-url https://token-plan.ap-southeast-1.maas.aliyuncs.com

Vérifier

La commande de connexion teste déjà la fonctionnalité, vous n'avez donc qu'à confirmer l'état de la configuration :
bl auth status --output json
Aucun test d'appel de modèle répété n'est nécessaire. Si la connexion échoue, utilisez le hint ou le message dans la sortie pour le dépannage (réseau, clé invalide, base_url, etc.).
Lorsque vous signalez l'état de l'authentification, utilisez uniquement les champs masqués. N'affichez jamais une clé API complète et n'écrivez pas de vraies clés dans les référentiels, les journaux ou les parties publiques des enregistrements de chat.

Se déconnecter

Pour effacer les identifiants locaux et vous déconnecter, exécutez :
bl auth logout

Dépannage

Le répertoire bin global n'est pas dans votre PATH. Exécutez npm config get prefix et ajoutez son sous-répertoire bin au PATH, puis réessayez.
Version de Node.js trop ancienne. Mettez à niveau vers >= 18.17.0 et réinstallez.
Non connecté ou clé API invalide. Réexécutez la commande de connexion pour votre type de clé (clé API standard ou Token Plan).
L'identifiant actif est une clé API standard (le profil default). Le Token Plan nécessite que votre clé API d'abonnement soit connectée au profil token-plan ; exécutez bl auth status --output json pour voir quel identifiant est actif.
Connectez-vous avec votre clé API d'abonnement : bl auth login --config token-plan --api-key <sk-sp-Key> --base-url https://token-plan.ap-southeast-1.maas.aliyuncs.com. Si le profil existe déjà, basculez vers celui-ci avec bl config use --name token-plan.
Non. Les commandes d'appel de modèle fonctionnent ; les fonctionnalités de la console (telles que app list, usage free, workspace) nécessitent une connexion à la console (bl auth login --console --console-site international), et la gestion des postes du Token Plan nécessite en outre des identifiants AK/SK OpenAPI Alibaba Cloud. Consultez Configurer l'authentification pour la comparaison.
Exécutez bl auth status --output json pour inspecter l'identifiant actif (masqué), bl config list pour lister tous les profils, et bl config use --name <profile> pour changer le profil actif.
Configurez un miroir ou un proxy, puis réinstallez.
Utilisez plutôt le script d'installation binaire (Node.js/npm non requis) : curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash. Vous pouvez également installer ou réparer npm d'abord, puis utiliser npm install -g bailian-cli — mais n'utilisez pas pnpm / yarn pour installer la CLI.