Kapılı veri setleri

Veri setlerinin kullanımına daha fazla kontrol sağlamak için Hub, veri seti yazarlarına veri setleri için erişim isteklerini etkinleştirmelerine olanak tanır. Etkinleştirildiğinde, kullanıcılar veri seti dosyalarına erişmek için bir istek göndermelidir; bu istek, yazarlar toplama işlemini devre dışı bırakmadığı sürece Hugging Face bilgilerini (kullanıcı adı ve e-posta adresi) veri seti yazarlarıyla paylaşır. Veri seti yazarları ayrıca özel alanlar da ekleyebilir. Erişim istekleri etkinleştirilmiş bir veri setine kısıtlı veri seti denir. Erişim istekleri, tüm kuruluşlara değil, her zaman bireysel kullanıcılara verilir. Kısıtlı veri setlerinin yaygın bir kullanım senaryosu, daha geniş bir dağıtımdan önce erken araştırma veri setlerine erişim sağlamaktır.

Bir veri seti yazarı olarak kapalı veri setlerini yönetme

Erişim isteklerini etkinleştirmek için veri kümesi ayarları sayfasına gidin. Varsayılan olarak veri kümesi kapalıdır. Sağ üst köşedeki Erişim isteğini etkinleştir seçeneğine tıklayın.

Varsayılan olarak, veri setine erişim, kullanıcı veri setini talep ettiğinde otomatik olarak sağlanır. Buna otomatik onay denir. Bu modda, herhangi bir kullanıcı kişisel bilgilerini sizinle paylaştığında veri setinize erişebilir.

Hangi kullanıcıların veri setinize erişebileceğini manuel olarak onaylamak istiyorsanız, bunu manual approval olarak ayarlamalısınız. Bu durumda daha fazla seçenek göreceksiniz:

• Erişim ekle, bir kullanıcıyı aramanıza ve talep etmemiş olsa bile ona erişim izni vermenize olanak tanır.
• Bildirim sıklığı, yeni kullanıcılar erişim talep ettiğinde ne zaman bildirim alacağınızı yapılandırmanızı sağlar. Günde bir kez veya gerçek zamanlı olarak ayarlanabilir. Varsayılan olarak, bir e-posta birincil e-posta adresinize gönderilir. Bir kuruluş altında barındırılan veri kümeleri için, e-postalar varsayılan olarak kuruluşun ilk 5 yöneticisine gönderilir. Her iki durumda da (kullanıcı veya kuruluş) Bildirim e-postası alanında farklı bir e-posta adresi belirleyebilirsiniz.

Erişim isteklerini gözden geçirin

Erişim istekleri etkinleştirildiğinde, onay modu manuel veya otomatik olsun ya da olmasın, veri setinize kimlerin erişebileceğini tam olarak kontrol edersiniz. İstekleri arayüzden veya API üzerinden inceleyebilir ve yönetebilirsiniz.

Arayüzden

Gated veri setinize kimlerin erişim yetkisi olduğunu, ayarlar sayfasındaki Erişim isteklerini incele düğmesine tıklayarak görüntüleyebilirsiniz. Bu işlem, kullanıcıların 3 listeden oluşan bir pencereyi açar:

• pending: veri setinize erişim için onay bekleyen kullanıcıların listesi. Bu liste, manual approval seçeneğini seçmediğiniz sürece boş kalır. Talebi Accept veya Reject edebilirsiniz. Talep reddedilirse, kullanıcı veri setinize erişemez ve tekrar erişim talep edemez.
• accepted: veri setinize erişimi olan kullanıcıların tam listesi. Onay modu manuel veya otomatik olsun, herhangi bir kullanıcı için istediğiniz zaman erişimi Reject edebilirsiniz. Ayrıca onayı Cancel edebilir ve bu, kullanıcının pending listesine taşınmasını sağlar.
• rejected: Manuel olarak reddettiğiniz kullanıcıların listesi. Bu kullanıcılar veri setlerinize erişemez. Veri seti deposuna giderlerse Your request to access this repo has been rejected by the repo’s authors mesajını görürler.

