إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
مهم
- واجهة مصطلح Foundry Local CLI متاحة في مرحلة المعاينة. توفر إصدارات المعاينة العامة access مبكرا إلى الميزات التي يتم نشرها بنشاط.
- يمكن أن تتغير الميزات والنهج والعمليات أو لديها قدرات محدودة، قبل التوفر العام (GA).
تسرد هذه المقالة أفضل الممارسات ونصائح استكشاف الأخطاء وإصلاحها ل Foundry Local CLI.
المتطلبات المسبقه
- قم بتثبيت CLI المحلي في Foundry.
- امتلكوا access إنترنت لتحميل النماذج (موصى به).
- إذا استخدمت الحلول البديل لتثبيت نطاق الآلة في هذا المقال، شغل PowerShell كمسؤول.
تحقق من مؤشر القيادة
شغل الأمر التالي للتأكد من أن واجهة سطر Foundry المحلية مثبتة ومتاحة في مسار PATH:
foundry --help
تسرد هذه الأوامر الأوامر والخيارات المتاحة.
المصدر: مرجع CLI المحلي في فاوندري
أفضل ممارسات الأمان
- قم بتشغيل Foundry Local فقط في البيئات التي تتوافق مع نهج أمان مؤسستك.
- تأكد من أن جهازك يلبي متطلبات الأمان الخاصة بمؤسستك عند التعامل مع البيانات الحساسة.
- تشفير الأقراص على الأجهزة التي تقوم بتخزين النماذج التي تحتوي على بيانات ضبط دقيقة حساسة.
اعتبارات الترخيص
راجع شروط الترخيص من ناشر النموذج قبل استخدام نموذج مع Foundry Local. تأكد من أن الاستخدام المقصود يتوافق مع هذه الشروط ونهج مؤسستك.
أفضل ممارسات الأداء
إذا واجهت استدلال بطيء، ففكر في الاستراتيجيات التالية:
- أوقف أي جلسة استنتاج لمجموعة أدوات Foundry for VS Code قبل تشغيل Foundry Local.
- استخدم تسريع بطاقة الرسوميات عندما يكون متاحا.
- تحديد الاختناقات من خلال مراقبة استخدام الذاكرة أثناء الاستدلال.
- جرب نماذج أكثر كمومية (مثل INT8 بدلا من FP16).
- ضبط أحجام الدفعات لأحمال العمل غير النشطة.
نطاق توزيع الإنتاج
Foundry Local هو للاستدلال على الجهاز، وليس توزيعه، أو حاوياته، أو عمليات نشر الإنتاج متعددة الأجهزة.
استكشاف الأخطاء وإصلاحها
المشكلات والحلول الشائعة
| مشكلة | السبب المحتمل | حل |
|---|---|---|
| الاستدلال البطيء | نموذج المعالج المركزي فقط مع عدد معاملات كبير. | استخدم نماذج محسنة لوحدة معالجة الرسومات عندما تكون متاحة. |
| فشل تنزيل النموذج | مشكلات الاتصال بالشبكة. | تحقق من اتصالك بالإنترنت، ثم قم بتشغيل foundry cache list للتحقق من حالة ذاكرة التخزين المؤقت. |
أخطاء اتصال الخدمة (Request to local service failed. Uri:http://127.0.0.1:0/foundry/list) |
لا يمكن الوصول إلى مشكلات ربط المنفذ أو الخدمة. | قم بتشغيل foundry server restart لإعادة تشغيل البرنامج الخفي وحل مشاكل ربط المنفذ. |
| فشل بدء الخدمة. | تعارضات المنفذ أو مشكلات الأذونات. | شغّل foundry server restart. إذا استمرت المشكلة، فقم بتشغيل foundry server logs، ثم قم بتشغيل foundry report للإبلاغ عن المشكلة مع التشخيصات. |
| لم يتم الكشف عن Intel NPU أو لا يعمل | برنامج تشغيل Intel NPU مفقود أو قديم. | قم بتثبيت برنامج تشغيل Intel NPU ل Windows لتمكين تسريع NPU. |
خطأ Qualcomm NPU (Qnn error code 5005: "Failed to load from EpContext model. qnn_backend_manager.") |
تعارضات برنامج تشغيل Qualcomm NPU أو موارد NPU القديمة. | تثبيت برنامج تشغيل Qualcomm NPU. إذا استمرت المشكلة، أعد التشغيل لإزالة تعارضات موارد وحدات NPU، خاصة بعد استخدام ميزات Windows Copilot+. |
يفشل winget install Microsoft.FoundryLocal --scope machine مع "التكوين الحالي للنظام لا يدعم تثبيت هذه الحزمة." |
Winget يمنع تركيب جهاز MSIX على نطاق الجهاز. | استخدم الحل المؤقت في مشاكل التثبيت. |
مشكلات التثبيت
إذا فشل winget install Microsoft.FoundryLocal --scope machine مع "التكوين الحالي للنظام لا يدعم تثبيت هذه الحزمة."، استخدم Add-AppxProvisionedPackage بدلا من ذلك.
- قم بتحميل
.msixحزمة الاعتماد الخاصة بها. - شغل PowerShell كمسؤول.
- شغل الأمر التالي لتثبيت Foundry Local لجميع المستخدمين:
Add-AppxProvisionedPackage -Online -PackagePath .\FoundryLocal.msix `
-DependencyPackagePath .\VcLibs.appx -SkipLicense