التثبيت
يمكنك تثبيت Bob Shell بسكريبت تثبيت أو مدير الحزم أو لوحة الأوامر.
متطلبات النظام
أنظمة التشغيل
macOS أو Linux أو Windows أو z/OS UNIX System Services (os390-s390x) أو Linux on IBM Z
الذاكرة
الحد الأدنى 4 جيجابايت RAM (يُوصى بـ 8 جيجابايت)
التخزين
الحد الأدنى 500 ميجابايت مساحة قرص متاحة
الشبكة
اتصال إنترنت نشط
Node.js
الإصدار 24 أو أحدث
مدير الحزم أو Bob IDE
التثبيت بأوامر الطرفية أو لوحة الأوامر
التثبيت
يتطلب 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"التثبيت على z/OS UNIX System Services وLinux on IBM Z أكثر تعقيدًا. للاطلاع على التعليمات الكاملة، راجع تثبيت Bob Shell واستخدامه على IBM Z.
التثبيت من الحزمة المُنزَّلة
إذا نزّلت حزمة Bob Shell يدويًا من صفحة الإصدارات، يمكنك تثبيتها باستخدام أحد مديري الحزم التالية:
يجب عليك تعديل الأوامر التالية لاستخدام المسار الفعلي لموقع الملف المُنزَّل.
يجب تشغيل أوامر Windows التالية باستخدام PowerShell.
المصادقة
يستخدم Bob Shell نفس نقطة دخول تسجيل الدخول كجميع عملاء Bob الآخرين: bob.ibm.com/login. عندما تشغّل Bob Shell لأول مرة، أو بعد انتهاء صلاحية جلستك، يفتح Bob متصفحك على هذه الصفحة.
للاطلاع على نظرة عامة كاملة على كيفية عمل تسجيل الدخول، بما في ذلك IBMid وSSO وإدارة الجلسات، راجع تسجيل الدخول.
اختر من بين طريقتَي مصادقة، بناءً على حالة استخدامك.
| الطريقة | حالة الاستخدام | المتطلبات |
|---|---|---|
| SSO / IBMid | الجلسات التفاعلية | حساب IBMid صالح أو حساب SSO للشركة، وصول للمتصفح |
| مفتاح API | الأتمتة وCI/CD pipelines والبيئات غير التفاعلية | مفتاح API من بوابة Bob الإلكترونية، متغير بيئة |
مصادقة SSO / IBMid (الافتراضية)
عندما يحتاج Bob Shell إلى المصادقة، يفتح bob.ibm.com/login في متصفحك. أدخل عنوان بريدك الإلكتروني IBMid وانقر على Continue لتوجيهك تلقائيًا إلى مزود الهوية الصحيح.
- إذا قامت مؤسستك بتكوين SSO، ستُعاد توجيهك إلى صفحة تسجيل الدخول الخاصة بشركتك.
- وإلا، ستُعاد توجيهك إلى IBMid.
بعد إتمام المصادقة في متصفحك، عُد إلى Bob Shell. ستُنشأ جلستك تلقائيًا.
مصادقة مفتاح API
مصادقة مفتاح API مثالية للأتمتة وCI/CD pipelines والبيئات غير التفاعلية حيث لا تتوفر مصادقة المتصفح.
أنشئ مفتاح API مع Scope مضبوطًا على Inference في بوابة Bob الإلكترونية. للاطلاع على التعليمات التفصيلية، راجع مفاتيح API.
بعد توليد المفتاح، نزّله أو انسخ قيمته. احتفظ به بأمان إذ لن تتمكن من رؤيته مجددًا.
لا تشارك مفتاح API مع أي أحد.
عيّن متغير البيئة BOB_API_KEY بقيمة مفتاح API:
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')شغّل Bob Shell مع مفتاح API الخاص بك:
bob run "your prompt"أو ابدأ جلسة تفاعلية:
bob chatإذا كان مفتاح API من نوع general (وليس Inference)، يجب أيضًا تمرير --team-id <team-id> عند تشغيل Bob Shell.
إذا واجهت مشاكل شبكية أثناء التثبيت أو المصادقة، قد تحتاج إلى ضبط إعدادات الوكيل. لمزيد من المعلومات، راجع ضبط إعدادات الوكيل أو قسم استكشاف الأخطاء.