API üzerinden

Erişim isteklerinin onayını API'yi kullanarak otomatikleştirebilirsiniz. Kapalı depoya write erişimine sahip bir token iletmeniz gerekir. Bir token oluşturmak için kullanıcı ayarlarınıza gidin.

Yukarıdaki HTTP uç noktaları için temel URL https://huggingface.co'dur.

Bir isteği reset olarak ayarlamak, önceki kararı iptal eder ve kullanıcıya baştan başlamasını ister: kullanıcı veri setine erişimini kaybeder, isteğinin sıfırlandığına dair (isteğe bağlı resetReason dahil) bir e-posta alır ve bir sonraki veri seti sayfasını ziyaret ettiğinde kapalı erişim koşullarını kabul etmesi ve yeni bir istek göndermesi istenir. Bu, mevcut isteği olduğu gibi koruyup yalnızca inceleme kuyruğuna geri koyan pending durumundan ve kullanıcının tekrar erişim isteğinde bulunmasını engelleyen rejected durumundan farklıdır.

YENİ! Bu uç noktalar artık Python istemcimiz huggingface_hub içinde resmi olarak destekleniyor. Veri setinize yapılan erişim isteklerini list_pending_access_requests, list_accepted_access_requests ve list_rejected_access_requests ile listeleyebilirsiniz. Ayrıca accept_access_request, cancel_access_request ve reject_access_request ile erişim isteklerini kabul edebilir, iptal edebilir ve reddedebilirsiniz. Son olarak, grant_access ile bir kullanıcıya erişim izni verebilirsiniz.

Erişim raporunu indir

Gated bir veri setine yönelik tüm erişim isteklerinin raporunu kullanıcı erişim raporu indir düğmesiyle indirebilirsiniz. Kullanıcı listesini içeren bir json dosyasını indirmek için düğmeye tıklayın. Her kayıt için şunlara sahipsiniz:

• requestId: isteğin kimliği.
• user: kullanıcı kimliği. Örnek: julien-c.
• fullname: Hub'daki kullanıcının adı. Örnek: Julien Chaumond.
• status: isteğin durumu. "pending", "accepted", "rejected" veya "reset" olabilir.
• email: kullanıcının e-posta adresi.
• time: kullanıcının isteği ilk olarak yaptığı zaman.
• reviewedAt: isteğin kabul edildiği veya reddedildiği tarih ve saat. Bekleyen istekler için ayarlanmaz.

user, fullname ve email alanları, istek yapıldığında bunları toplamayı seçtiyseniz mevcuttur. İstekler her zaman requestId ile tanımlanabilir.

Hugging Face'in sizinle paylaştığı profil verilerini seçin

Varsayılan olarak Hugging Face, istekçinin kullanıcı adını ve birincil e-posta adresini sizinle paylaşır. Kişisel tanımlayıcı bilgilerin (PII) işlenmesinden ve bunları nasıl işlediğinizi ilgili yasalara uygun olarak açıklamaktan (örneğin kendi Gizlilik Politikasına bir bağlantı ekleyerek) siz sorumlusunuz. Bunu veri seti ayarları sayfasındaki erişim kısıtlama seçeneklerinde değiştirebilirsiniz:

• Kullanıcı adını topla: işaret kaldırıldığında, isteği yapan kişinin Hugging Face kullanıcı adı, tam adı ve avatarı size iletilmez. İstekler, bir istek kimliğiyle listelenir ve diğer herhangi bir istek gibi kabul edilebilir veya reddedilebilir.
• E-posta topla: istek sahibinin Hugging Face profil e-postasını toplar. Kullanıcı adı topla gerektirir.

