Hub 文档

门控组集合

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

门控组集合

此功能是 企业版 Hub 的一部分。

门控组集合允许组织一次性授予(或拒绝)访问集合中所有模型和数据集的权限,而不是逐个仓库进行。用户只需提交一次访问请求

要在集合中启用门控组

  • 集合所有者必须是组织
  • 组织必须订阅企业版 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 审核和管理请求。

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

从 UI

您可以通过单击审核访问请求按钮,从集合中任何仓库的设置页面审核谁有权访问您的门控组集合中的所有仓库

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 上更新