بيئة تشغيل معزولة لوكلاء الذكاء الاصطناعي المستقلين مع سياسات YAML تعريفية تفرض قيودًا على نظام الملفات والشبكة والعمليات، بالإضافة إلى حقن بيانات الاعتماد المرتبطة بنقاط النهاية.
[!IMPORTANT] جديد في OpenShell 0.1.x: إيقاع إصدارات مستقر، وبدائيات عزل جديدة، وسطح إضافات موسّع، وواجهات برمجية جديدة. اقرأ دليل الترقية إلى 0.1.0.
OpenShell هو بيئة التشغيل الآمنة والخاصة لأساطيل وكلاء الذكاء الاصطناعي المستقلين. يكون الوكلاء أكثر فائدة عندما يستطيعون قراءة الملفات وتثبيت الحزم واستدعاء واجهات API واستخدام بيانات الاعتماد. يمنحهم OpenShell هذه القدرة دون منحهم وصولاً غير مقيّد إلى بياناتك أو أسرارك أو شبكتك. تُصرّح بما يمكن لكل وكيل الوصول إليه في سياسة، ويقوم OpenShell بفرضها.
يحكم OpenShell ما يمكن للوكلاء فعله بطريقتين: فهو يزوّد النواة بأدوات المراقبة لفرض السياسة على كل وصول إلى الملفات، وكل استدعاء نظام، وكل اتصال شبكي في وقت التشغيل، ويستخدم التحقق الشكلي لفحص ما قد تسمح به أي تغيير في السياسة قبل تطبيقه.
راجع البنية لمعرفة كيفية ترابط البوابة والمشرف والبيئة المعزولة.
تحتاج إلى Linux، أو macOS على Apple Silicon، أو Windows مع WSL 2 (تجريبي)، بالإضافة إلى Docker أو Podman أو المحاكاة الافتراضية للمضيف. راجع مصفوفة الدعم للتفاصيل.
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
يقوم المثبّت بإعداد واجهة سطر الأوامر (CLI) وبوابة محلية. صورة البيئة المعزولة الافتراضية هي Ubuntu بسيطة بدون أي وكيل مثبّت. لتشغيل وكيل حقيقي، اتبع تشغيل وكيلك الأول: فهو يشغّل OpenCode مقابل نموذج مجاني من OpenRouter ويوضح كيفية اعتماد الوصول الجديد حسب حاجة الوكيل إليه.
NetworkPolicy.main.ثبّت مهارات OpenShell العامة لوكيل البرمجة الخاص بك:
npx skills add NVIDIA/OpenShell
تعلّم المهارات وكيلك كيفية تشغيل واجهة OpenShell CLI، وكتابة سياسات البيئات المعزولة، وتصحيح أخطاء البوابات وتوجيه الاستدلال. وهي موجودة في skills/ وتعمل دون الحاجة إلى نسخة مصدرية من OpenShell.
تربط حزم SDK التطبيقات ببوابة OpenShell. وهي لا تثبّت واجهة CLI. استخدم نفس إصدار OpenShell لحزمة SDK والبوابة عند الإمكان.
| اللغة | التثبيت | الوثائق |
|---|---|---|
| Python | uv add openshell | README |
| TypeScript | npm install @nvidia/openshell-sdk (GitHub Packages) | README |
| Go | go get github.com/NVIDIA/OpenShell/sdk/go@latest | README |
| Rust | cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag> | التثبيت والاستخدام |
بُني OpenShell وفق مبدأ الوكيل أولاً: إذ يُطوَّر باستخدام نفس سير العمل المدفوع بالوكلاء الذي يمكّنه. راجع CONTRIBUTING.md لإعداد التطوير وسير عمل المساهمة، وAGENTS.md لاصطلاحات البرمجة في المستودع.
يجمع OpenShell بيانات قياس عن بُعد مجهولة الهوية، تقتصر على الفئات التشغيلية والأعداد، للمساعدة في تحسين المشروع. وهو لا يجمع أسماء البيئات المعزولة، أو أسماء المضيفين، أو مسارات الملفات، أو المطالبات (prompts)، أو بيانات الاعتماد، أو أسماء المزوّدين أو النماذج، أو محتوى المستخدم. لتعطيله، اضبط OPENSHELL_TELEMETRY_ENABLED=false على البوابة، أو server.telemetryEnabled=false لعمليات تثبيت Helm. يمكنك أيضاً استبعاد القياس عن بُعد بالكامل عند الترجمة. راجع القياس عن بُعد للتفاصيل وتقارير القياس عن بُعد المجتمعية لاتجاهات الاستخدام المنشورة.