Skip to main content

Configuração e Ferramentas

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.
Anexe --help a qualquer comando para obter detalhes completos dos parâmetros, por exemplo: bl config show --help. Todos os parâmetros que aceitam uma URL de arquivo também aceitam um caminho local — a CLI faz o upload automático para armazenamento temporário (válido por 48 horas), então você nunca precisa hospedar arquivos como URLs. Os detalhes dos comandos nesta página são verificados com o bl 2.8.0. Sinalizadores globais podem preceder o caminho completo do comando, por exemplo bl --config token-plan auth status; sinalizadores específicos do comando e credenciais devem seguir o caminho.

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
bl auth login --api-key <key> | --console [--no-browser | --token-stdin --console-region <region>] | --open-api --access-key-id <id> --access-key-secret <secret>
ParâmetroTipoObrigatórioDescrição
--api-key <key>stringNãoChave de API do modelo para validar e armazenar
--base-url <url>stringNãoURL base da API do modelo para validar e armazenar com --api-key
--consoleswitchNãoFaç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-browserswitchnãoCom --console, exibe a URL de login sem abrir um navegador
--token-stdinswitchnãoCom --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>stringnãoRegião do gateway do console (por exemplo, cn-beijing, ap-southeast-1)
--console-site <site>stringNãoSite do console: doméstico, internacional
--open-apiswitchNãoArmazene credenciais de Alibaba Cloud OpenAPI AK/SK
--access-key-id <id>stringNãoID da Chave de Acesso da Alibaba Cloud para armazenar
--access-key-secret <secret>stringNãoSegredo da Chave de Acesso da Alibaba Cloud para armazenar
Exemplo: Autenticar via login no navegador para o console
bl auth login --console --console-site international
  • 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.
  • 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ção security_token ou ALIBABA_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 status
Este comando suporta apenas opções globais. Exemplo: Mostrar status de autenticação com saída JSON
bl auth status --output json

bl auth logout

Limpar credenciais armazenadas; o logout completo também limpa a URL base do modelo. Não requer autenticação. Uso
bl auth logout [--console | --open-api] [--dry-run]
ParâmetroTipoObrigatórioDescrição
--consoleswitchNãoLimpe apenas o access_token do console, mantenha api_key intacto
--open-apiswitchNãoLimpe apenas as credenciais OpenAPI AK/SK/STS, mantenha outras credenciais intactas
Exemplo: Limpar apenas o access_token do console
bl auth logout --console

bl auth generate-access-token

Gerar um token de acesso da CLI usando OpenAPI AK/SK. Não requer autenticação. Uso
bl auth generate-access-token --access-key-id <id> --access-key-secret <secret> --security-token <token>
ParâmetroTipoObrigatórioDescrição
--access-key-id <id>stringSimID da Chave de Acesso da Alibaba Cloud
--access-key-secret <secret>stringSimSegredo da Chave de Acesso da Alibaba Cloud
--security-token <token>stringNãoToken de Segurança STS da Alibaba Cloud para armazenar (opcional)
Exemplo: Gerar token de acesso da CLI com AK/SK e token STS opcional
bl auth generate-access-token --access-key-id LTAIxxxxx --access-key-secret xxxxx --security-token <token>

Configuração

bl config set

Definir um valor de configuração. Não requer autenticação. Uso
bl config set --key <key> --value <value>
ParâmetroTipoObrigatórioDescrição
--key <key>stringSimChave 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>stringSimValor a ser definido
Exemplo: Definir a chave de configuração language como zh-CN
bl config set --key language --value zh-CN

bl config show

Exibir a configuração atual. Não requer autenticação. Uso
bl config show
Este comando suporta apenas opções globais. Exemplo: Mostrar configuração atual em formato JSON
bl config show --output json
  • 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 list
Este comando suporta apenas opções globais. Exemplo: Listar perfis de configuração com perfil ativo em saída JSON
bl config list --output json

bl config use

