安裝
你可以使用安裝指令碼或套件管理器來安裝 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 套件，可以使用以下其中一個套件管理器來安裝：
您必須修改以下指令，使用您實際下載檔案的路徑。
您必須使用 PowerShell 執行以下 Windows 指令。
驗證
Bob Shell 使用與所有其他 Bob 用戶端相同的登入入口：bob.ibm.com/login。當您第一次執行 Bob Shell 或工作階段過期後，Bob 會在您的瀏覽器中開啟此頁面。
有關登入方式的完整概述（包括 IBMid、SSO 和工作階段管理），請參閱登入。
根據您的使用情境選擇 2 種驗證方法之一。
| 方法 | 使用情境 | 需求 |
|---|---|---|
| SSO / IBMid | 互動式工作階段 | 有效的 IBMid 或企業 SSO 帳號、需要瀏覽器存取 |
| API key | 自動化、CI/CD pipeline、非互動式環境 | 來自 Bob 網路入口網站的 API key、環境變數 |
SSO / IBMid 驗證（預設）
當 Bob Shell 需要驗證時，會在您的瀏覽器中開啟 bob.ibm.com/login。輸入您的 IBMid 電子郵件地址，然後按一下 Continue，系統會自動將您導向正確的身分提供者。
- 如果您的組織已設定 SSO，您將被重新導向至公司的登入頁面。
- 否則，您將被重新導向至 IBMid。
在瀏覽器中完成驗證後，返回 Bob Shell。您的工作階段將自動建立。
API key 驗證
API key 驗證適合用於無法進行瀏覽器驗證的自動化、CI/CD pipeline 和非互動式環境。
在 Bob 網路入口網站中建立 Scope 設為 Inference 的 API key。詳細說明請參閱 API keys。
產生金鑰後，請下載或複製金鑰值。請妥善保存，因為您之後將無法再次查看。
請勿與任何人分享您的 API key。
設定 BOB_API_KEY 環境變數為您的 API key 值：
export BOB_API_KEY="your-api-key-here"若要永久設定，請將其加入您的 shell 設定檔（~/.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 chat如果您的 API key 類型為 general（而非 Inference），您還必須在執行 Bob Shell 時傳入 --team-id <team-id>。