Installazione
Puoi installare Bob Shell con uno script di installazione o il tuo package manager.
Requisiti di sistema
Sistemi operativi
macOS, Linux o Windows
Memoria
Minimo 4 GB RAM (8 GB consigliati)
Archiviazione
Minimo 500 MB di spazio su disco disponibile
Rete
Connessione Internet attiva
Node.js
Versione 24 o successiva
Installazione
Bob Shell 2.0.0 richiede una nuova installazione. Attualmente non esiste un percorso di aggiornamento automatico da 1.0.x. Le tue impostazioni e configurazioni esistenti verranno preservate durante l'installazione.
Scegli di installare Bob Shell con uno script di installazione, il tuo package manager o il command palette.
Utilizzo degli script di installazione
Seleziona il tuo sistema operativo, quindi copia ed esegui il comando per installare 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"Installazione dal pacchetto scaricato
Se hai scaricato manualmente il pacchetto Bob Shell dalla pagina Releases, puoi installarlo usando uno dei seguenti package manager:
Devi modificare i seguenti comandi per usare il percorso effettivo dove hai scaricato il file.
Devi eseguire i seguenti comandi Windows con PowerShell.
Autenticazione
Bob Shell usa lo stesso punto di accesso per l'autenticazione di tutti gli altri client Bob: bob.ibm.com/login. Quando esegui Bob Shell per la prima volta, o dopo la scadenza della sessione, Bob apre il tuo browser su questa pagina.
Per una panoramica completa del funzionamento del login, inclusi IBMid, SSO e gestione delle sessioni, consulta Accedi.
Scegli tra 2 metodi di autenticazione, a seconda del tuo caso d'uso.
| Metodo | Caso d'uso | Requisiti |
|---|---|---|
| SSO / IBMid | Sessioni interattive | Account IBMid o SSO aziendale valido, accesso al browser |
| API key | Automazione, pipeline CI/CD, ambienti non interattivi | API key dal portale web Bob, variabile d'ambiente |
Autenticazione SSO / IBMid (predefinita)
Quando Bob Shell deve autenticarsi, apre bob.ibm.com/login nel tuo browser. Inserisci il tuo indirizzo email IBMid e fai clic su Continua per essere instradato automaticamente all'identity provider corretto.
- Se la tua organizzazione ha configurato SSO, vieni reindirizzato alla pagina di login aziendale.
- Altrimenti, vieni reindirizzato a IBMid.
Dopo aver completato l'autenticazione nel browser, torna a Bob Shell. La sessione viene stabilita automaticamente.
Autenticazione con API key
L'autenticazione con API key è ideale per l'automazione, le pipeline CI/CD e gli ambienti non interattivi dove l'autenticazione tramite browser non è disponibile.
Crea una API key con Scope impostato su Inference nel portale web Bob. Per istruzioni dettagliate, consulta API key.
Dopo aver generato la chiave, scaricala o copia il valore della chiave. Conservala in modo sicuro perché non potrai visualizzarla di nuovo.
Non condividere mai la tua API key con nessuno.
Imposta la variabile d'ambiente BOB_API_KEY con il valore della tua API key:
export BOB_API_KEY="your-api-key-here"Per rendere questa impostazione permanente, aggiungila al tuo profilo shell (~/.bashrc, ~/.zshrc, ecc.):
echo 'export BOB_API_KEY="your-api-key-here"' >> ~/.bashrc$env:BOB_API_KEY="your-api-key-here"Per rendere questa impostazione permanente, usa:
[System.Environment]::SetEnvironmentVariable('BOB_API_KEY', 'your-api-key-here', 'User')Esegui Bob Shell con la tua API key impostata:
bob run "your prompt"Oppure avvia una sessione interattiva:
bob chatSe la tua API key è di tipo general (anziché Inference), devi passare anche --team-id <team-id> quando esegui Bob Shell.
Se riscontri problemi di rete durante l'installazione o l'autenticazione, potrebbe essere necessario configurare le impostazioni del proxy. Per maggiori informazioni, consulta Configurazione delle impostazioni proxy o la sezione Risoluzione dei problemi.