Definir o perfil de configuração ativo. Não requer autenticação. Uso
bl config use --name <name>
ParâmetroTipoObrigatórioDescrição
--name <name>stringSimNome do perfil existente, ou default
Exemplo: Definir o perfil de configuração ativo como token-plan
bl config use --name token-plan

bl config ui

Abrir uma interface web local para gerenciar perfis de configuração. Não requer autenticação. Uso
bl config ui [--port <port>] [--no-open]
ParâmetroTipoObrigatórioDescrição
--port <port>numberNãoPorta na qual escutar (padrão: porta livre aleatória)
--no-openswitchNãoNão abra o navegador automaticamente
Exemplo: Abrir a interface web de gerenciamento de configuração na porta 8787
bl config ui --port 8787

bl config agent

Configure o agente de codificação para usar a API DashScope. Não requer autenticação. Uso
bl config agent --agent <name> (--base-url <url> | --region <region>) (--api-key <key> | --key <encoded>) --model <model>
ParâmetroTipoObrigatórioDescrição
--agent <name>stringSimAgente-alvo: claude-code, qwen-code, opencode, openclaw, hermes, codex, pi
--base-url <url>stringNãoURL base da API
--region <region>stringNãoRegião do Model Studio (por exemplo, cn-beijing, ap-southeast-1); convertida em --base-url. Apenas Plano de Token
--api-key <key>stringNãoChave da API
--key <encoded>stringNãoChave da API obfuscada do console da web (começa com "o1_"); decodificada em --api-key
--model <model>stringSimNome padrão do modelo
--context-window <tokens>numberNãoApenas OpenClaw: tamanho da janela de contexto do modelo em tokens (padrão: 256000)
--wire-api <api>stringNãoApenas Codex: protocolo de comunicação (padrão: responses). "chat" só funciona com Codex legado <= 0.80.0
Exemplo: Configure o agente de codificação para usar a API DashScope com configurações especificadas
bl config agent --agent claude-code --base-url https://dashscope-intl.aliyuncs.com/apps/anthropic --api-key sk-xxxxx --model qwen3-max

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=1 para ativar o quiet. Scripts que extraíam IDs, caminhos ou respostas do quiet devem ler os campos JSON.
  • --introspect imprime 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
bl file upload --file <path> --model <model>
ParâmetroTipoObrigatórioDescrição
--file <path>stringSimArquivo local para envio (imagem, vídeo, áudio)
--model <model>stringSimNome do modelo-alvo (o arquivo é vinculado a este modelo)
Exemplo: Envie photo.jpg para o armazenamento do DashScope vinculado ao modelo qwen3-vl-plus
bl file upload --file photo.jpg --model qwen3-vl-plus
  • 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
bl model list [--model <model>] [--page <n>] [--page-size <n>] [--provider <p>] [--capability <c>] [--feature <f>] [--input-modality <m>] [--output-modality <m>] [--include-deprecated] [--enrich]
ParâmetroTipoObrigatórioDescrição
--model <model>stringNãoExibir detalhes completos de uma família de modelos específica (ativa o modo detalhado)
--page <n>numberNãoNúmero da página (padrão: 1)
--page-size <n>numberNãoResultados por página (padrão: 10)
--provider <p>arrayNãoFiltrar por provedor (repetível, por exemplo, --provider alibaba --provider deepseek)
--capability <c>arrayNãoFiltrar por código de capacidade (TG, Reasoning, VU, IG, VG, TTS, ASR, …)
--feature <f>arrayNãoFiltrar por recurso (function-calling, web-search, structured-outputs, …)
--context-window <w>arrayNãoFiltrar por faixa de tamanho da janela de contexto
--input-modality <m>arrayNãoExigir uma modalidade de entrada (repetível: Texto, Imagem, Vídeo, Áudio)
--output-modality <m>arrayNãoExigir uma modalidade de saída (repetível: Texto, Imagem, Vídeo, Áudio)
--include-deprecatedswitchNãoIncluir modelos já desativados (ocultos por padrão)
--enrichswitchNãoTambém buscar o esquema de parâmetros de entrada (predictConfig) para modelos principais (apenas no modo detalhado)
Exemplo: Listar modelos fornecidos pela alibaba
bl model list --provider alibaba
  • 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.