Özel form alanlarınızın yanıtlarını hâlâ alırsınız, bu nedenle orada ihtiyacınız olan tüm iletişim bilgilerini isteyebilirsiniz. Bu ayarlar yalnızca yeni isteklere uygulanır: mevcut istekler, oluşturulduklarında geçerli olan ayarları korur.

Gating Group Collection içindeki veri setleri için bu seçenekler, koleksiyon üzerinde yapılandırılır.

İstenen bilgileri özelleştirin

Varsayılan olarak, kapalı bir veri setinize gelen kullanıcılar, Agree and send request to access repo düğmesine tıklayarak Hugging Face bilgilerini (e-posta ve kullanıcı adı, toplanmalarını devre dışı bırakmadıysanız) paylaşmaları istenir.

Daha fazla kullanıcı bilgisi talep ederek erişim sağlamak istiyorsanız, ek alanları yapılandırabilirsiniz. Bu bilgi Ayarlar sekmesinden erişilebilir olacaktır. Bunu yapmak için, anahtar/değer çiftlerinden oluşan bir liste içeren extra_gated_fields özelliğini veri seti kartı meta verilerinize ekleyin. key alanın adıdır, value ise türüdür veya type alanına sahip bir nesnedir. Alan türlerinin listesi şudur:

• text: tek satırlık bir metin alanı.
• checkbox: bir onay kutusu alanı.
• date_picker: bir tarih seçici alanı.
• country: ülke açılır listesi. Ülke listesi ISO 3166-1 alpha-2 standardına dayanmaktadır.
• select: seçenek listesi içeren bir açılır menü. Seçenek listesi options alanında tanımlanır. Örnek: options: ["option 1", "option 2", {label: "option3", value: "opt3"}].

Son olarak, kullanıcıya gösterilen mesajı extra_gated_prompt ek alanıyla da kişiselleştirebilirsiniz.

Kullanıcının şirket adını ve ülkesini belirtmesi ile veri setinin yalnızca ticari olmayan kullanım için olduğu konusunda onay vermesi istenen, özelleştirilmiş bir istek formunun örneği aşağıda verilmiştir.

---
extra_gated_prompt: "You agree to not use the dataset to conduct experiments that cause harm to human subjects."
extra_gated_fields:
  Company: text
  Country: country
  Specific date: date_picker
  I want to use this dataset for:
    type: select
    options: 
      - Research
      - Education
      - label: Other
        value: other
  I agree to use this dataset for non-commercial use ONLY: checkbox
---

Bazı durumlarda, kapı başlığı, açıklaması ve düğmesindeki varsayılan metni de değiştirmek isteyebilirsiniz. Bu kullanım senaryoları için extra_gated_heading, extra_gated_description ve extra_gated_button_content değerlerini şu şekilde değiştirebilirsiniz:

---
extra_gated_heading: "Acknowledge license to accept the repository"
extra_gated_description: "Our team may take 2-3 days to process your request"
extra_gated_button_content: "Acknowledge license"
---

Organizasyon üyeleri için geçiş erişimi

Bir kuruluş altında barındırılan kapılı veri kümeleri için, kuruluşun kendi üyelerinin de erişim isteği göndermesini zorunlu kılabilirsiniz. Veri kümesi ayarları sayfasında, kapı seçeneklerinin altında {org} üyeleri için de erişimi kapalı tut seçeneğini etkinleştirin.

Bu seçenek etkinleştirildiğinde, organizasyon üyeleri diğer tüm kullanıcılar gibi veri setine erişim için talep oluşturmalıdır. Aşağıdaki roller talebi atlayarak doğrudan erişimlerini korur:

• Organizasyon yöneticileri
• Depoyu oluşturan kullanıcı
• Resource Group admins, when the dataset belongs to a Resource Group

Diğer tüm üyeler, erişim isteği akışından geçmelidir. Bu, okuma, katkıda bulunan veya yazma kuruluş rolüne sahip üyeleri ve yönetici rolü olmayan Kaynak Grubu üyelerini içerir.

