التحكم المتقدم في الوصول داخل المنظمات باستخدام مجموعات الموارد

تُعد هذه الميزة جزءًا من خطط الفريق والمؤسسات.

في منظمتك على Hugging Face، يمكنك استخدام Resource Groups للتحكم في الأعضاء الذين لديهم وصول إلى مستودعات محددة.

كيف يعمل؟

تتيح مجموعات الموارد لمديري المؤسسة تجميع المستودعات ذات الصلة معًا، مما يسمح لفِرق مختلفة في مؤسستك بالعمل على مجموعات مستقلة من المستودعات.

• الموارد: مستودعات المجموعة ومجموعاتها. يمكن أن ينتمي كل مورد إلى مجموعة موارد واحدة فقط، ويمكن نقله بين المجموعات من قبل الأعضاء الذين يتمتعون بالصلاحيات المناسبة.
• الأعضاء: يجب إضافة أعضاء المنظمة إلى مجموعة موارد للوصول إلى مستودعاتها. يمكن أن ينتمي العضو إلى عدة مجموعات موارد.

يُمنح الأعضاء دور في كل مجموعة موارد يحدد صلاحياتهم في مستودعات المجموعة. توجد أربعة أدوار مميزة لمجموعات الموارد:

• read: يمنح صلاحية القراءة للمستودعات ضمن مجموعة الموارد.
• contributor: يوفر صلاحيات كتابة محدودة بالمستودعات التي أنشأها المستخدم (أي يمكن للمستخدمين إنشاء مستودعات ثم تعديل تلك المستودعات فقط). يشبه دور ‘Write’، لكنه محدود بالمستودعات التي أنشأها المستخدم.
• write: يوفر صلاحية الكتابة لجميع المستودعات في مجموعة الموارد. يمكن للمستخدمين إنشاء مستودع أو حذفه أو إعادة تسميته في مجموعة الموارد.
• admin: بالإضافة إلى أذونات الكتابة على المستودعات، يمكن لأعضاء الإدارة إدارة مجموعة الموارد: إضافة أعضاء وإزالتهم وتغيير أدوار الأعضاء الآخرين. كما يمكنهم إدارة المستودعات الموجودة مسبقًا في مجموعة الموارد.
• inherit: دور العضو في مجموعة الموارد هو نفسه دوره في المنظمة. على سبيل المثال، العضو الذي يحمل دور write في المنظمة ويُضاف إلى مجموعة بدور inherit يحصل على صلاحية write داخل المجموعة

بالإضافة إلى ذلك، يمكن لمسؤولي المؤسسة إدارة جميع مجموعات الموارد داخل المؤسسة. ويشمل ذلك نقل المستودعات إلى أي مجموعة موارد أو خارجها.

تؤثر مجموعات الموارد أيضًا على ظهور المستودعات الخاصة داخل المنظمة:

• المستودع الخاص الذي يُعد جزءًا من مجموعة موارد يكون مرئيًا فقط لـأعضاء تلك مجموعة الموارد.
• المستودعات العامة مرئية لـأي شخص، داخل المنظمة وخارجها.
• تنطبق قواعد الظهور نفسها على المجموعات الخاصة التي تنتمي إلى مجموعة موارد.

البدء

انتقل إلى إعدادات مؤسستك، ثم انتقل إلى عنصر “Resource Groups” في القائمة الجانبية اليسرى. تنقسم الصفحة إلى تبويبين: Resource Groups، حيث تُعرض المجموعات نفسها وتُدار، وAccess settings، حيث يحدد مسؤولو المؤسسة من يمكنه إنشاء مجموعات الموارد وأي أعضاء يمكنهم استخدام ميزات محددة في المؤسسة.

يمكن لمسؤولي المنظمة إنشاء مجموعات الموارد وإدارتها من تلك الصفحة. اعتماداً على إعدادات المنظمة، قد يُسمح للأعضاء الذين يشغلون أدواراً أدنى بإنشاء مجموعات الموارد أيضاً (انظر من يمكنه إنشاء مجموعات الموارد أدناه).

