Skip to main content

Instalação e Autenticação

Instale a CLI e as Skills do Bailian, configure a autenticação e verifique.

Esta página aborda como instalar a CLI do Bailian, instalar as Skills complementares e configurar a autenticação.

Pré-requisitos

  • Acesso à rede (seja o registro npm ou bailian.aliyun.com, dependendo do método de instalação que você escolher abaixo).
  • Para o método npm: Node.js >= 18.17.0 (verifique com node -v) e npm (verifique com npm -v). Se você não tiver o Node.js, ou sua versão for muito antiga, use o script de instalação binária abaixo — não é necessário Node.js.

Instalar a CLI

  • npm (Node.js existente)
  • Script binário (não requer Node.js)
npm install -g bailian-cli
Mesmo que o pnpm / yarn esteja instalado, use o npm para instalar bailian-cli — não use pnpm / yarn para instalar a CLI.
Após a instalação, dois comandos são adicionados ao seu PATH: bl (alias curto) e bailian (nome completo). Verifique:
bl --version
which bl   # use "where bl" on Windows
Execute bl update a qualquer momento para verificar e instalar a versão mais recente da CLI.
Se você vir command not found, verifique se o diretório bin global está no seu PATH: para a instalação via npm, execute npm config get prefix e adicione seu subdiretório bin ao PATH; para a instalação binária, adicione o caminho impresso pelo script de instalação.

Invocar pela Alibaba Cloud CLI

Se a Alibaba Cloud CLI estiver instalada, invoque os mesmos comandos com aliyun bl:
aliyun bl --version
aliyun bl auth status
Ajuda, exemplos, dicas de recuperação e comandos estruturados seguem o ponto de entrada aliyun bl. As credenciais AccessKey fornecidas pelo host da Alibaba Cloud CLI são tratadas como variáveis de ambiente da Alibaba Cloud e não precisam ser armazenadas novamente na configuração do bl.

Instalar Skills

Depois que a CLI for verificada, instale as Skills complementares para que seu Agent obtenha a gama completa de recursos do Bailian. O método recomendado e de uma única etapa é o comando de inicialização integrado da CLI:
bl skill init
Isso instala cada Skill bailian-* no registro (mais a bailian-protocol compartilhada) de uma só vez, e é o caminho de instalação oficialmente recomendado. Se bl skill init não estiver disponível, use a ferramenta skills em vez disso (ela requer Git na máquina; o pacote skills mais recente requer Node.js >= 22.20, então fixe skills@1.5.18 no Node.js 18):
npx skills@1.5.18 add modelstudioai/cli --skill '*' -g
Para instalar uma única Skill, substitua --skill '*' pelo seu nome; --list mostra todas as Skills no repositório.

Configurar autenticação

Você deve se autenticar antes de chamar qualquer API. Escolha um dos métodos abaixo com base no seu ambiente.
  • Login no console (recomendado)
  • Standard API Key
  • Token Plan
  • Token de acesso AK/SK
  • Variável de ambiente
Ideal para instalações locais interativas — não é necessário copiar uma API Key manualmente. Este comando abre um navegador para concluir o login e a autorização no console do Alibaba Cloud:
bl auth login --console --console-site international
Isso também desbloqueia recursos do console, como app list e usage free, e configura automaticamente as credenciais necessárias para chamadas de API Key. Se nenhum navegador puder ser aberto, use bl auth login --console --console-site international --no-browser para exibir a URL de login, ou importe um token de acesso do stdin com --token-stdin.
As chaves de assinatura Standard API Keys e Token Plan diferem da seguinte forma:
AspectoStandard API KeyAPI Key do Token Plan
CobrançaPay-as-you-go (inclui cota gratuita para novos usuários)Deduz da cota de assinatura do seu Token Plan
EscopoChamadas de serviço de modeloChamadas para modelos suportados pelo Token Plan
Uso típicoSem assinatura, ou pay-as-you-goAssinantes do Token Plan consumindo a cota do plano primeiro
Configuraçãobl 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

O comando de login já testa a usabilidade, então você só precisa confirmar o status da configuração:
bl auth status --output json
Nenhum teste repetido de chamada de modelo é necessário. Se o login falhar, use o hint ou message na saída para solucionar problemas (rede, Key inválida, base_url, etc.).
Ao relatar o status de autenticação, use apenas campos mascarados. Nunca exiba uma API Key completa e não escreva Keys reais em repositórios, logs ou partes públicas de registros de chat.

Sair

Para limpar as credenciais locais e sair, execute:
bl auth logout

Solução de problemas

O diretório bin global não está no seu PATH. Execute npm config get prefix e adicione seu subdiretório bin ao PATH, então tente novamente.
Versão do Node.js muito baixa. Atualize para >= 18.17.0 e reinstale.
Não conectado ou API Key inválida. Execute novamente o comando de login para o seu tipo de Key (API Key padrão ou Token Plan).
A credencial ativa é uma API Key padrão (o perfil default). O Token Plan requer que sua API Key de assinatura esteja conectada ao perfil token-plan; execute bl auth status --output json para ver qual credencial está ativa.
Faça login com sua API Key de assinatura: bl auth login --config token-plan --api-key <sk-sp-Key> --base-url https://token-plan.ap-southeast-1.maas.aliyuncs.com. Se o perfil já existir, mude para ele com bl config use --name token-plan.
Não. Os comandos de chamada de modelo funcionam; os recursos do console (como app list, usage free, workspace) requerem login no console (bl auth login --console --console-site international), e o gerenciamento de assentos do Token Plan também precisa de credenciais AK/SK da OpenAPI do Alibaba Cloud. Veja Configurar autenticação para a comparação.
Execute bl auth status --output json para inspecionar a credencial ativa (mascarada), bl config list para listar todos os perfis e bl config use --name <profile> para alternar o perfil ativo.
Configure um espelho ou proxy e reinstale.
Use o script de instalação binária em vez disso (não requer Node.js/npm): curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash. Alternativamente, instale ou repare o npm primeiro, depois use npm install -g bailian-cli — mas não use pnpm / yarn para instalar a CLI.