Referência de comandos da CLI Bailian para configuração de autenticação, gerenciamento de perfis, mercado de modelos, upload de arquivos e ferramentas gerais.
Gerencie a autenticação da CLI, alterne entre perfis, navegue pelo mercado de modelos, carregue arquivos e use ferramentas gerais diretamente no terminal.
Autentique-se com chave de API, login via navegador do console ou OpenAPI AK/SK (as credenciais podem coexistir). Não requer autenticação.
Uso
Exemplo: Autenticar via login no navegador para o console
Mostrar o estado atual de autenticação. Não requer autenticação.
Uso
Este comando suporta apenas opções globais.
Exemplo: Mostrar status de autenticação com saída JSON
Limpar credenciais armazenadas; o logout completo também limpa a URL base do modelo. Não requer autenticação.
Uso
Exemplo: Limpar apenas o access_token do console
Gerar um token de acesso da CLI usando OpenAPI AK/SK. Não requer autenticação.
Uso
Exemplo: Gerar token de acesso da CLI com AK/SK e token STS opcional
Definir um valor de configuração. Não requer autenticação.
Uso
Exemplo: Definir a chave de configuração language como zh-CN
Exibir a configuração atual. Não requer autenticação.
Uso
Este comando suporta apenas opções globais.
Exemplo: Mostrar configuração atual em formato JSON
Listar perfis de configuração e mostrar o perfil ativo. Não requer autenticação.
Uso
Este comando suporta apenas opções globais.
Exemplo: Listar perfis de configuração com perfil ativo em saída JSON
Definir o perfil de configuração ativo. Não requer autenticação.
Uso
Exemplo: Definir o perfil de configuração ativo como token-plan
Abrir uma interface web local para gerenciar perfis de configuração. Não requer autenticação.
Uso
Exemplo: Abrir a interface web de gerenciamento de configuração na porta 8787
Configure o agente de codificação para usar a API DashScope. Não requer autenticação.
Uso
Exemplo: Configure o agente de codificação para usar a API DashScope com configurações especificadas
O formato de saída padrão é text. Alterne para JSON com
Envie um arquivo local para o armazenamento temporário do DashScope (48h). Requer autenticação com chave de API.
Uso
Exemplo: Envie photo.jpg para o armazenamento do DashScope vinculado ao modelo qwen3-vl-plus
Navegue por famílias de modelos ou exiba informações detalhadas sobre modelos na loja de modelos Bailian. Não requer autenticação.
Uso
Exemplo: Listar modelos fornecidos pela alibaba
Pesquisa o catálogo de modelos por palavra-chave, ordenado por relevância. Não requer autenticação.
Uso
Exemplo:Pesquisar modelos cujo nome contenha qwen
Exibe um exemplo de SDK pronto para uso para chamar um modelo. Não requer autenticação.
Uso
Exemplo:Gerar um exemplo Python para qwen-max
Exemplo:Gerar um exemplo curl para qwen-max
Recomende os melhores modelos para seu caso de uso (análise de intenção → recall de candidatos → classificação LLM). Requer autenticação com chave de API.
Uso
Exemplo: Recomendar os melhores modelos para um chatbot com compreensão visual
Exemplo: Ignorar o esclarecimento do Agent e executar o mecanismo de recomendação diretamente
Execute uma definição de fluxo de trabalho de pipeline. Não requer autenticação.
Uso
Exemplo: Executar fluxo de trabalho de pipeline a partir de workflow.yaml com entrada {'brief':'hello'}
Valide uma definição de pipeline sem executá-la. Não requer autenticação.
Uso
Exemplo: Validar definição de pipeline a partir de arquivo
Instale ou atualize um Command Pack autorizado. Não requer autenticação.
Uso
Exemplo: Instalar pacote de Command Pack autorizado
Liste os Command Packs instalados e seu status de carregamento. Não requer autenticação.
Uso
Este comando suporta apenas opções globais.
Exemplo: Listar Command Packs instalados com saída em JSON
Remova um Command Pack instalado. Não requer autenticação.
Uso
Exemplo: Remover Command Pack instalado pelo nome
Link um Command Pack local autorizado para desenvolvimento. Não requer autenticação.
Uso
Exemplo: Linkar Command Pack local para desenvolvimento
Inicializa o workspace Bailian e ativa serviços pós-pagos. Não requer autenticação.
Uso
Exemplo: Inicializar workspace com chaves de acesso
Lista todos os workspaces.
Uso
Exemplo: Listar workspaces com limite
Chama uma API do console Bailian via gateway CLI.
Uso
Exemplo: Chamar API do console Bailian com dados
Atualiza o CLI para a versão mais recente ou uma versão especificada. Não requer autenticação.
Uso
Exemplo: Atualizar CLI para versão específica
Autenticação
bl auth login
Autentique-se com chave de API, login via navegador do console ou OpenAPI AK/SK (as credenciais podem coexistir). Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--api-key <key> | string | Não | Chave de API do modelo para validar e armazenar |
--base-url <url> | string | Não | URL base da API do modelo para validar e armazenar com --api-key |
--console | switch | Não | Faça login via navegador (China por padrão; use --console-site internacional para o site internacional). Cria uma chave de API normal se necessário; planos de assinatura exigem --api-key |
--no-browser | switch | não | Com --console, exibe a URL de login sem abrir um navegador |
--token-stdin | switch | não | Com --console, lê e valida um token de acesso do console a partir do stdin; requer --console-region e não abre navegador nem servidor local |
--console-region <region> | string | não | Região do gateway do console (por exemplo, cn-beijing, ap-southeast-1) |
--console-site <site> | string | Não | Site do console: doméstico, internacional |
--open-api | switch | Não | Armazene credenciais de Alibaba Cloud OpenAPI AK/SK |
--access-key-id <id> | string | Não | ID da Chave de Acesso da Alibaba Cloud para armazenar |
--access-key-secret <secret> | string | Não | Segredo da Chave de Acesso da Alibaba Cloud para armazenar |
-
Se nenhum navegador puder ser aberto, use
bl auth login --console --console-site international --no-browserpara exibir a URL de login, ou importe um token de acesso do stdin com--token-stdin. -
O AK/SK do OpenAPI é resolvido como um grupo completo nesta ordem: parâmetros do comando,
BAILIAN_ACCESS_KEY_ID/BAILIAN_ACCESS_KEY_SECRET, configuração do Bailian e, por fim,ALIBABA_CLOUD_ACCESS_KEY_ID/ALIBABA_CLOUD_ACCESS_KEY_SECRET. Os campos não são combinados entre fontes. Tokens STS vêm da mesma fonte:BAILIAN_SECURITY_TOKEN, a chave de configuraçãosecurity_tokenouALIBABA_CLOUD_SECURITY_TOKEN. - Comandos de negócio do console não aceitam flags temporárias de AK/SK. Quando o token do console está ausente ou expirado, a CLI obtém um automaticamente com o AK/SK disponível, com no máximo uma troca por requisição.
bl auth status
Mostrar o estado atual de autenticação. Não requer autenticação.
Uso
bl auth logout
Limpar credenciais armazenadas; o logout completo também limpa a URL base do modelo. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--console | switch | Não | Limpe apenas o access_token do console, mantenha api_key intacto |
--open-api | switch | Não | Limpe apenas as credenciais OpenAPI AK/SK/STS, mantenha outras credenciais intactas |
bl auth generate-access-token
Gerar um token de acesso da CLI usando OpenAPI AK/SK. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--access-key-id <id> | string | Sim | ID da Chave de Acesso da Alibaba Cloud |
--access-key-secret <secret> | string | Sim | Segredo da Chave de Acesso da Alibaba Cloud |
--security-token <token> | string | Não | Token de Segurança STS da Alibaba Cloud para armazenar (opcional) |
Configuração
bl config set
Definir um valor de configuração. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--key <key> | string | Sim | Chave de configuração (language, base_url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default_*_model, workspace_id) |
--value <value> | string | Sim | Valor a ser definido |
bl config show
Exibir a configuração atual. Não requer autenticação.
Uso
- Mostra as origens efetivas da API Key e da Base URL e avisa quando a requisição usa valores de origens de configuração diferentes.
bl config list
Listar perfis de configuração e mostrar o perfil ativo. Não requer autenticação.
Uso
bl config use
Definir o perfil de configuração ativo. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--name <name> | string | Sim | Nome do perfil existente, ou default |
bl config ui
Abrir uma interface web local para gerenciar perfis de configuração. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--port <port> | number | Não | Porta na qual escutar (padrão: porta livre aleatória) |
--no-open | switch | Não | Não abra o navegador automaticamente |
bl config agent
Configure o agente de codificação para usar a API DashScope. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--agent <name> | string | Sim | Agente-alvo: claude-code, qwen-code, opencode, openclaw, hermes, codex, pi |
--base-url <url> | string | Não | URL base da API |
--region <region> | string | Não | Região do Model Studio (por exemplo, cn-beijing, ap-southeast-1); convertida em --base-url. Apenas Plano de Token |
--api-key <key> | string | Não | Chave da API |
--key <encoded> | string | Não | Chave da API obfuscada do console da web (começa com "o1_"); decodificada em --api-key |
--model <model> | string | Sim | Nome padrão do modelo |
--context-window <tokens> | number | Não | Apenas OpenClaw: tamanho da janela de contexto do modelo em tokens (padrão: 256000) |
--wire-api <api> | string | Não | Apenas Codex: protocolo de comunicação (padrão: responses). "chat" só funciona com Codex legado <= 0.80.0 |
Saída e diagnóstico
O formato de saída padrão é text. Alterne para JSON com --output json, DASHSCOPE_OUTPUT=json ou a chave de configuração output.
- O modo JSON retorna o resultado de negócio completo em stdout. Avisos, diagnósticos e erros são gravados separadamente em stderr como JSONL, para que scripts e agentes os analisem de forma independente.
- O modo quiet oculta apenas o progresso e as mensagens de processo, preservando resultados completos, avisos e erros. Defina
DASHSCOPE_QUIET=1para ativar o quiet. Scripts que extraíam IDs, caminhos ou respostas do quiet devem ler os campos JSON. --introspectimprime o esquema de comando legível por máquina (JSON) e sai, para que agentes possam descobrir comandos e parâmetros.- Login interativo, a UI de configuração local e os fluxos de eventos do Pipeline usam saída text. Para JSON na saída de áudio em streaming, especifique um arquivo com
--out.
Ferramentas gerais
bl file upload
Envie um arquivo local para o armazenamento temporário do DashScope (48h). Requer autenticação com chave de API.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--file <path> | string | Sim | Arquivo local para envio (imagem, vídeo, áudio) |
--model <model> | string | Sim | Nome do modelo-alvo (o arquivo é vinculado a este modelo) |
- O serviço de upload é escolhido a partir do Endpoint do modelo ativo. Uploads temporários oficiais suportam apenas as regiões Pequim e Singapura; regiões não suportadas e Token Plan falham explicitamente.
- Um proxy de upload personalizado especificado explicitamente não é mais rejeitado pelo tipo de chave.
- Uploads de arquivos locais para o OSS temporário seguem
--timeout.
bl model list
Navegue por famílias de modelos ou exiba informações detalhadas sobre modelos na loja de modelos Bailian. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--model <model> | string | Não | Exibir detalhes completos de uma família de modelos específica (ativa o modo detalhado) |
--page <n> | number | Não | Número da página (padrão: 1) |
--page-size <n> | number | Não | Resultados por página (padrão: 10) |
--provider <p> | array | Não | Filtrar por provedor (repetível, por exemplo, --provider alibaba --provider deepseek) |
--capability <c> | array | Não | Filtrar por código de capacidade (TG, Reasoning, VU, IG, VG, TTS, ASR, …) |
--feature <f> | array | Não | Filtrar por recurso (function-calling, web-search, structured-outputs, …) |
--context-window <w> | array | Não | Filtrar por faixa de tamanho da janela de contexto |
--input-modality <m> | array | Não | Exigir uma modalidade de entrada (repetível: Texto, Imagem, Vídeo, Áudio) |
--output-modality <m> | array | Não | Exigir uma modalidade de saída (repetível: Texto, Imagem, Vídeo, Áudio) |
--include-deprecated | switch | Não | Incluir modelos já desativados (ocultos por padrão) |
--enrich | switch | Não | Também buscar o esquema de parâmetros de entrada (predictConfig) para modelos principais (apenas no modo detalhado) |
- Os endpoints do catálogo e do parâmetro --enrich são públicos — não é necessário login no console.
- O modo de navegação oculta modelos já desativados; use --include-deprecated para incluí-los. O modo detalhado (--model) sempre lista todas as versões e indica seu status.
bl model search
Pesquisa o catálogo de modelos por palavra-chave, ordenado por relevância. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--keyword <kw> | string | Sim | Palavra-chave comparada com o ID, nome, capacidades, recursos e descrição do modelo |
--limit <n> | number | Não | Número máximo de resultados (padrão: 20) |
--provider <p> | array | Não | Filtrar por provedor (repetível, por exemplo --provider alibaba --provider deepseek) |
--capability <c> | array | Não | Filtrar por código de capacidade (TG, Reasoning, VU, IG, VG, TTS, ASR e outros) |
--feature <f> | array | Não | Filtrar por recurso (function-calling, web-search, structured-outputs e outros) |
--context-window <w> | array | Não | Filtrar por faixa de janela de contexto |
--input-modality <m> | array | Não | Exigir uma modalidade de entrada (Text, Image, Video, Audio) |
--output-modality <m> | array | Não | Exigir uma modalidade de saída (Text, Image, Video, Audio) |
--include-deprecated | switch | Não | Incluir modelos que já estão offline |
- A pesquisa percorre todo o catálogo, mas oculta modelos offline por padrão; use --include-deprecated para incluí-los.
- A API do catálogo de modelos é pública; não é necessário fazer login no console.
bl model code
Exibe um exemplo de SDK pronto para uso para chamar um modelo. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--model <model> | string | Sim | Modelo para o qual gerar um exemplo |
--sdk <sdk> | string | Não | Tipo de SDK: openai (padrão) ou dashscope |
--api <style> | string | Não | Estilo de API: completions (padrão) ou responses |
--lang <lang> | string | Não | Linguagem do trecho (padrão: python); passe um valor não suportado para listar as opções |
- A saída de texto contém apenas o trecho, então pode ser redirecionada para um arquivo; use --output json para obter o trecho e os metadados.
- A URL base do exemplo contém um placeholder
[workspace-id]. Substitua-o ou defina BAILIAN_WORKSPACE_ID e use o endpoint DashScope. - As combinações disponíveis são publicadas por modelo; passe um valor desconhecido para ver a lista.
--apiaceitacompletionsouresponses; é ignorado quando o SDK oferece suporte a apenas um estilo.
bl advisor recommend
Recomende os melhores modelos para seu caso de uso (análise de intenção → recall de candidatos → classificação LLM). Requer autenticação com chave de API.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--message <text> | string | Sim | Descreva seus requisitos |
--top <n> | number | não | Número de recomendações (padrão: 3) |
--model <model> | string | não | LLM usado em todas as etapas: agente, intenção, pontuação e explicação (padrão: qwen-flash-2025-07-28) |
--no-agent | switch | não | Ignora o loop do agente e executa o mecanismo determinístico diretamente |
--trace | switch | não | Grava o rastreamento completo de roteamento e desempenho em stderr |
--think | switch | não | Mostra o processo de decisão do mecanismo em stderr |
--no-thinking | switch | não | Parâmetro de compatibilidade obsoleto, sem efeito; chamadas de recomendação sempre desativam o modo de pensamento |
- O fluxo de recomendação é análise de intenção → roteamento → recall de candidatos → pontuação → classificação. Terminais interativos aceitam esclarecimentos do agente e recomendações em várias etapas, preservando a estrutura JSON do resultado.
--tracee--thinkgravam apenas em stderr e não alteram o resultado da recomendação em stdout.
bl pipeline run
Execute uma definição de fluxo de trabalho de pipeline. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--file <path> | string | Sim | Arquivo de definição de pipeline (YAML/JSON) |
--input <json> | string | Não | Entrada em tempo de execução como JSON embutido |
--input-file <path> | string | Não | Entrada em tempo de execução a partir de um arquivo JSON |
--concurrency <n> | number | Não | Número máximo de etapas paralelas (padrão: 1) |
--events <format> | string | Não | Emitir eventos de ciclo de vida: jsonl |
--step-timeout <seconds> | number | Não | Tempo limite padrão por etapa em segundos |
--events jsonlusa o modo de saída de texto. Os fluxos de eventos do Pipeline não podem ser misturados com outros formatos de saída.
bl pipeline validate
Valide uma definição de pipeline sem executá-la. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--file <path> | string | Sim | Arquivo de definição de pipeline (YAML/JSON) |
bl plugin install
Instale ou atualize um Command Pack autorizado. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--package <name[@version]> | string | Sim | Pacote de Command Pack autorizado e versão ou tag opcional |
bl plugin list
Liste os Command Packs instalados e seu status de carregamento. Não requer autenticação.
Uso
bl plugin remove
Remova um Command Pack instalado. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--name <package> | string | Sim | Nome do pacote de Command Pack autorizado |
bl plugin link
Link um Command Pack local autorizado para desenvolvimento. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--path <directory> | string | Sim | Diretório do pacote de Command Pack local |
bl workspace init
Inicializa o workspace Bailian e ativa serviços pós-pagos. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--access-key-id <id> | string | Não | ID da Chave de Acesso da Alibaba Cloud |
--access-key-secret <secret> | string | Não | Segredo da Chave de Acesso da Alibaba Cloud |
--security-token <token> | string | Não | Token de Segurança STS da Alibaba Cloud (opcional) |
bl workspace list
Lista todos os workspaces.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--list <n> | string | Não | Limita o número de resultados |
bl console call
Chama uma API do console Bailian via gateway CLI.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--api <api> | string | Sim | Nome da API (por exemplo, zeldaEasy.broadscope-bailian.memory-library.getLibraries) |
--data <json> | string | Sim | Dados da requisição como string JSON |
bl update
Atualiza o CLI para a versão mais recente ou uma versão especificada. Não requer autenticação.
Uso
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--to <version> | string | Não | Instala esta versão exata em vez da mais recente |
bl updateretorna um código de saída diferente de zero quando a atualização falha ou a versão mais recente não pode ser determinada.
bl --help para ver todos os grupos de comandos.