Pesquisa o catálogo de modelos por palavra-chave, ordenado por relevância. Não requer autenticação. Uso
bl model search --keyword <kw> [--limit <n>] [--provider <p>...] [--capability <c>...] [--feature <f>...] [--context-window <w>...] [--input-modality <m>...] [--output-modality <m>...] [--include-deprecated]
ParâmetroTipoObrigatórioDescrição
--keyword <kw>stringSimPalavra-chave comparada com o ID, nome, capacidades, recursos e descrição do modelo
--limit <n>numberNãoNúmero máximo de resultados (padrão: 20)
--provider <p>arrayNãoFiltrar por provedor (repetível, por exemplo --provider alibaba --provider deepseek)
--capability <c>arrayNãoFiltrar por código de capacidade (TG, Reasoning, VU, IG, VG, TTS, ASR e outros)
--feature <f>arrayNãoFiltrar por recurso (function-calling, web-search, structured-outputs e outros)
--context-window <w>arrayNãoFiltrar por faixa de janela de contexto
--input-modality <m>arrayNãoExigir uma modalidade de entrada (Text, Image, Video, Audio)
--output-modality <m>arrayNãoExigir uma modalidade de saída (Text, Image, Video, Audio)
--include-deprecatedswitchNãoIncluir modelos que já estão offline
Exemplo:Pesquisar modelos cujo nome contenha qwen
bl model search --keyword qwen
  • 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
bl model code --model <model> [--sdk <sdk>] [--api <style>] [--lang <lang>]
ParâmetroTipoObrigatórioDescrição
--model <model>stringSimModelo para o qual gerar um exemplo
--sdk <sdk>stringNãoTipo de SDK: openai (padrão) ou dashscope
--api <style>stringNãoEstilo de API: completions (padrão) ou responses
--lang <lang>stringNãoLinguagem do trecho (padrão: python); passe um valor não suportado para listar as opções
Exemplo:Gerar um exemplo Python para qwen-max
bl model code --model qwen-max
Exemplo:Gerar um exemplo curl para qwen-max
bl model code --model qwen-max --lang curl
  • 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.
  • --api aceita completions ou responses; é 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
bl advisor recommend --message <text> [flags]
ParâmetroTipoObrigatórioDescrição
--message <text>stringSimDescreva seus requisitos
--top <n>numbernãoNúmero de recomendações (padrão: 3)
--model <model>stringnãoLLM usado em todas as etapas: agente, intenção, pontuação e explicação (padrão: qwen-flash-2025-07-28)
--no-agentswitchnãoIgnora o loop do agente e executa o mecanismo determinístico diretamente
--traceswitchnãoGrava o rastreamento completo de roteamento e desempenho em stderr
--thinkswitchnãoMostra o processo de decisão do mecanismo em stderr
--no-thinkingswitchnãoParâmetro de compatibilidade obsoleto, sem efeito; chamadas de recomendação sempre desativam o modo de pensamento
Exemplo: Recomendar os melhores modelos para um chatbot com compreensão visual
bl advisor recommend --message "I need a visual-understanding chatbot"
Exemplo: Ignorar o esclarecimento do Agent e executar o mecanismo de recomendação diretamente
bl advisor recommend --message "Criar uma livestream de humano digital" --no-agent
  • 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.
  • --trace e --think gravam 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
bl pipeline run --file <path> [flags]
ParâmetroTipoObrigatórioDescrição
--file <path>stringSimArquivo de definição de pipeline (YAML/JSON)
--input <json>stringNãoEntrada em tempo de execução como JSON embutido
--input-file <path>stringNãoEntrada em tempo de execução a partir de um arquivo JSON
--concurrency <n>numberNãoNúmero máximo de etapas paralelas (padrão: 1)
--events <format>stringNãoEmitir eventos de ciclo de vida: jsonl
--step-timeout <seconds>numberNãoTempo limite padrão por etapa em segundos
Exemplo: Executar fluxo de trabalho de pipeline a partir de workflow.yaml com entrada {'brief':'hello'}
bl pipeline run --file workflow.yaml --input '{"brief":"hello"}'
  • --events jsonl usa 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