Bir organizasyon olarak (Team & Enterprise) kapalı veri setlerini yönetin

Team & Enterprise aboneleri, bir koleksiyondaki tüm modellere ve veri setlerine erişimi tek seferde tanımlamak (veya reddetmek) için Gating Group Collection oluşturabilir.

Gating Group Collections hakkında daha fazla bilgi, özel belgemizde bulunabilir.

Kullanıcı olarak gated veri setlerine erişim

Bir kullanıcı olarak, kapalı bir veri setini kullanmak istiyorsanız, bu veri setine erişim talep etmeniz gerekir. Bu, bir Hugging Face kullanıcı hesabına giriş yapmış olmanız gerektiği anlamına gelir.

Erişim talebi yalnızca tarayıcınızdan yapılabilir. Hub'daki veri setine gidin ve bilgilerinizi paylaşmanız istenecektir:

Kabul Et düğmesine tıklayarak, istek formunda girdiğiniz bilgileri (uygulanabilirse) veri seti yazarlarıyla paylaşmayı, ayrıca yazarların bunları toplamayı tercih etmesi durumunda Hugging Face kullanıcı adınızı ve e-posta adresinizi paylaşmayı kabul etmiş olursunuz. Veri seti yazarlarının size erişim izni verip vermeyeceğine karar vermesine yardımcı olmak için, form alanlarını mümkün olduğunca eksiksiz doldurmaya çalışın.

Erişim isteği gönderildikten sonra iki olasılık vardır. Onay mekanizması otomatikse, veri seti dosyalarına anında erişim sağlarsınız. Aksi takdirde, isteklerin yazarlar tarafından manuel olarak onaylanması gerekir ve bu daha fazla zaman alabilir.

Veri seti yazarları, veri setine erişim üzerinde tam kontrole sahiptir. Özellikle, onay mekanizmasından bağımsız olarak ve talebiniz zaten onaylanmış olsa bile, veri setine erişiminizi önceden haber vermeden herhangi bir zamanda engelleyebilirler.

Dosyaları indir

Korumalı bir veri setinden dosya indirmek için kimlik doğrulamanız gerekir. Tarayıcıda, hesabınızla oturum açtığınız sürece bu işlem otomatik olarak yapılır. Bir betik kullanıyorsanız, bir kullanıcı belirteci (user token) sağlamalısınız. Hugging Face Python ekosisteminde (transformers, diffusers, datasets vb.) huggingface_hub kütüphanesini kullanarak makinenize giriş yapabilir ve terminalinizde şunu çalıştırabilirsiniz:

hf auth login

Alternatif olarak, bir defterde veya betikte login() kullanarak programatik olarak oturum açabilirsiniz:

>>> from huggingface_hub import login
>>> login()

Kütüphanelerdeki (from_pretrained, hf_hub_download, load_dataset vb.) çoğu yükleme yöntemine, betiklerinizden doğrudan token parametresini de sağlayabilirsiniz.

Giriş yapma konusunda daha fazla ayrıntı için giriş kılavuzuna göz atın.

AB Kullanıcıları İçin Erişimi Kısıtlama

Kapılı veri kümeleri için, özellikle Avrupa Birliği ülkelerindeki kullanıcıları kısıtlamak amacıyla ek bir erişim kontrol katmanı ekleyebilirsiniz. Veri kümenizin lisansı veya kullanım koşulları AB'de dağıtımını yasaklıyorsa bu işe yarar.

Bunu etkinleştirmek için veri seti kartınızın meta verilerine extra_gated_eu_disallowed: true özelliğini ekleyin.

Önemli: Bu özellik yalnızca veri setiniz zaten kapılıysa etkinleşir. gated: false ise veya özellik tanımlanmamışsa bu kısıtlama uygulanmaz.

---
license: mit
gated: true
extra_gated_eu_disallowed: true
---

Sistem, bir kullanıcının konumunu IP adresine dayanarak belirler.