Projeler, müşterilere çalışmalarını düzenleme olanağı sunmayı amaçlar. Kuruluşlar erişimi ve limitleri yönetebilir, hizmet hesapları sağlayabilir (UI üzerinden) ve proje içinde sınırlı bir kapsamda kullanımı takip edebilir (örn. modeller, yetenekler, thread'ler, assistant'lar, fine-tuning, depolama vb.). Kullanım etkinliği projeye göre ayrıştırılabilir ve kullanıcılar faturalamayı görüntüleyip proje başına bütçe belirleyebilir.
Kuruluş sahipleri, tüm Etkin ve Arşivlenmiş projelerini Projects sayfasında görüntüleyebilir. API Platformundaki kullanıcı rolleri ve izinleri 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 kısmındaki kuruluş adınızın üzerine gelin ve listeden kuruluşu seçin:
Konsolide faturalama planında olan kuruluşlarda 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?
Kuruluşa yeni eklenen üyeler otomatik olarak “Varsayılan proje”ye eklenmez. Yeni üyeler, kuruluşa davet edilirken (“Invite to default project” 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ında belirtilen kuralları izler.
UI veya Admin API üzerinden bir projeye kullanıcı davet ederken hata alı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 bunlar hangi izinleri içerir?
Kuruluşlarda ‘owner’ ve ‘reader’ rolleri varken, projelerde ‘owner’ ve ‘member’ rolleri vardır. Proje üyeleri, kuruluş reader'larına benzer. Her kullanıcı rolüne hangi izinlerin eşlik ettiğine dair daha ayrıntılı açıklama için lütfen aşağıdaki tabloya bakın.
| Rol | Kapsam | Açıklama |
|---|---|---|
| Owner | Kuruluş | Tüm projeleri, tüm kullanıcıları, tüm API anahtarlarını oluşturabilir/görüntüleyebilir. Kuruluş içindeki tüm projeleri Projects sayfası ile izleme yeteneğine sahiptir. Kuruluş bütçelerini ve proje bütçelerini ayarlayabilir. Kuruluştaki diğer kişilere kullanım bilgilerini görüntüleme izni verebilir. Projeleri arşivleyebilir. |
| Reader | Kuruluş | Projelerinde çıkarım yapabilir, kaynakları kullanabilir ve anahtar oluşturabilir. Projelere eklenebilir. Kullanıcıları yönetemez ve proje oluşturamaz. |
| Owner | Proje | Diğer kullanıcıları projeye ekleyebilir ve projeyi yeniden adlandırabilir; ayrıca bir Member'ın tüm yeteneklerine de sahiptir. Proje bütçelerini ayarlayabilir. Projeyi arşivleyebilir. |
| Member | Proje | Proje düzeyinde çıkarım yapabilir, kaynakları kullanabilir ve anahtar oluşturabilir. |
Kuruluşta Owner değilsem nelere erişebilirim?
Kuruluşta Owner 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 Projects sayfasına erişebilir.
Yalnızca bir projenin üyeleri (ve kuruluş sahipleri), o proje içinde oluşturulmuş fine-tune edilmiş modelleri, oluşturulan Assistants'lardaki thread'leri veya eklenen dosyaları görebilir.
Bir projenin üyeleri, o projenin diğer tüm üyelerinin kim olduğunu ve rollerini (yani Owner veya Member) görebilir.
Bir kullanıcının proje rolünü nasıl güncellerim veya bir kullanıcıyı projeden nasıl kaldırırım?
Yalnızca bir projenin Owner'ı, bir kullanıcının proje rolünü güncelleyebilir veya bir 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 Members seçeneğine tıklayın. Her üyenin rolünü Member veya Owner olarak ayarlama seçeneğiniz vardır. Kullanıcıyı projeden kaldırmak için Remove seçeneğini 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şunuzdaki Reader rolüne sahip kullanıcıların bir listesini görürsünüz. Şu anda kuruluşunuzda olmayan kullanıcıyı eklemek istiyorsanız, önce onu kuruluşa eklemeniz gerekir (bu kullanıcılara daha geniş erişim vermek istemiyorsanız 'Add to Default Project" onay kutusunu işaretlemeden bırakabilirsiniz). Bu liste hizmet hesaplarını içermez. Bu adım sırasında rollerinin Owner veya Member olmasını seçebilirsiniz:
Bir ekip üyesi eklediğinizde ona Member veya Owner rolünü atamanız gerekir. Proje üyeleri verileri okuyan veya değiştiren API istekleri yapabilirken, proje sahipleri 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ğundaki açılır menüden seçerek hizmet hesabı oluşturmak istediğiniz projeye gidin:
Ardından kuruluş ayarlarınıza gidin -> Project -> Members -> + Service account seçeneğine 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
Create 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 bir yerde saklayın. Güvenlik nedenleriyle buna OpenAI hesabınız üzerinden tekrar görüntüleyemezsiniz. Bu gizli anahtarı kaybederseniz yenisini oluşturmanız gerekir.
Hizmet hesabı API anahtarı izinleri varsayılan olarak projenin tüm API kaynakları için okuma ve yazma olarak ayarlanır. Bu izinler projenizin API Keys 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 için lütfen buraya bakın.
Hem proje hem de kuruluş düzeyindeki tüm hizmet hesapları, kuruluş düzeyindeki üyeler sayfasında insan kullanıcılarınızla birlikte görüntülenir.
Hizmet hesapları normal hesaplar gibi yönetilir. Organization -> Members menüsünden bir hizmet hesabını Remove ile 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 Keys seçeneğine tıklayın.
Yeni bir gizli anahtar oluşturmak için + Create new secret key seçeneğini seçin. İzinlerini düzenlemek için gizli anahtarın yanındaki Düzenle simgesini de seçebilirsiniz.
Yeni bir gizli anahtar oluştururken veya mevcut bir anahtarı düzenleyerek API anahtarlarınızın her biri için izinler belirleyebilirsiniz.
Üç düzey izin vardır: All, Restricted ve Read Only.
All — Gizli anahtar için tam izinler ayarlanır. Bu varsayılan ayardır.
Restricted — Kullanıcının her uç nokta için None, Read ve Write izinlerini ayarlamasını sağlar.
Örneğin, özellikle /v1/assistants uç noktasına Read veya Write izni olmayan bir API anahtarı oluşturursunuz:
Read Only — Tüm uç noktalar için Read 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 hız limitlerini nasıl ayarlar ve yönetirim?
Yalnızca bir kuruluşun Owner'ı, proje düzeyindeki hız 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 Project bölümünde Limits seçeneğini seçin. Bu sayfada Model Usage ayarınızı güncelleyebilirsiniz.
Model Usage, proje tarafından hangi modellerin kullanılabileceğini yapılandırmanıza olanak tanır ve hız limitleri her model için gerektiği şekilde 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 Limits seçeneğine tıklayın ve Usage limits bölümüne kadar aşağı kaydırın.
Proje limitlerinizi ayarlamak için kuruluş ayarlarınızda güncellemek istediğiniz projeye tıklayın ve Limits seçeneğini seçin. Monthly budget, Notification threshold ve Model Usage ayarlarınızı güncelleyebilirsiniz.
Bir aylık bütçe belirlemek, projeniz için yumuşak harcama eşikleri oluşturmanıza olanak tanır. 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ı yoluyla kullanımı izlemenize yardımcı olmak için tasarlanmıştır, ancak harcamaya katı 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, Add Alert seçeneğine tıklanarak ayarlanabilir.
Lütfen kuruluş sahibi/sahipleri ile proje sahibi/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 “Archived” sekmesinden görüntüleyebilirsiniz.
Projeleri silmek mümkün değildir; kullanım ve faturalama 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 olması için API ile dosyaları görüntüleyebilir ve listeleyebilirsiniz.
Proje sahibiyim, neden projem için Usage Dashboard'u göremiyorum?
Bir projenin Usage Dashboard 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 Usage Dashboard göremiyorsanız, bu ayar büyük olasılıkla “Visible to organization owners” olarak ayarlanmıştır.