インストール
インストールスクリプトまたはパッケージマネージャーを使って Bob Shell をインストールできます。
システム要件
オペレーティングシステム
macOS、Linux、または Windows
メモリ
最低 4 GB RAM(8 GB 推奨)
ストレージ
最低 500 MB の空きディスク容量
ネットワーク
インターネット接続
Node.js
バージョン 24 以降
インストール
Bob Shell 2.0.0 は新規インストールが必要です。現在、1.0.x からの自動アップグレードパスはありません。既存の設定と構成はインストール中に保持されます。
インストールスクリプト、パッケージマネージャー、またはコマンドパレットを使って Bob Shell をインストールできます。
インストールスクリプトを使用する
オペレーティングシステムを選択し、コマンドをコピーして実行して Bob Shell をインストールします。
curl -fsSL https://bob.ibm.com/download/bobshell.sh | bashcurl -fsSL https://bob.ibm.com/download/bobshell.sh | bashpowershell -c "irm -Uri https://bob.ibm.com/download/bobshell.ps1 | iex"ダウンロードしたパッケージからインストールする
Releases ページから Bob Shell パッケージを手動でダウンロードした場合は、次のパッケージマネージャーのいずれかを使ってインストールできます:
以下のコマンドは、ファイルをダウンロードした実際のパスに変更してから使用してください。
Windows コマンドは PowerShell で実行する必要があります。
認証
Bob Shell はすべての Bob クライアントと同じログインエントリポイントを使用します:bob.ibm.com/login。Bob Shell を初めて実行するとき、またはセッションの有効期限が切れた後、Bob はこのページをブラウザーで開きます。
IBMid、SSO、セッション管理を含むログインの詳細については、Signing in を参照してください。
ユースケースに応じて 2 つの認証方法から選択します。
| 方法 | ユースケース | 要件 |
|---|---|---|
| SSO / IBMid | インタラクティブセッション | 有効な IBMid または企業 SSO アカウント、ブラウザーアクセス |
| API key | 自動化、CI/CD pipeline、非インタラクティブ環境 | Bob Web ポータルからの API key、環境変数 |
SSO / IBMid 認証(デフォルト)
Bob Shell が認証する必要がある場合、ブラウザーで bob.ibm.com/login が開きます。IBMid のメールアドレスを入力し、Continue をクリックすると、適切な ID プロバイダーに自動的にルーティングされます。
- 組織が SSO を設定している場合は、会社のログインページにリダイレクトされます。
- そうでない場合は、IBMid にリダイレクトされます。
ブラウザーで認証を完了した後、Bob Shell に戻ります。セッションは自動的に確立されます。
API key 認証
API key 認証は、ブラウザーベースの認証が利用できない自動化、CI/CD pipeline、および非インタラクティブ環境に最適です。
Bob Web ポータルで Scope を Inference に設定した API key を作成します。詳細な手順については API keys を参照してください。
キーを生成したら、ダウンロードするかキーの値をコピーします。再度確認できなくなるため、安全な場所に保存してください。
API key は絶対に他人と共有しないでください。
BOB_API_KEY 環境変数に API key の値を設定します:
export BOB_API_KEY="your-api-key-here"永続化するには、シェルプロファイル(~/.bashrc、~/.zshrc など)に追加します:
echo 'export BOB_API_KEY="your-api-key-here"' >> ~/.bashrc$env:BOB_API_KEY="your-api-key-here"永続化するには次を使用します:
[System.Environment]::SetEnvironmentVariable('BOB_API_KEY', 'your-api-key-here', 'User')API key を設定した状態で Bob Shell を実行します:
bob run "your prompt"またはインタラクティブセッションを開始します:
bob chatAPI key のタイプが Inference ではなく general の場合は、Bob Shell の実行時に --team-id <team-id> も指定する必要があります。
インストールまたは認証中にネットワークの問題が発生した場合は、プロキシ設定を行う必要がある場合があります。詳細については Configuring proxy settings または Troubleshooting セクション を参照してください。