bl pipeline validate --file <path>
ParâmetroTipoObrigatórioDescrição
--file <path>stringSimArquivo de definição de pipeline (YAML/JSON)
Exemplo: Validar definição de pipeline a partir de arquivo
bl pipeline validate --file workflow.yaml

bl plugin install

Instale ou atualize um Command Pack autorizado. Não requer autenticação. Uso
bl plugin install --package <name[@version]>
ParâmetroTipoObrigatórioDescrição
--package <name[@version]>stringSimPacote de Command Pack autorizado e versão ou tag opcional
Exemplo: Instalar pacote de Command Pack autorizado
bl plugin install --package @ali/bailian-plugin-agent

bl plugin list

Liste os Command Packs instalados e seu status de carregamento. Não requer autenticação. Uso
bl plugin list
Este comando suporta apenas opções globais. Exemplo: Listar Command Packs instalados com saída em JSON
bl plugin list --output json

bl plugin remove

Remova um Command Pack instalado. Não requer autenticação. Uso
bl plugin remove --name <package>
ParâmetroTipoObrigatórioDescrição
--name <package>stringSimNome do pacote de Command Pack autorizado
Exemplo: Remover Command Pack instalado pelo nome
bl plugin remove --name @ali/bailian-plugin-agent
Link um Command Pack local autorizado para desenvolvimento. Não requer autenticação. Uso
bl plugin link --path <directory>
ParâmetroTipoObrigatórioDescrição
--path <directory>stringSimDiretório do pacote de Command Pack local
Exemplo: Linkar Command Pack local para desenvolvimento
bl plugin link --path ../bailian-plugin-agent

bl workspace init

Inicializa o workspace Bailian e ativa serviços pós-pagos. Não requer autenticação. Uso
bl workspace init --access-key-id <id> --access-key-secret <secret> [--security-token <token>]
ParâmetroTipoObrigatórioDescrição
--access-key-id <id>stringNãoID da Chave de Acesso da Alibaba Cloud
--access-key-secret <secret>stringNãoSegredo da Chave de Acesso da Alibaba Cloud
--security-token <token>stringNãoToken de Segurança STS da Alibaba Cloud (opcional)
Exemplo: Inicializar workspace com chaves de acesso
bl workspace init --access-key-id LTAIxxxxx --access-key-secret xxxxx

bl workspace list

Lista todos os workspaces. Uso
bl workspace list [flags]
ParâmetroTipoObrigatórioDescrição
--list <n>stringNãoLimita o número de resultados
Exemplo: Listar workspaces com limite
bl workspace list --list 5

bl console call

Chama uma API do console Bailian via gateway CLI. Uso
bl console call --api <api> --data <json> [flags]
ParâmetroTipoObrigatórioDescrição
--api <api>stringSimNome da API (por exemplo, zeldaEasy.broadscope-bailian.memory-library.getLibraries)
--data <json>stringSimDados da requisição como string JSON
Exemplo: Chamar API do console Bailian com dados
bl console call --api zeldaEasy.bailian-commerce.freeTrial.queryFreeTierQuota --data '{"queryFreeTierQuotaRequest":{"models":["qwen3-max"]}}'

bl update

Atualiza o CLI para a versão mais recente ou uma versão especificada. Não requer autenticação. Uso
bl update [--to <version>]
ParâmetroTipoObrigatórioDescrição
--to <version>stringNãoInstala esta versão exata em vez da mais recente
Exemplo: Atualizar CLI para versão específica
bl update --to 0.1.14
  • bl update retorna 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.
Execute bl --help para ver todos os grupos de comandos.