بعد إنشاء مجموعة موارد ومنحها اسمًا ذي معنى، ستنتقل إلى صفحة المجموعة. وهي منظمة في أربعة تبويبات:

• نظرة عامة: ملخص للمجموعة (أنواع المستودعات، أدوار الأعضاء، حالة الإدراج التلقائي وحد الإنفاق) إلى جانب معاينة لمواردها ومستخدميها.
• الموارد: القائمة الكاملة بمستودعات المجموعة ومجموعاتها، بالإضافة إلى المهام التي تُحتسب على المجموعة، مع إمكانية البحث والترتيب والتصفية. هذا هو المكان الذي تضيف فيه الموارد إلى المجموعة.
• المستخدمون: أعضاء المجموعة وأدوارهم، مع إمكانية البحث والفرز. هذا هو المكان الذي تضيف فيه المستخدمين وتدير أدوارهم.
• الإعدادات: تكوين حدود الإنفاق والإدراج التلقائي للمجموعة.

يمكنك البدء بإضافة المستودعات والمستخدمين إلى المجموعة من خلال تبويبي الموارد والمستخدمون.

عند إضافة مستخدمين إلى مجموعة موارد، يمكنك البحث عبر عنوان البريد الإلكتروني إذا كان لدى المستخدم بريد إلكتروني خاص بالمنظمة (مثل user@your-company.com) يطابق نطاق بريد المنظمة الخاص بك.

تذكر أن المستودع يمكن أن يكون جزءًا من مجموعة موارد واحدة فقط. ستظهر لك تحذيرات عند محاولة إضافة مستودع ينتمي بالفعل إلى مجموعة موارد أخرى.

الانضمام التلقائي

تضيف ميزة الانضمام التلقائي أعضاء المنظمة تلقائيًا إلى مجموعة الموارد بدور محدد: ويشمل ذلك الأعضاء الذين كانوا بالفعل في المنظمة عند تفعيل الانضمام التلقائي، وأي أعضاء جدد ينضمون في المستقبل.

يُعدّ هذا مفيدًا لمجموعات الموارد التي يجب أن تكون متاحة لمنظمتك بأكملها دون الحاجة إلى إدارة العضوية يدويًا.

تفعيل الانضمام التلقائي

• عبر الواجهة: افتح تبويب الإعدادات لمجموعة الموارد، ثم فعّل خيار تضمين جميع أعضاء المنظمة تلقائيًا في قسم تضمين أعضاء المنظمة تلقائيًا، واختر الدور المراد إسنادُه. كما يربط تبويب المستخدمين إلى هذا القسم، معطياً مؤشراً على ما إذا كان التضمين التلقائي مفعّلاً أم لا.
• عبر واجهة برمجة التطبيقات: راجع إعداد الانضمام التلقائي عبر واجهة برمجة التطبيقات.

عند تمكين الانضمام التلقائي لمجموعة موارد موجودة، يتم إضافة أعضاء المنظمة الحاليين المطابقين للنطاق المحدد إلى المجموعة فوراً بالدور المُعد (إعادة التعبئة).

نطاق الانضمام التلقائي

يمكن تطبيق الانضمام التلقائي على:

• جميع أعضاء المنظمة (الافتراضي): اترك تضمين أعضاء no_access غير محدد لاستبعاد الأعضاء الذين يحملون دور no_access في المنظمة.
• جميع أعضاء المنظمة بما في ذلك no_access: تحقق من تضمين أعضاء no_access لتضمين كل عضو، بما في ذلك الأعضاء الذين يحملون دور no_access في المنظمة.

استخدم أعضاء Read+ فقط عندما يجب أن يحتفظ أعضاء no_access بالوصول إلى مجموعات الموارد المحددة التي أُضيفوا إليها يدويًا أو عبر تدفق إعداد آخر.

الانضمام التلقائي وSCIM

التضمين التلقائي وإدارة SCIM متنافيان على نفس مجموعة الموارد. يضيف التضمين التلقائي أعضاء المنظمة تلقائيًا، بينما تعني إدارة SCIM أن مزود الهوية فقط هو من يتحكم في العضوية. تتعارض هاتان السلوكيتان، لذلك:

