Skip to main content

Instalación y autenticación

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 con npm -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)
  • Script binario (no requiere Node.js)
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.
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.
Si 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.

Invocar mediante Alibaba Cloud CLI

Si Alibaba Cloud CLI está instalado, invoque los mismos comandos mediante aliyun bl: 
aliyun bl --version
aliyun bl auth status
La ayuda, los ejemplos, las sugerencias de recuperación y los comandos estructurados siguen el punto de entrada aliyun bl. Las credenciales AccessKey proporcionadas por el host de Alibaba Cloud CLI se tratan como variables de entorno de Alibaba Cloud y no es necesario volver a guardarlas en la configuración de bl.

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)
  • API Key estándar
  • Plan de tokens
  • Token de acceso AK/SK
  • Variable de entorno
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 --console-site international
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. Si no se puede abrir un navegador, usa bl auth login --console --console-site international --no-browser para mostrar la URL de inicio de sesión, o importa un token de acceso desde stdin con --token-stdin.
Las API Keys estándar y las claves de suscripción del Plan de Tokens difieren de la siguiente manera:
AspectoAPI Key estándarAPI Key de Token Plan
FacturaciónPago por uso (incluye cuota gratuita para nuevos usuarios)Se deduce de la cuota de su suscripción Token Plan
AlcanceLlamadas a servicios de modelosLlamadas a modelos compatibles con Token Plan
Uso típicoSin suscripción o pago por usoSuscriptores de Token Plan que consumen primero la cuota del plan
Configuraciónbl 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

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

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.
Versión de Node.js demasiado baja. Actualice a >= 18.17.0 y reinstale.
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).
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.
Inicie sesión con su API Key de suscripción: bl auth login --config token-plan --api-key <sk-sp-Key> --base-url https://token-plan.ap-southeast-1.maas.aliyuncs.com. Si el perfil ya existe, cambie a él con bl config use --name 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 --console-site international), 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.
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.
Configure un espejo o proxy, luego reinstale.
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.