Hub 文档

门控组集合

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

门控组集合

此功能是团队和企业计划的一部分。

门控组集合允许组织一次性授予(或拒绝)对集合中所有模型和数据集的访问权限,而不是每个存储库单独操作。用户只需进行**一次访问请求**。

要在集合中启用门控组,需要满足以下条件:

  • 集合所有者必须是一个组织。
  • 该组织必须订阅了企业版 Hub。
  • 集合中的所有模型和数据集必须由与集合相同的组织拥有。
  • 集合中的每个模型或数据集只能属于一个门控组集合(但它们仍可包含在非门控即*常规*集合中)。
门控仅适用于模型和数据集;集合中的任何其他资源(例如 Space 或 Paper)不会受到影响。

作为组织管理员管理门控组

要启用访问请求,请转到集合页面并单击右下角的**门控组**。

Hugging Face collection page with gating group collection feature disabled

默认情况下,门控组处于禁用状态:单击**配置访问请求**以打开设置。

Hugging Face gating group collection settings with gating disabled

默认情况下,用户请求访问时,集合中的存储库将自动授予其访问权限。这称为**自动批准**。在此模式下,任何用户一旦同意与您共享其联系信息,即可访问您的存储库。

Hugging Face gating group collection settings with automatic mode selected

如果您想手动批准哪些用户可以访问集合中的存储库,则必须将其设置为**手动审核**。在这种情况下,您会看到一个新选项

**通知频率**,可让您配置何时收到新用户请求访问的通知。它可以设置为每天一次或实时。默认情况下,电子邮件会发送给组织的前 5 位管理员。您还可以在**通知电子邮件**字段中设置不同的电子邮件地址。

Hugging Face gating group collection settings with manual review mode selected

审查访问请求

一旦启用访问请求,您将完全控制哪些用户可以访问门控组集合中的存储库,无论批准模式是手动还是自动。您可以从 UI 或通过 API 审查和管理请求。

批准门控组集合中某个存储库的请求将自动批准对该集合中所有存储库(模型和数据集)的访问权限。

通过用户界面

您可以通过集合中任何存储库的设置页面,点击**审查访问请求**按钮,审查谁有权访问您的门控组集合中的所有存储库。

Hugging Face repo access settings when repo is in a gating group collection

这将打开一个包含 3 个用户列表的模态框

  • **待处理**:等待批准以访问您的存储库的用户列表。除非您选择了**手动审查**,否则此列表为空。您可以**接受**或**拒绝**每个请求。如果请求被拒绝,用户将无法访问您的存储库,也无法再次请求访问。
  • **已接受**:有权访问您的存储库的完整用户列表。您可以随时**拒绝**任何用户的访问权限,无论批准模式是手动还是自动。您还可以**取消**批准,这将把用户移到**待处理**列表。
  • **已拒绝**:您手动拒绝的用户列表。这些用户无法访问您的存储库。如果他们访问您的存储库,他们会看到一条消息:“您访问此存储库的请求已被存储库作者拒绝。”
Manage access requests modal for a repo in a gating group collection

通过 API

您可以通过其任何模型或数据集的 API,以编程方式管理门控组集合中的访问请求。

请访问我们的门控模型门控数据集文档以了解更多信息。

下载访问报告

您可以通过门控组集合中任何模型或数据集的设置页面下载该集合的访问报告。

请访问我们的门控模型门控数据集文档以了解更多信息。

自定义请求信息

组织可以自定义门控参数以及每个门控存储库收集的用户信息。请访问我们的门控模型门控数据集文档了解更多详细信息。

目前无法集中自定义门控参数和请求信息。如果您希望无论用户请求访问哪个集合的存储库,都能收集相同的数据,您需要在集合中所有模型和数据集的元数据中添加相同的门控参数,并保持同步。

作为用户访问门控组集合中的门控存储库

门控组集合的名称旁边会显示一个特定图标。

Hugging Face collection page with gating group collection feature enabled

要访问门控组集合中的模型和数据集,只需在其任何存储库页面上发出一次访问请求。一旦您的请求获得批准,您将能够访问集合中的所有其他存储库,包括未来的存储库。

请访问我们的门控模型门控数据集文档,了解有关请求访问存储库的更多信息。

< > 在 GitHub 上更新