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.
Même si pnpm / yarn est installé, utilisez npm pour installer
Après l'installation, deux commandes sont ajoutées à votre PATH :
Exécutez
Si l'Alibaba Cloud CLI est installé, appelez les mêmes commandes via
L'aide, les exemples, les conseils de récupération et les commandes structurées suivent le point d'entrée
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 :
Cela installe chaque Skill
Pour installer une seule Skill, remplacez
Vous devez vous authentifier avant d'appeler toute API. Choisissez l'une des méthodes ci-dessous en fonction de votre environnement.
Les API Keys standard et les clés d'abonnement Token Plan diffèrent comme suit :
La commande de connexion teste déjà la fonctionnalité, vous n'avez donc qu'à confirmer l'état de la configuration :
Aucun test d'appel de modèle répété n'est nécessaire. Si la connexion échoue, utilisez le
Pour effacer les identifiants locaux et vous déconnecter, exécutez :
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 avecnpm -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)
bailian-cli — n'utilisez pas pnpm / yarn pour installer la CLI.bl (alias court) et bailian (nom complet). Vérifiez :
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. 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 :
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) :
--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 :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.| Aspect | API Key standard | Clé API Token Plan |
|---|---|---|
| Facturation | Paiement à l'usage (inclut le quota gratuit pour les nouveaux utilisateurs) | Déduit de votre quota d'abonnement Token Plan |
| Portée | Appels de service de modèle | Appels aux modèles pris en charge par le Token Plan |
| Utilisation typique | Pas d'abonnement, ou paiement à l'usage | Abonnés au Token Plan consommant d'abord le quota du plan |
| Configuration | bl 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 :
hint ou le message dans la sortie pour le dépannage (réseau, clé invalide, base_url, etc.).
Se déconnecter
Pour effacer les identifiants locaux et vous déconnecter, exécutez :
Dépannage
bl : commande introuvable
bl : commande introuvable
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.Erreur d'engines lors de l'installation
Erreur d'engines lors de l'installation
Version de Node.js trop ancienne. Mettez à niveau vers >= 18.17.0 et réinstallez.
401 / échec de l'authentification
401 / échec de l'authentification
Non connecté ou clé API invalide. Réexécutez la commande de connexion pour votre type de clé (clé API standard ou Token Plan).
Pourquoi un appel de modèle CLI ne déduit-il pas de mon Token Plan ?
Pourquoi un appel de modèle CLI ne déduit-il pas de mon 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.Comment faire pour que les appels de modèle CLI utilisent mon Token Plan ?
Comment faire pour que les appels de modèle CLI utilisent mon Token Plan ?
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.Puis-je utiliser toutes les fonctionnalités de la CLI avec uniquement une clé API Token Plan ?
Puis-je utiliser toutes les fonctionnalités de la CLI avec uniquement une clé API 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.Comment vérifier et changer la clé API active ?
Comment vérifier et changer la clé API active ?
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.Le réseau d'entreprise ne peut pas atteindre npm
Le réseau d'entreprise ne peut pas atteindre npm
Configurez un miroir ou un proxy, puis réinstallez.
Seul pnpm est disponible, pas de npm
Seul pnpm est disponible, pas de npm
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.