• لا يمكنك تفعيل الانضمام التلقائي على مجموعة موارد مرتبطة بمجموعة SCIM.
• لا يمكنك ربط مجموعة SCIM بمجموعة موارد تم فيها تفعيل الانضمام التلقائي.

لتبديل مجموعة الموارد من الانضمام التلقائي إلى الإدارة عبر SCIM (أو العكس)، قم بإيقاف الإعداد الحالي أولاً.

دعوات خارجية

يمكنك مشاركة مجموعات الموارد مع مستخدمين خارج منطمتك. يقوم مسؤولو المنظمة بتفعيل ذلك من خلال إعداد External invitations، الموجود في تبويب Access settings في صفحة إعدادات مجموعات الموارد. يكون هذا الإعداد معطلاً افتراضياً، ولا يتوفر للمنظمات التي لديها managed users.

ينضم المستخدمون المدعوون بوصفهم متعاونين خارجيين:

• بشكل افتراضي، يحصلون على دور المنظمة no_access، لذا فإنهم لا يرون سوى موارد مجموعة الموارد هذه.
• يمكنك دعوتهم بدور read أو write في مجموعة الموارد.
• لا يتعين عليهم تسجيل الدخول عبر خدمة SSO الخاصة بمنظمتك.

لدعوة شخص ما، افتح تبويب Users في مجموعة الموارد وأضِفه باستخدام اسم المستخدم. ينضم أعضاء المنظمة إلى المجموعة فورًا، بينما يتلقى الأشخاص الخارجون دعوة. تبقى الدعوات المعلّقة ضمن مستخدمين المجموعة تحت شارة “Pending”، ويمكنك إعادة إرسالها أو إلغاؤها. استخدم مرشح External لعرض المتعاونين الخارجيين فقط.

مشاركة مستودع مع متعاونين خارجيين

يمكن أيضًا لمسؤولي مجموعة الموارد مشاركة مستودع خاص من صفحتها الإعدادات، تحت المشاركة مع المتعاونين الخارجيين. تُدرج هذه القسم من هم بالفعل ضمن مجموعة الموارد الخاصة بالمستودع، وتتيح لك دعوة متعاونين خارجيين للانضمام إليها. أي شخص تضيفه هناك يحصل على وصول إلى كل الموارد في مجموعة الموارد، وليس فقط إلى ذلك المستودع.

إذا لم يكن المستودع ضمن مجموعة موارد بعد، يمكن للأعضاء القادرين على إنشاء مجموعات موارد إنشاء مجموعة من ذلك القسم ودعوة المتعاونين في الوقت نفسه. يكون التضمين التلقائي مفعلاً افتراضياً: فهو يضع أعضاء المنظمة (باستثناء أولئك الذين يحملون دور no_access) في المجموعة الجديدة عبر الانضمام التلقائي بدور inherit، مما يحافظ على وصولهم الحالي إلى المستودع. إذا قمت بإيقافه، فلن يتمكن من رؤيته سوى المستخدمون الذين تضيفهم إلى مجموعة الموارد، بالإضافة إلى مسؤولي المنظمة.

يمكنك أيضًا إدارة الدعوات الخارجية عبر واجهة برمجة التطبيقات: دعوة مشاركين خارجيين عبر واجهة برمجة التطبيقات.

من يمكنه إنشاء مجموعات الموارد

بشكل افتراضي، لا يمكن إلا لمسؤولي المنظمة إنشاء مجموعات موارد جديدة. يمكن لمسؤولي المنظمة تغيير ذلك من خلال تعيين أدنى دور عضو مطلوب لإنشاء مجموعات الموارد في تبويب إعدادات الوصول في صفحة إعدادات مجموعات الموارد.

الخيارات المتاحة هي:

• للمشرفين فقط (الافتراضي): لا يمكن إنشاء مجموعات الموارد إلا للمشرفين في المنظمة.
• Write+: يمكن للأعضاء الذين يحملون دور Write أو Admin إنشاء مجموعات الموارد.
• Contributor+: يمكن للأعضاء الذين يحملون دور Contributor أو Write أو Admin إنشاء مجموعات الموارد.
• قراءة+: يمكن لأي عضو في المنظمة إنشاء مجموعات الموارد، باستثناء الأعضاء الذين يحملون دور المنظمة no_access.

