설치하기
설치 스크립트 또는 패키지 관리자를 사용하여 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, 세션 관리 방법에 대한 전체 개요는 로그인을 참조하세요.
사용 사례에 따라 2가지 인증 방법 중 선택하세요.
| 방법 | 사용 사례 | 요구 사항 |
|---|---|---|
| SSO / IBMid | 대화형 세션 | 유효한 IBMid 또는 기업 SSO 계정, 브라우저 접근 |
| API key | 자동화, CI/CD pipeline, 비대화형 환경 | Bob 웹 포털의 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 웹 포털에서 Scope를 Inference로 설정한 API key를 만드세요. 자세한 지침은 API key를 참조하세요.
키를 생성한 후 다운로드하거나 키 값을 복사하세요. 다시 볼 수 없으니 안전하게 보관하세요.
API key를 누구에게도 공유하지 마세요.
API key 값으로 BOB_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>도 함께 전달해야 합니다.
설치 또는 인증 중 네트워크 문제가 발생하면 프록시 설정을 구성해야 할 수 있습니다. 자세한 내용은 프록시 설정 구성 또는 Troubleshooting 섹션을 참조하세요.