Skip to main content
Memulai

Instalasi & Autentikasi

Instal Bailian CLI dan Skills, konfigurasikan autentikasi, dan verifikasi.

Halaman ini membahas cara menginstal Bailian CLI, menginstal Skills pendamping, dan mengonfigurasi autentikasi.

Prasyarat

  • Akses jaringan (baik registri npm atau bailian.aliyun.com, tergantung pada metode instalasi yang Anda pilih di bawah ini).
  • Untuk metode npm: Node.js >= 18.17.0 (verifikasi dengan node -v) dan npm (verifikasi dengan npm -v). Jika Anda tidak memiliki Node.js, atau versi Anda terlalu lama, gunakan skrip instalasi biner di bawah ini sebagai gantinya — tidak memerlukan Node.js.

Instal CLI

  • npm (Node.js yang ada)
  • Skrip biner (tidak memerlukan Node.js)
npm install -g bailian-cli
Meskipun pnpm / yarn telah diinstal, gunakan npm untuk menginstal bailian-cli — jangan gunakan pnpm / yarn untuk menginstal CLI.
Setelah instalasi, dua perintah ditambahkan ke PATH Anda: bl (alias singkat) dan bailian (nama lengkap). Verifikasi: 
bl --version
which bl   # use "where bl" on Windows
Jalankan bl update kapan saja untuk memeriksa dan menginstal versi CLI terbaru.
Jika Anda melihat command not found, periksa apakah direktori bin global ada di PATH Anda: untuk instalasi npm, jalankan npm config get prefix dan tambahkan subdirektori bin-nya ke PATH; untuk instalasi biner, tambahkan jalur yang dicetak oleh skrip instalasi.

Instal Skills

Setelah CLI diverifikasi, instal Skills pendamping agar Agent Anda mendapatkan berbagai kemampuan Bailian secara lengkap. Metode satu kali yang direkomendasikan adalah perintah bootstrap bawaan CLI: 
bl skill init
Ini menginstal setiap Skill bailian-* di registri (ditambah bailian-protocol bersama) dalam satu kali proses, dan merupakan jalur instalasi yang direkomendasikan secara resmi. Jika bl skill init tidak tersedia, gunakan alat skills sebagai gantinya (memerlukan Git pada mesin; paket skills terbaru memerlukan Node.js >= 22.20, jadi sematkan skills@1.5.18 pada Node.js 18): 
npx skills@1.5.18 add modelstudioai/cli --skill '*' -g
Untuk menginstal satu Skill, ganti --skill '*' dengan namanya; --list menampilkan semua Skill di repositori.

Konfigurasikan autentikasi

Anda harus melakukan autentikasi sebelum memanggil API apa pun. Pilih salah satu metode di bawah ini berdasarkan lingkungan Anda.
  • Login konsol (direkomendasikan)
  • API Key Standar
  • Token Plan
  • Token akses AK/SK
  • Variabel lingkungan
Paling cocok untuk instalasi lokal interaktif — tidak perlu menyalin API Key secara manual. Perintah ini membuka browser untuk menyelesaikan login dan otorisasi konsol Alibaba Cloud:
bl auth login --console
Ini juga membuka kemampuan konsol seperti app list dan usage free, serta secara otomatis mengonfigurasi kredensial yang diperlukan untuk panggilan API Key.
API Keys standar dan kunci langganan Token Plan berbeda sebagai berikut:
AspekAPI Key StandarAPI Key Token Plan
PenagihanBayar sesuai pemakaian (termasuk kuota gratis pengguna baru)Mengurangi kuota langganan Token Plan Anda
CakupanPanggilan layanan modelPanggilan ke model yang didukung oleh Token Plan
Penggunaan umumTanpa langganan, atau bayar sesuai pemakaianPelanggan Token Plan yang menggunakan kuota paket terlebih dahulu
Pengaturanbl auth login --api-key <Key>bl auth login --config token-plan --api-key <sk-sp-Key>

Verifikasi

Perintah login sudah menguji kelayakan penggunaan, sehingga Anda hanya perlu mengonfirmasi status konfigurasi: 
bl auth status --output json
Tidak diperlukan pengujian panggilan model berulang. Jika login gagal, gunakan hint atau message pada output untuk memecahkan masalah (jaringan, Key tidak valid, base_url, dll.).
Saat melaporkan status autentikasi, gunakan hanya bidang yang disamarkan. Jangan pernah menampilkan API Key secara lengkap, dan jangan menulis Key asli ke dalam repositori, log, atau bagian publik dari catatan obrolan.

Keluar

Untuk menghapus kredensial lokal dan keluar, jalankan: 
bl auth logout

Pemecahan Masalah

Direktori bin global tidak ada di PATH Anda. Jalankan npm config get prefix dan tambahkan subdirektori bin-nya ke PATH, lalu coba lagi.
Versi Node.js terlalu rendah. Tingkatkan ke >= 18.17.0 dan instal ulang.
Belum login atau API Key tidak valid. Jalankan ulang perintah login untuk jenis Key Anda (API Key standar atau Token Plan).
Kredensial aktif adalah API Key standar (profil default). Token Plan mengharuskan API Key langganan Anda masuk ke profil token-plan; jalankan bl auth status --output json untuk melihat kredensial mana yang aktif.
Masuk dengan API Key langganan Anda: bl auth login --config token-plan --api-key <sk-sp-Key>. Jika profil sudah ada, beralihlah ke profil tersebut dengan bl config use --name token-plan.
Tidak. Perintah panggilan model berfungsi; fitur konsol (seperti app list, usage free, workspace) memerlukan login konsol (bl auth login --console), dan manajemen seat Token Plan juga memerlukan kredensial AK/SK OpenAPI Alibaba Cloud. Lihat Konfigurasikan autentikasi untuk perbandingannya.
Jalankan bl auth status --output json untuk memeriksa kredensial aktif (disamarkan), bl config list untuk mencantumkan semua profil, dan bl config use --name <profile> untuk beralih ke profil aktif.
Konfigurasikan mirror atau proxy, lalu instal ulang.
Gunakan skrip instalasi biner sebagai gantinya (tidak memerlukan Node.js/npm): curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash. Atau, instal atau perbaiki npm terlebih dahulu, lalu gunakan npm install -g bailian-cli — tetapi jangan gunakan pnpm / yarn untuk menginstal CLI.
Memulai
Kemampuan
Log Perubahan