عندما ينشئ عضو غير مسؤول مجموعة موارد عبر واجهة المستخدم، يُضاف تلقائيًا كـ مسؤول للمجموعة الجديدة التي تم إنشاؤها. أما عبر واجهة برمجة التطبيقات، فلا يحدث ذلك تلقائيًا، إذ قد يقوم مستدعو واجهة برمجة التطبيقات بإنشاء مجموعات نيابةً عن أشخاص آخرين. يجب على مستدعي واجهة برمجة التطبيقات غير المسؤولين تضمين مستخدم واحد على الأقل يحمل دور المسؤول في قائمة الأعضاء الأولية للمجموعة.

الوصول التفصيلي إلى الميزات

تُعد هذه الميزة جزءًا من خطة Enterprise وما فوقها.

يمكن لمسؤولي المنظمة أيضًا التحكم في الأشخاص المسموح لهم باستخدام ميزة معينة للمنظمة، بشكل منفصل عن الوصول إلى المستودع. يتوفر هذا الإعداد في تبويب Access settings في صفحة إعدادات مجموعات الموارد.

يمكن تقييد الميزات التالية:

• المدونة: كتابة ونشر مقالات المدونة الخاصة بالمنظمة.
• المجموعات: إنشاء مجموعات collections للمنظمة وتحريرها.
• المهام: تشغيل وعرض المهام التي تُحتسب على المنظمة.
• نقاط الاستدلال: إنشاء نقاط الاستدلال المملوكة للمنظمة وإدارتها واستدعاؤها.
• مزودو الاستدلال: طلبات مزودو الاستدلال التي تُحتسب على المنظمة.

يمكنك تحديد من يملك صلاحية الوصول إلى كلٍّ منها:

• الجميع (الافتراضي): كل عضو في المنظمة بناءً على دوره في المنظمة.
• لمشرفي المنظمة فقط: يحتفظ مشرفو المنظمة بالوصول فقط.
• مجموعات موارد محددة: أعضاء مجموعات الموارد المحددة فقط، وذلك بناءً على دورهم في المجموعة.

يحتفظ مسؤولو المنظمة دائمًا بالوصول إلى كل ميزة، بغض النظر عن الخيار المحدد.

تحديد ميزة لمجموعات موارد محددة يتحكم في من يمكنه استخدام الميزة، وليس أين. يمكن لأعضاء المجموعات المحددة مواصلة استخدام الميزة في أي مكان داخل المنظمة (على سبيل المثال، إنشاء مجموعة لا تنتمي إلى أي مجموعة موارد)، بينما يفقد الأعضاء الآخرون الوصول إلى الميزة بالكامل. لا تمنح هذه القيود صلاحيات إضافية: ما يمكن أن يفعله العضو لا يزال محددًا بدورهم في المنظمة.

لم يعد بإمكان الأعضاء الذين لا يملكون صلاحية الوصول استخدام الميزة في سياق المنظمة، سواء عبر واجهة برمجة التطبيقات (API) أو واجهة المستخدم. تُرجع طلبات واجهة برمجة التطبيقات (API) خطأً في الترخيص. ولا يتغير أي شيء بالنسبة لهم في حساباتهم الشخصية أو في منظمة أخرى.

نسبة التكلفة

تُعد هذه الميزة جزءًا من خطة Enterprise وما فوقها.

تُعد مجموعات الموارد أيضًا وحدةً لنسبة التكاليف إلى خدمات الحوسبة. عند فواتير الحوسبة إلى مجموعة موارد، يتم تتبع التكاليف بشكل منفصل لكل مجموعة، مما يسهل فهم الإنفاق عبر الفرق.

