Projeler, müşterilere çalışmalarını düzenleme olanağı sağlamayı amaçlar. Kuruluşlar erişimi ve limitleri yönetebilir, hizmet hesapları sağlayabilir (UI üzerinden) ve bir proje içinde kısıtlı bir kapsamda kullanımı izleyebilir (örn. modeller, yetenekler, iş parçacıkları, yardımcılar, ince ayar, depolama vb.). Kullanım etkinliği projeye göre ayrıştırılabilir; kullanıcılar faturalandırmayı görüntüleyebilir ve proje başına bütçe ayarlayabilir.
Kuruluş sahipleri, tüm Aktif ve Arşivlenmiş projelerini Projeler sayfasında görüntüleyebilir. API Platformundaki kullanıcı rolleri ve izinler hakkında daha fazla bilgi edinin.
Kim proje oluşturabilir?
Yalnızca kuruluş sahipleri proje oluşturabilir. Daha fazla bilgi için lütfen roller ve izinler bölümüne bakın.
Kuruluşlar arasında geçiş yapmak için sayfanın sol üstündeki kuruluş adınızın üzerine gelin ve listeden kuruluşu seçin:
Birleştirilmiş faturalandırma planında olan kuruluşlar için alt kuruluşlar ayrı olarak tanımlanır. Alt kuruluşlar içinde proje oluşturulamaz.
Projeler nasıl çalışır?
Her kuruluşta silinemeyen bir “Varsayılan proje” bulunur. Hız limitlerini, sanal model izinlerini ve harcama bütçelerini yapılandırabilirsiniz (Kasım 2024 itibarıyla). Kuruluşun tam yapılandırmasını devraldığı için buna doğrudan üye veya hizmet hesabı ekleyemezsiniz.
Nasıl proje oluştururum?
Önce sayfanın sol köşesindeki proje adının üzerine gelin ve Create project seçeneğini seçin.
Projeniz için bir ad, açıklama ve web sitesi girin, ardından Create seçeneğini seçin.
Bir projeye kullanıcıları nasıl eklerim?
Yeni eklenen kuruluş üyeleri “Varsayılan proje”ye otomatik olarak eklenmez. Yeni üyeler, kuruluşa davet edildiklerinde ("Varsayılan projeye davet et" onay kutusu etkinleştirilerek) veya üye kuruluş davetini kabul ettikten sonra projeye davet edilebilir.
Admin API üzerinden davet edilen kullanıcılar /organization/invites uç noktası tarafından belirtilen kurallara uyar.
UI veya Admin API aracılığıyla kullanıcıları bir projeye davet ederken bir hatayla karşılaşırsanız, daveti yeniden göndermeden önce hedef projenin mevcut olduğunu ve arşivlenmediğini doğrulayın.
Kuruluş sahipleri, bir kuruluş içinde oluşturulan yeni projelere otomatik olarak sahip olarak eklenir.
Kuruluşlar ve projeler içindeki farklı kullanıcı rolleri nelerdir ve hangi izinleri içerir?
Kuruluşlarda ‘sahip’ ve ‘okuyucu’ rolleri varken, projelerde ‘sahip’ ve ‘üye’ rolleri vardır. Proje üyeleri, kuruluş okuyucularına benzer. Her kullanıcı rolüne eşlik eden izinlerin daha ayrıntılı açıklaması için lütfen aşağıdaki tabloya bakın.
| Rol | Kapsam | Açıklama |
|---|---|---|
| Sahip | Kuruluş | Tüm projeleri, tüm kullanıcıları ve tüm API anahtarlarını oluşturabilir/görüntüleyebilir. Kuruluş içindeki tüm projeleri Projeler sayfası ile izleme olanağına sahiptir. Kuruluş bütçelerini ve proje bütçelerini ayarlayabilir. Kuruluştaki başkaları için kullanım bilgilerini görüntüleme izinleri verebilir. Projeleri arşivleyebilir. |
| Okuyucu | Kuruluş | Kendi projelerinde çıkarım yapabilir, kaynakları kullanabilir ve anahtar oluşturabilir. Projelere eklenebilir. Proje oluşturamaz ve kullanıcıları yönetemez. |
| Sahip | Proje | Bir Üyenin tüm yetkilerine ek olarak projeye başka kullanıcılar ekleyebilir ve projenin adını değiştirebilir. Proje bütçelerini ayarlayabilir. Projeyi arşivleyebilir. |
| Üye | Proje | Proje düzeyinde çıkarım yapabilir, kaynakları kullanabilir ve anahtar oluşturabilir. |
Kuruluşta Sahip değilsem nelere erişimim olur?
Kuruluşta Sahip olmayan kullanıcılar yalnızca üyesi oldukları projeleri görebilir. Yalnızca kuruluş sahibi proje düzeyindeki tüm projeleri, üyeleri ve API anahtarlarını görebilir ve Projeler sayfasına erişebilir.
Yalnızca bir projenin üyeleri (ve kuruluş sahipleri), o proje içinde oluşturulmuş ince ayarlı modelleri, oluşturulan herhangi bir Assistants'tan gelen iş parçacıklarını veya eklenen dosyaları görebilir.
Bir projenin üyeleri, o projenin diğer tüm üyelerinin kim olduğunu ve rollerini (yani Sahip veya Üye) görebilir.
Bir kullanıcının proje rolünü nasıl günceller veya bir kullanıcıyı projeden nasıl kaldırırım?
Yalnızca bir projenin Sahibi, bir kullanıcının proje rolünü güncelleyebilir veya kullanıcıyı projeden kaldırabilir. Daha fazla bilgi için lütfen roller ve izinler bölümüne bakın.
Bir projedeki kullanıcıyı güncellemek için kuruluş ayarlarınıza gidin, projeyi seçin ve Üyeler öğesine tıklayın. Her üyenin rolünü Üye veya Sahip olarak ayarlama seçeneğiniz vardır. Kullanıcıyı projeden kaldırmak için Kaldır öğesini de seçebilirsiniz.
Hizmet hesabı nedir ve normal bir kullanıcı hesabından farkı nedir?
Hizmet hesabı, bireysel kullanıcı hesaplarından farklı olarak sistem erişimi için tasarlanmış bir sözde kullanıcı görevi görür. Hizmet hesaplarını yalnızca kuruluş ve proje sahipleri oluşturabilir.
Hizmet hesapları yalnızca projelerle sınırlıdır.
Bir projeye üye ekleme
+ Add member düğmesine tıklarsanız, kuruluşunuzda Reader rolüne sahip kullanıcıların listesini görürsünüz. Şu anda kuruluşunuzda olmayan bir kullanıcıyı eklemek istiyorsanız, önce onu kuruluşa eklemeniz gerekir (bu kullanıcılara daha geniş erişim vermek istemiyorsanız “Varsayılan Projeye Ekle” onay kutusunu işaretlemeden bırakabilirsiniz). Bu liste hizmet hesaplarını içermez. Bu adımda rollerinin Owner veya Member olmasını seçebilirsiniz:
Bir ekip üyesi eklediğinizde ona Üye veya Sahip rolünü atamanız gerekir. Proje üyeleri verileri okuyan veya değiştiren API istekleri yapabilir; proje sahipleri ise ayrıca proje ayarlarını ve proje bütçelerini değiştirebilir ve proje üyelerini yönetebilir. Daha fazla bilgi için lütfen roller ve izinler bölümüne bakın.
Bir proje için hizmet hesabı nasıl oluşturulur?
Önce gezinme çubuğunda bulunan açılır menüden seçim yaparak hizmet hesabı oluşturmak istediğiniz projeye gidin:
Ardından kuruluş ayarlarınıza gidin -> Proje -> Üyeler -> + Service account öğesine tıklayın:
Proje düzeyinde oluşturulan hizmet hesapları projeye özeldir ve oluşturuldukları projenin dışında kullanılamaz.
Hizmet hesabını adlandırma
Hizmet hesabını kuruluş düzeyinde oluşturmanız veya projeye özgü bir hesap oluşturmanız fark etmeksizin, hizmet hesabını kolayca tanımlamak için harfler, sayılar ve tirelerden oluşan benzersiz bir hizmet hesabı kimliği oluşturabilirsiniz.
Hizmet hesabı API anahtarını kaydedin
Oluştur düğmesini seçtikten sonra, hizmet hesabı için hemen bir API anahtarı oluşturulur ve gizli anahtar görüntülenir. Bu gizli anahtarı güvenli ve emniyetli bir yere kaydedin. Güvenlik nedeniyle, OpenAI hesabınız üzerinden bunu tekrar görüntüleyemezsiniz. Bu gizli anahtarı kaybederseniz yeni bir tane oluşturmanız gerekir.
Hizmet hesabı API anahtarı izinleri, varsayılan olarak projenin tüm API kaynaklarını okuma ve yazma şeklinde ayarlanır. Bu izinler projenizin API Anahtarları ayarlarında güncellenebilir.
Hizmet hesapları, projenizin üye ayarları sayfasında proje üyeleriyle birlikte listelenir. Projenizin üye ayarları sayfasında bir hizmet hesabının erişimini güncelleme veya kaldırma hakkında daha fazla bilgi edinmek için lütfen buraya bakın.
Hem projeler hem de kuruluşlar genelindeki tüm hizmet hesapları, kuruluş düzeyi üyeler sayfasında insan kullanıcılarınızla birlikte görüntülenir.
Hizmet hesapları normal hesaplar gibi yönetilir. Kuruluş -> Üyeler menüsü üzerinden bir hizmet hesabını Kaldırabilir veya rolünü güncelleyebilirsiniz:
Kuruluşumun projeleri içindeki API anahtarlarını nasıl yönetirim?
Her proje için API anahtarlarını o projenin ayarlar sayfasında oluşturabilir ve yönetebilirsiniz. Kuruluş ayarlarınızda projeyi seçin ve API Anahtarları öğesine tıklayın.
Yeni bir gizli anahtar oluşturmak için + Create new secret key öğesini seçin. Bir gizli anahtarın izinlerini düzenlemek için yanındaki Düzenle simgesini de seçebilirsiniz.
Yeni bir gizli anahtar oluştururken veya mevcut bir anahtarı düzenlerken API anahtarlarınızın her biri için izinler ayarlayabilirsiniz.
Üç izin düzeyi mevcuttur: Tümü, Kısıtlı ve Salt Okunur.
Tümü — Gizli anahtar için tam izinler ayarlanır. Bu varsayılan ayardır.
Kısıtlı — Kullanıcının her uç nokta için Yok, Okuma ve Yazma izinlerini ayarlamasını sağlar.
Örneğin, özellikle /v1/assistants uç noktasına Okuma veya Yazma izni olmayan bir API anahtarı oluşturursunuz:
Salt Okunur — Tüm uç noktalar için okuma izinleri ayarlanır.
Birden fazla proje veya kuruluşa ait kullanıcılar için erişim nasıl yönetilir?
Kullanıcılar gerektiği kadar çok projeye üye olabilir. Bir proje içinde kullanıcılar, o projeye ve kaynaklarına erişimle sınırlı ve kapsamı belirlenmiş kişisel bir API anahtarı oluşturabilir.
Kuruluşumun projeleri için kullanım limitlerini nasıl ayarlar ve yönetirim?
Yalnızca bir kuruluşun Sahibi proje düzeyi kullanım limitlerini ayarlayabilir ve yönetebilir. Daha fazla bilgi için lütfen roller ve izinler bölümüne bakın.
Kuruluş ayarlarınızda güncellemek istediğiniz projeye tıklayın ve gezinme listesinin Proje bölümünde Limitler öğesini seçin. Bu sayfada Model Kullanımı ayarınızı güncelleyebilirsiniz.
Model kullanımı proje tarafından hangi modellerin kullanılabileceğini yapılandırmanıza olanak tanır ve kullanım limitleri gerektiğinde her model için ayarlanabilir.
Kuruluşumun projeleri için bütçeleri nasıl ayarlar ve yönetirim?
Yalnızca bir kuruluşun Sahipleri ve bir projenin Sahipleri proje bütçelerini ayarlayabilir ve yönetebilir. Daha fazla bilgi için lütfen roller ve izinler bölümüne bakın. Kuruluş düzeyindeki limitleri değiştirmek için kuruluş ayarlarınızda Limitler, öğesine tıklayın ve Kullanım limitleri bölümüne kaydırın.
Proje limitlerinizi ayarlamak için kuruluş ayarlarınızda güncellemek istediğiniz projeye tıklayın ve Limitler öğesini seçin. Aylık bütçe, Bildirim eşiği ve Model Kullanımı değerlerinizi güncelleyebilirsiniz.
Aylık bütçe ayarlamak, projeniz için esnek harcama eşikleri belirlemenizi sağlar. Kullanım, belirli bir takvim ayı (UTC) içinde bu limiti aştığında API istekleri kesintisiz olarak işlenmeye devam eder. Bu özellik, bütçe uyarıları aracılığıyla kullanımı izlemenize yardımcı olmak için tasarlanmıştır; ancak harcamaya kesin bir üst sınır uygulamaz. Bir proje bütçesi oluşturulduğunda, varsayılan olarak %100 eşiğinde bir uyarı oluşturulur. Farklı eşiklerde ek bütçeler Uyarı Ekle seçeneğine tıklanarak ayarlanabilir.
Lütfen kuruluş sahiplerinin ve proje sahiplerinin bu mesajları her zaman alacağını ve bunun özelleştirilemeyeceğini unutmayın.
Bir projeyi nasıl siler veya arşivlerim?
Projeler, yeni proje listesi sayfası üzerinden veya tek bir projenin ayarlarından arşivlenebilir. Bir proje arşivlendikten sonra geri yüklenemez. Arşivleme işlemine devam ederken ilerlemek için proje adını girmeniz istenir.
Arşivlenmiş tüm projelerin listesini aynı proje listesi sayfasındaki “Arşivlenmiş” sekmesinden görüntüleyebilirsiniz.
Projeleri silmek mümkün değildir; kullanım ve faturalandırma takibinde sürekliliği sağlamak için tüm projelerin geçmişini tutarız.
Kuruluşumda sahip olabileceğim proje sayısında bir sınır var mı?
Kuruluşlar varsayılan olarak en fazla 2.000 proje oluşturabilir.
Kaynaklar projeler arasında paylaşılabilir mi?
Proje kaynakları (dosyalar, assistant'lar, depolama veya thread'ler gibi) projeyle sınırlıdır ve proje dışındaki yönetici olmayan üyeler tarafından erişilemez. Ayrıca kaynaklar projeler arasında taşınamaz.
Tek istisna, “Varsayılan proje” içindeki fine-tune'lara diğer projelerden erişilebilmesidir.
Proje başına dosya depolama kotası nedir?
OpenAI şu anda proje başına 100 GB dosya depolama kotasını desteklemektedir.
Bu kota aşılırsa aşağıdaki hatayı görürsünüz:
Dosya depolama kotanızı aştınız. Kuruluşlar 100 GB dosya ile sınırlıdır. Lütfen dosya boyutunu azaltın veya destek ekibiyle iletişime geçin.Hesabınızda depolanan kullanılmayan dosyaları silmenizi öneririz. Referans olarak, API ile dosyaları görüntüleyebilir ve listeleyebilirsiniz.
Bir proje sahibiyim; projemin Kullanım Panosunu neden göremiyorum?
Bir projenin Kullanım Panosunun görünürlüğü, kullanıcının proje içindeki rolüyle ilgili değildir. Bunun yerine, kuruluş içindeki rolünüz ve https://platform.openai.com/settings/organization/data-controls/visibility adresindeki ayarlar tarafından belirlenir.
Bir Kullanım Panosunu göremiyorsanız, bu ayar muhtemelen "Kuruluş sahiplerine görünür" olarak ayarlanmıştır.