Skip to main content

インストールと認証

Bailian CLI と Skills をインストールし、認証を設定して確認します。

このページでは、Bailian CLI のインストール、付属 Skills のインストール、および認証の設定方法について説明します。

前提条件

  • ネットワークアクセス (以下のインストール方法に応じて、npm レジストリまたは bailian.aliyun.com のいずれか)。
  • npm の場合: Node.js >= 18.17.0 (node -v で確認) および npm (npm -v で確認)。Node.js がインストールされていない場合、またはバージョンが古すぎる場合は、代わりに以下のバイナリインストールスクリプトを使用してください。Node.js は不要です。

CLI のインストール

  • npm (既存の Node.js)
  • バイナリスクリプト (Node.js 不要)
npm install -g bailian-cli
pnpm / yarn がインストールされている場合でも、bailian-cli のインストールには npm を使用してください。CLI のインストールに pnpm / yarn を使用しないでください。
インストール後、2 つのコマンドが PATH に追加されます: bl (短いエイリアス) と bailian (正式名称)。確認: 
bl --version
which bl   # use "where bl" on Windows
最新の CLI バージョンを確認してインストールするには、いつでも bl update を実行してください。
command not found が表示された場合は、グローバル bin ディレクトリが PATH にあることを確認してください。npm インストールの場合は、npm config get prefix を実行してその bin サブディレクトリを PATH に追加します。バイナリインストールの場合は、インストールスクリプトによって出力されたパスを追加します。

Alibaba Cloud CLI 経由で呼び出す

Alibaba Cloud CLI がインストールされている場合、aliyun bl で同じコマンドを呼び出せます。 
aliyun bl --version
aliyun bl auth status
ヘルプ、例、リカバリのヒント、構造化コマンドは aliyun bl の入口に合わせて表示されます。Alibaba Cloud CLI ホストが提供する AccessKey は Alibaba Cloud の環境変数として扱われ、bl 設定に重複して保存する必要はありません。

Skills のインストール

CLI が確認できたら、付属の Skills をインストールして、エージェントが Bailian の全機能を利用できるようにします。推奨される一度きりの方法は、CLI の組み込みブートストラップコマンドです。 
bl skill init
これにより、レジストリ内のすべての bailian-* Skill (および共有 bailian-protocol) が一度にインストールされ、公式に推奨されるインストールパスとなります。bl skill init が利用できない場合は、代わりに skills ツールを使用してください (マシンに Git が必要です。最新の skills パッケージには Node.js >= 22.20 が必要なため、Node.js 18 では skills@1.5.18 を固定してください)。 
npx skills@1.5.18 add modelstudioai/cli --skill '*' -g
単一の Skill をインストールするには、--skill '*' をその名前に置き換えます。--list はリポジトリ内のすべての Skills を表示します。

認証の設定

API を呼び出す前に認証を行う必要があります。環境に応じて、以下のいずれかの方法を選択してください。
  • コンソールログイン (推奨)
  • 標準 API Key
  • Token Plan
  • AK/SK アクセストークン
  • 環境変数
インタラクティブなローカルインストールに最適です。API Key を手動でコピーする必要はありません。このコマンドはブラウザを開き、Alibaba Cloud コンソールのログインと認証を完了します。
bl auth login --console --console-site international
これにより、app list や usage free などのコンソール機能もロック解除され、API Key 呼び出しに必要な認証情報が自動的に設定されます。ブラウザを起動できない場合は、bl auth login --console --console-site international --no-browser でログイン URL を表示するか、--token-stdin で標準入力からアクセストークンをインポートします。
標準 API Keys と Token Plan サブスクリプションキーの違いは以下のとおりです。
項目標準 API KeyToken Plan API Key
課金従量課金 (新規ユーザーの無料クォータを含む)Token Plan サブスクリプションクォータから差し引かれます
スコープモデルサービス呼び出しToken Plan でサポートされているモデルの呼び出し
一般的な用途サブスクリプションなし、または従量課金最初にプランクォータを消費する Token Plan サブスクライバー
セットアップ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

確認

login コマンドはすでに可用性をテストしているため、設定ステータスを確認するだけで済みます。 
bl auth status --output json
モデル呼び出しテストを繰り返す必要はありません。ログインに失敗した場合は、出力内の hint または message を使用してトラブルシューティングを行ってください (ネットワーク、無効なキー、base_url など)。
認証ステータスを報告する場合は、マスクされたフィールドのみを使用してください。完全な API Key をエコーしたり、実際のキーをリポジトリ、ログ、またはチャット記録の公開部分に書き込んだりしないでください。

ログアウト

ローカル認証情報をクリアしてサインアウトするには、次のコマンドを実行します。 
bl auth logout

トラブルシューティング

グローバル bin ディレクトリが PATH にありません。npm config get prefix を実行し、その bin サブディレクトリを PATH に追加してから、再試行してください。
Node.js のバージョンが低すぎます。18.17.0 以上にアップグレードしてから再インストールしてください。
ログインしていないか、API Key が無効です。キーの種類 (標準 API Key または Token Plan) に応じて login コマンドを再実行してください。
アクティブな認証情報は標準 API Key (default プロファイル) です。Token Plan では、サブスクリプション API Key で token-plan プロファイルにサインインする必要があります。どの認証情報がアクティブかを確認するには、bl auth status --output json を実行してください。
サブスクリプション API Key でサインインします: bl auth login --config token-plan --api-key <sk-sp-Key> --base-url https://token-plan.ap-southeast-1.maas.aliyuncs.com。プロファイルがすでに存在する場合は、bl config use --name token-plan で切り替えます。
いいえ。モデル呼び出しコマンドは機能しますが、コンソール機能 (app list、usage free、workspace など) にはコンソールログイン (bl auth login --console --console-site international) が必要であり、Token Plan のシート管理にはさらに Alibaba Cloud OpenAPI AK/SK 認証情報が必要です。比較については 認証の設定 を参照してください。
アクティブな認証情報 (マスク済み) を検査するには bl auth status --output json を実行し、すべてのプロファイルを一覧表示するには bl config list を実行し、アクティブなプロファイルを切り替えるには bl config use --name <profile> を実行します。
ミラーまたはプロキシを設定してから、再インストールしてください。
代わりにバイナリインストールスクリプトを使用してください (Node.js/npm は不要です): curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash。あるいは、最初に npm をインストールまたは修復してから npm install -g bailian-cli を使用してください。ただし、CLI のインストールに pnpm / yarn を使用しないでください。