• Spaces: يتم إسناد التكلفة تلقائيًا إلى مجموعة الموارد التي ينتمي إليها المساحة.
• المهام: اضبط namespace على المنظمة المالكة، ومرر معرّف مجموعة الموارد باستخدام resource_group_id في Python، أو --resource-group-id في سطر الأوامر، أو resourceGroupId في جسم طلب HTTP. راجع الفوترة إلى مجموعة موارد.
• مزودو الاستدلال: مرّر معرّف مجموعة الموارد عبر الترويسة X-HF-Bill-To (أو المعامل bill_to في SDK). راجع الفوترة لمنظمات الفرق والمؤسسات.
• نقاط نهاية الاستدلال: يتم إسناد التكلفة تلقائيًا إلى مجموعة الموارد التي ينتمي إليها مستودع النموذج. لا يتم دعم نقاط النهاية التي يتم إنشاؤها مباشرةً من كتالوج نقاط نهاية الاستدلال المدمج في الوقت الحالي.

يمكنك استخدام نقطة النهاية المخصصة لاسترداد بيانات إسناد التكاليف لمجموعات الموارد.

حدود الإنفاق

تُعد هذه الميزة جزءًا من خطة Enterprise وما فوقها.

إلى جانب تتبع التكاليف، يمكنك تحديد سقف لها. يمكن لمديري المؤسسة ومديري مجموعات الموارد تحديد حدود الإنفاق الشهرية في تبويب الإعدادات للمجموعة، تحت حدود الإنفاق.

يتوفر نوعان من الحدود، وكلاهما معبر عنه بالدولار الأمريكي:

• الإجمالي (جميع المنتجات): يحدد الحد الأقصى للإنفاق الحسابي المجمّع للمجموعة.
• حد لكل منتج على حدة لـ Inference Providers و Spaces و Jobs و Inference Endpoints، بالإضافة إلى الحد الإجمالي.

اترك الحقل فارغًا لعدم وجود حد. عندما ينطبق حد إجمالي وحد لكل منتج، يسري الأقسى منهما.

تُطبَّق الحدود على الإنفاق المنسوب إلى المجموعة خلال الشهر التقويمي الحالي، لذا تُفكَّ حجب المجموعة التي بلغت حدّها في بداية الشهر التالي، أو فور رفع المسؤول للحد.

ما الذي يحدث عند الوصول إلى حد

تُرفض أي استخدامات جديدة تُحتسب على مجموعة الموارد مع خطأ في الترخيص:

• مزودو الاستدلال: تُرفض الطلبات التي تُحتسب على المجموعة.
• المهام: يتم رفض إنشاء مهمة أو إعادة إرسالها أو استئنافها ضمن المجموعة، بما في ذلك المهام المجدولة.
• Spaces: يتم رفض ترقية مساحة ضمن المجموعة إلى أجهزة مدفوعة.
• نقاط نهاية الاستدلال: تُرفض الطلبات الموجهة إلى نقاط النهاية التي تتسبب في تكاليف على المجموعة.

تُوقَف الأحمال التشغيلية التي تعمل بالفعل في المجموعة أيضًا، بعد بلوغ الحد مباشرة:

• تُوقف Spaces المدفوعة. أما الـ Spaces على الأجهزة المجانية فتبقى كما هي، وكذلك الأمر بالنسبة للـ Spaces التي تعمل على منحة أجهزة.
• تُلغى المهام، مع تحديد Resource group spend limit reached كسبب للإيقاف.

يرفع رفع الحد، أو بدء شهر جديد، من قدرة الأعضاء على بدء أحمال عمل جديدة مرة أخرى. أما المساحات والمهام التي تم إيقافها فلا تُستأنف تلقائيًا.

يمكنك أيضًا تحديد حدود الإنفاق برمجياً، راجع تحديد حدود الإنفاق عبر واجهة برمجة التطبيقات.

واجهة برمجة تطبيقات مجموعات الموارد

يمكنك سرد مجموعات الموارد وإضافة المستخدمين إليها (أو تغيير دور العضو في المؤسسة وتعيينات مجموعة الموارد) عبر واجهة برمجة تطبيقات Hub. للاطلاع على المرجع الكامل والأمثلة وتدفقات العمل الدفعية، راجع دليل إدارة التحكم في وصول المستخدم برمجيًا.

Update on GitHub