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.
Mesmo que o pnpm / yarn esteja instalado, use o npm para instalar
Após a instalação, dois comandos são adicionados ao seu PATH:
Execute
Se a Alibaba Cloud CLI estiver instalada, invoque os mesmos comandos com
Ajuda, exemplos, dicas de recuperação e comandos estruturados seguem o ponto de entrada
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:
Isso instala cada Skill
Para instalar uma única Skill, substitua
Você deve se autenticar antes de chamar qualquer API. Escolha um dos métodos abaixo com base no seu ambiente.
As chaves de assinatura Standard API Keys e Token Plan diferem da seguinte forma:
O comando de login já testa a usabilidade, então você só precisa confirmar o status da configuração:
Nenhum teste repetido de chamada de modelo é necessário. Se o login falhar, use o
Para limpar as credenciais locais e sair, execute:
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 comnpm -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)
bailian-cli — não use pnpm / yarn para instalar a CLI.bl (alias curto) e bailian (nome completo). Verifique:
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. 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:
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):
--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: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.| Aspecto | Standard API Key | API Key do Token Plan |
|---|---|---|
| Cobrança | Pay-as-you-go (inclui cota gratuita para novos usuários) | Deduz da cota de assinatura do seu Token Plan |
| Escopo | Chamadas de serviço de modelo | Chamadas para modelos suportados pelo Token Plan |
| Uso típico | Sem assinatura, ou pay-as-you-go | Assinantes do Token Plan consumindo a cota do plano primeiro |
| Configuração | 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 |
Verificar
O comando de login já testa a usabilidade, então você só precisa confirmar o status da configuração:
hint ou message na saída para solucionar problemas (rede, Key inválida, base_url, etc.).
Sair
Para limpar as credenciais locais e sair, execute:
Solução de problemas
bl: comando não encontrado
bl: comando não encontrado
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.erro de engines durante a instalação
erro de engines durante a instalação
Versão do Node.js muito baixa. Atualize para >= 18.17.0 e reinstale.
401 / falha de autenticação
401 / falha de autenticação
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).
Por que uma chamada de modelo da CLI não deduz do meu Token Plan?
Por que uma chamada de modelo da CLI não deduz do meu 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.Como faço para que as chamadas de modelo da CLI usem meu Token Plan?
Como faço para que as chamadas de modelo da CLI usem meu Token Plan?
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.Posso usar todos os recursos da CLI apenas com uma API Key do Token Plan?
Posso usar todos os recursos da CLI apenas com uma API Key do 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.Como verifico e alterno a API Key ativa?
Como verifico e alterno a API Key ativa?
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.A rede corporativa não consegue acessar o npm
A rede corporativa não consegue acessar o npm
Configure um espelho ou proxy e reinstale.
Apenas pnpm disponível, sem npm
Apenas pnpm disponível, sem npm
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.