Instale la CLI y las Skills de Bailian, configure la autenticación y verifique.
Esta página explica cómo instalar la CLI de Bailian, instalar las Skills complementarias y configurar la autenticación.
Requisitos previos
- Acceso a la red (ya sea al registro de npm o a
bailian.aliyun.com, dependiendo del método de instalación que elija a continuación). - Para el método npm: Node.js >= 18.17.0 (verifique con
node -v) y npm (verifique connpm -v). Si no tiene Node.js o su versión es demasiado antigua, utilice el script de instalación binaria a continuación; no se requiere Node.js.
Instalar la CLI
npm (Node.js existente)
npm install -g bailian-cli
Incluso si pnpm / yarn está instalado, use npm para instalar bailian-cli; no utilice pnpm / yarn para instalar la CLI.
Script binario (no requiere Node.js)
macOS / Linux:
curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash
Windows (PowerShell):
irm https://bailian.aliyun.com/cli/install.ps1 | iex
Después de la instalación, se agregan dos comandos a su PATH: bl (alias corto) y bailian (nombre completo). Verifique:
bl --version
which bl # use "where bl" on Windows
Ejecute bl update en cualquier momento para buscar e instalar la versión más reciente de la CLI.
NotaSi ve command not found, compruebe que el directorio bin global esté en su PATH: para la instalación con npm, ejecute npm config get prefix y agregue su subdirectorio bin al PATH; para la instalación binaria, agregue la ruta mostrada por el script de instalación.
Instalar Skills
Una vez verificada la CLI, instale las Skills complementarias para que su Agent obtenga la gama completa de capacidades de Bailian. El método recomendado de un solo paso es el comando de arranque integrado de la CLI:
bl skill init
Esto instala cada Skill bailian-* del registro (más la compartida bailian-protocol) de una sola vez, y es la ruta de instalación recomendada oficialmente. Si bl skill init no está disponible, utilice la herramienta skills en su lugar (requiere Git en la máquina; el paquete más reciente de skills requiere Node.js >= 22.20, así que fije skills@1.5.18 en Node.js 18):
npx skills@1.5.18 add modelstudioai/cli --skill '*' -g
Para instalar una sola Skill, reemplace --skill '*' con su nombre; --list muestra todas las Skills del repositorio.
Configurar autenticación
Debe autenticarse antes de llamar a cualquier API. Elija uno de los métodos siguientes según su entorno.
Inicio de sesión en consola (recomendado)
Ideal para instalaciones locales interactivas: no es necesario copiar una API Key manualmente. Este comando abre un navegador para completar el inicio de sesión y la autorización en la consola de Alibaba Cloud:
bl auth login --console
Esto también habilita capacidades de la consola como app list y usage free, y configura automáticamente las credenciales necesarias para las llamadas de API Key.
API Key estándar
Ideal para entornos donde no se puede iniciar un navegador (SSH remoto, CI, etc.). Obtenga una clave desde la página de API Key de la consola de BailianBailian console API Key y luego ejecute:
bl auth login --api-key <your_API_Key>
El comando de inicio de sesión prueba la Key antes de guardarla.
Plan de tokens
Utilice la API Key de su suscripción Token Plan:
bl auth login --config token-plan --api-key <your_API_Key>
El perfil token-plan incluye una URL base predeterminada integrada, por lo que no se requiere configuración adicional del endpoint.
Token de acceso AK/SK
Para generar un token de acceso de CLI desde una AccessKey de Alibaba Cloud (por ejemplo, para usar con herramientas como Postman). Se requieren --access-key-id y --access-key-secret:
bl auth generate-access-token --access-key-id <AccessKey ID> --access-key-secret <AccessKey Secret>
El token de acceso temporal generado se puede utilizar para llamadas posteriores, evitando la exposición prolongada de su AK/SK; agregue --security-token cuando utilice credenciales temporales STS.
Variable de entorno
No se guarda en un archivo de configuración: defina DASHSCOPE_API_KEY en su shell (el endpoint se puede sobrescribir con BAILIAN_BASE_URL). Ideal para entornos de CI o no interactivos; inyéctelo mediante gestión de secretos en lugar de codificarlo directamente en scripts.
Las API Keys estándar y las claves de suscripción del Plan de Tokens difieren de la siguiente manera:
| Aspecto | API Key estándar | API Key de Token Plan |
|---|---|---|
| Facturación | Pago por uso (incluye cuota gratuita para nuevos usuarios) | Se deduce de la cuota de su suscripción Token Plan |
| Alcance | Llamadas a servicios de modelos | Llamadas a modelos compatibles con Token Plan |
| Uso típico | Sin suscripción o pago por uso | Suscriptores de Token Plan que consumen primero la cuota del plan |
| Configuración | bl auth login --api-key <Key> | bl auth login --config token-plan --api-key <sk-sp-Key> |
Verificar
El comando de inicio de sesión ya prueba la usabilidad, por lo que solo necesita confirmar el estado de la configuración:
bl auth status --output json
No es necesario realizar pruebas repetidas de llamada al modelo. Si el inicio de sesión falla, utilice hint o message en la salida para solucionar problemas (red, clave no válida, base_url, etc.).
AdvertenciaAl reportar el estado de autenticación, utilice únicamente campos enmascarados. Nunca muestre una API Key completa y no escriba claves reales en repositorios, registros ni en las partes públicas de los historiales de chat.
Cerrar sesión
Para borrar las credenciales locales y cerrar sesión, ejecute:
bl auth logout
Solución de problemas
bl: comando no encontrado
El directorio bin global no está en su PATH. Ejecute npm config get prefix y agregue su subdirectorio bin al PATH, luego inténtelo de nuevo.
Error de engines durante la instalación
Versión de Node.js demasiado baja. Actualice a >= 18.17.0 y reinstale.
401 / fallo de autenticación
No ha iniciado sesión o la API Key no es válida. Vuelva a ejecutar el comando de inicio de sesión para su tipo de clave (API Key estándar o Token Plan).
¿Por qué una llamada a modelo desde la CLI no descuenta de mi Token Plan?
La credencial activa es una API Key estándar (el perfil default). Token Plan requiere que su API Key de suscripción haya iniciado sesión en el perfil token-plan; ejecute bl auth status --output json para ver qué credencial está activa.
¿Cómo hago que las llamadas a modelos desde la CLI usen mi Token Plan?
Inicie sesión con su API Key de suscripción: bl auth login --config token-plan --api-key <sk-sp-Key>. Si el perfil ya existe, cambie a él con bl config use --name token-plan.
¿Puedo usar todas las funciones de la CLI solo con una API Key de Token Plan?
No. Los comandos de llamada al modelo funcionan; las funciones de consola (como app list, usage free, workspace) requieren inicio de sesión en la consola (bl auth login --console), y la gestión de asientos de Token Plan necesita además credenciales AK/SK de OpenAPI de Alibaba Cloud. Consulte Configurar autenticación para ver la comparación.
¿Cómo verifico y cambio la API Key activa?
Ejecute bl auth status --output json para inspeccionar la credencial activa (enmascarada), bl config list para listar todos los perfiles y bl config use --name <profile> para cambiar el perfil activo.
La red corporativa no puede acceder a npm
Configure un espejo o proxy, luego reinstale.
Solo hay pnpm disponible, sin npm
Utilice el script de instalación binaria en su lugar (no requiere Node.js/npm): curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash. Alternativamente, instale o repare npm primero y luego use npm install -g bailian-cli, pero no utilice pnpm / yarn para instalar la CLI.