Projecten zijn bedoeld om klanten de mogelijkheid te bieden hun werk te organiseren. Organisaties kunnen toegang en limieten beheren, serviceaccounts inrichten (via de UI) en gebruik binnen een beperkte scope binnen een project bijhouden (bijv. modellen, mogelijkheden, threads, assistants, fine-tuning, opslag, enz.). Gebruiksactiviteit kan per project worden uitgesplitst, en gebruikers kunnen facturering bekijken en budgetten per project instellen.
Organisatie-eigenaren kunnen al hun actieve en gearchiveerde projecten bekijken op de Projectenpagina. Meer informatie over gebruikersrollen en machtigingen in het API-platform.
Wie kan een project maken?
Alleen organisatie-eigenaren kunnen een project maken. Raadpleeg rollen en machtigingen voor meer informatie.
Als je tussen organisaties wilt schakelen, beweeg je de muis over de naam van je organisatie linksboven op de pagina en selecteer je de organisatie uit de lijst:
Voor organisaties met een geconsolideerd factureringsplan worden suborganisaties afzonderlijk geïdentificeerd. Projecten kunnen niet binnen suborganisaties worden gemaakt.
Hoe werken projecten?
Elke organisatie bevat een ‘Standaardproject’ dat niet kan worden verwijderd. U kunt de rate limits, machtigingen voor virtuele modellen en bestedingsbudgetten configureren (vanaf november 2024). Het neemt de volledige configuratie van de organisatie over, dus u kunt er niet direct leden of serviceaccounts aan toevoegen.
Hoe maak ik een project?
Beweeg eerst over de projectnaam in de linkerhoek van de pagina en selecteer Create project.
Geef een naam, beschrijving en website op voor uw project en selecteer vervolgens Create.
Hoe voeg ik gebruikers toe aan een project?
Nieuw toegevoegde organisatieleden worden niet automatisch toegevoegd aan het “Standaardproject”. Nieuwe leden kunnen voor het project worden uitgenodigd wanneer ze voor de organisatie worden uitgenodigd (door het selectievakje "Uitnodigen voor standaardproject" in te schakelen) of nadat het lid de organisatie-uitnodiging heeft geaccepteerd.
Gebruikers die via de Admin API zijn uitgenodigd, volgen de regels die worden beschreven door de /organization/invites-endpoint.
Als je een fout tegenkomt wanneer je gebruikers via de UI of de Admin API voor een project uitnodigt, controleer dan eerst of het doelproject bestaat en niet is gearchiveerd voordat je de uitnodiging opnieuw verstuurt.
Organisatie-eigenaren worden automatisch als eigenaren toegevoegd aan nieuwe projecten die binnen een organisatie worden gemaakt.
Wat zijn de verschillende gebruikersrollen binnen organisaties en projecten, en welke machtigingen horen daarbij?
Terwijl organisaties de rollen ‘eigenaar’ en ‘lezer’ hebben, hebben projecten de rollen ‘eigenaar’ en ‘lid’. Projectleden zijn vergelijkbaar met organisatielezers. Raadpleeg de onderstaande tabel voor een gedetailleerdere beschrijving van de machtigingen die bij elke gebruikersrol horen.
| Rol | Bereik | Beschrijving |
|---|---|---|
| Eigenaar | Organisatie | Kan alle projecten, alle gebruikers en alle API-sleutels maken/bekijken. Heeft de mogelijkheid om alle projecten binnen de organisatie te monitoren met de Projectenpagina . Kan organisatiebudgetten en projectbudgetten instellen. Kan machtigingen verlenen om gebruiksinformatie van anderen in de organisatie te bekijken. Kan projecten archiveren. |
| Lezer | Organisatie | Kan inferentie uitvoeren, resources gebruiken en sleutels maken in hun projecten. Kan aan projecten worden toegevoegd. Kan geen projecten maken en gebruikers beheren. |
| Eigenaar | Project | Kan andere gebruikers aan het project toevoegen en het project hernoemen, evenals alle mogelijkheden van een lid gebruiken. Kan projectbudgetten instellen. Kan het project archiveren. |
| Lid | Project | Kan inferentie uitvoeren, resources gebruiken en sleutels maken op projectniveau. |
Als ik geen eigenaar in de organisatie ben, waartoe heb ik dan toegang?
Gebruikers die geen eigenaren in de organisatie zijn, kunnen alleen projecten zien waarvan ze lid zijn. Alleen de organisatie-eigenaar kan alle projecten, leden en API-sleutels op projectniveau zien en heeft toegang tot de Projectenpagina.
Alleen de leden van een project (en organisatie-eigenaren) kunnen de fine-tuned modellen zien die binnen dat project zijn gemaakt, de threads van gemaakte Assistants, of bestanden die zijn toegevoegd.
Leden van een project kunnen zien wie alle andere leden van dat project zijn en wat hun rollen zijn (d.w.z. Eigenaar of Lid).
Hoe werk ik de projectrol van een gebruiker bij of verwijder ik een gebruiker uit een project?
Alleen de eigenaar van een project kan de projectrol van een gebruiker bijwerken of een gebruiker uit een project verwijderen. Raadpleeg rollen en machtigingen voor meer informatie.
Als je een gebruiker in een project wilt bijwerken, ga je naar je organisatie-instellingen, selecteer je het project en klik je op Leden. Je hebt de optie om de rol van elk lid in te stellen als Lid of Eigenaar. Je kunt ook Verwijderen selecteren om de gebruiker uit het project te verwijderen.
Wat is een serviceaccount en hoe verschilt het van een gewone gebruikersaccount?
Een serviceaccount fungeert als een pseudo-gebruiker die is ontworpen voor systeemtoegang, en verschilt van individuele gebruikersaccounts. Alleen organisatie- en projecteigenaren kunnen serviceaccounts maken.
Serviceaccounts zijn alleen beperkt tot projecten.
Een lid toevoegen aan een project
Als je op de knop + Add member klikt, zie je een lijst met gebruikers in je organisatie met de rol Reader. Als je een gebruiker wilt toevoegen die momenteel niet in je organisatie zit, moet je die eerst aan de organisatie toevoegen (je kunt het selectievakje 'Toevoegen aan standaardproject' uitgeschakeld laten als je deze gebruikers geen bredere toegang wilt geven). Deze lijst bevat geen serviceaccounts. Tijdens deze stap kun je kiezen of hun rol Owner of Member is:
Wanneer je een teamlid toevoegt, moet je diegene de rol Lid of Eigenaar toewijzen. Projectleden kunnen API-verzoeken doen die gegevens lezen of wijzigen, terwijl projecteigenaren ook projectinstellingen en projectbudgetten kunnen wijzigen en projectleden kunnen beheren. Raadpleeg rollen en machtigingen voor meer informatie.
Een serviceaccount maken voor een project
Navigeer eerst naar het project waarvoor je een serviceaccount wilt maken door te kiezen uit de vervolgkeuzelijst in de navigatiebalk:
Ga vervolgens naar je organisatie-instellingen -> Project -> Leden -> klik op + Service account:
Serviceaccounts die op projectniveau worden gemaakt, zijn uniek voor het project en kunnen niet worden gebruikt buiten het project waarin ze zijn gemaakt.
Het serviceaccount een naam geven
Ongeacht of u het serviceaccount op organisatieniveau maakt of een account maakt dat uniek is voor een project, kunt u bij het maken van een serviceaccount een unieke serviceaccount-ID maken die bestaat uit letters, cijfers en koppeltekens om het serviceaccount eenvoudig te identificeren.
De API-sleutel van het serviceaccount opslaan
Nadat je de knop Maken hebt geselecteerd, wordt er onmiddellijk een API-sleutel voor het serviceaccount gemaakt en wordt de geheime sleutel weergegeven. Sla deze geheime sleutel op een veilige en beveiligde plaats op. Om veiligheidsredenen kun je deze niet opnieuw bekijken via je OpenAI-account. Als je deze geheime sleutel kwijtraakt, moet je een nieuwe genereren.
De machtigingen voor de API-sleutel van het serviceaccount staan standaard ingesteld op lezen en schrijven voor alle API-resources van het project. Deze machtigingen kunnen worden bijgewerkt in de API-sleutelinstellingen van je project.
Serviceaccounts worden samen met projectleden vermeld op de pagina met ledeninstellingen van je project. Raadpleeg hier voor meer informatie over het bijwerken of verwijderen van de toegang van een serviceaccount op de pagina met ledeninstellingen van je project.
Alle serviceaccounts voor zowel projecten als organisaties worden naast je menselijke gebruikers weergegeven op de ledenpagina op organisatieniveau.
Serviceaccounts worden beheerd als gewone accounts. Vanuit Organisatie -> Ledenmenu kun je een serviceaccount Verwijderen of de rol bijwerken:
Hoe beheer ik API-sleutels binnen de projecten van mijn organisatie?
Je kunt API-sleutels voor elk project maken en beheren op de instellingenpagina van dat project. Selecteer in je organisatie-instellingen het project en klik op API-sleutels.
Als je een nieuwe geheime sleutel wilt maken, selecteer je + Create new secret key. Je kunt ook het pictogram Bewerken naast een geheime sleutel selecteren om de machtigingen ervan te bewerken.
Je kunt machtigingen voor elk van je API-sleutels instellen wanneer je een nieuwe geheime sleutel maakt of door een bestaande sleutel te bewerken.
Er zijn drie machtigingsniveaus beschikbaar: Alles, Beperkt en Alleen-lezen.
Alles — Volledige machtigingen worden ingesteld voor de geheime sleutel. Dit is de standaardinstelling.
Beperkt — Hiermee kan de gebruiker voor elke endpoint de machtigingen Geen, Lezen en Schrijven instellen.
Je maakt bijvoorbeeld een API-sleutel die specifiek geen toestemming heeft om te lezen of te schrijven naar de endpoint /v1/assistants:
Alleen-lezen — Leesmachtigingen worden ingesteld voor alle endpoints.
Hoe wordt toegang beheerd voor gebruikers die tot meerdere projecten of organisaties behoren?
Gebruikers kunnen lid zijn van zoveel projecten als nodig is. Binnen een project kunnen gebruikers een persoonlijke API-sleutel genereren die is afgebakend en beperkt tot toegang tot dat project en de bijbehorende resources.
Hoe stel ik volumelimieten in en beheer ik ze voor de projecten van mijn organisatie?
Alleen de eigenaar van een organisatie kan volumelimieten op projectniveau instellen en beheren. Raadpleeg rollen en machtigingen voor meer informatie.
Klik in je organisatie-instellingen op het project dat je wilt bijwerken en selecteer Limieten in de sectie Project van de navigatielijst. Je kunt je Modelgebruik op deze pagina bijwerken.
Met modelgebruik kun je configureren welke modellen door het project kunnen worden gebruikt, en volumelimieten kunnen indien nodig per model worden ingesteld.
Hoe stel ik budgetten in en beheer ik ze voor de projecten van mijn organisatie?
Alleen de eigenaren van een organisatie en eigenaren van een project kunnen projectbudgetten instellen en beheren. Raadpleeg rollen en machtigingen voor meer informatie. Als je de limieten op organisatieniveau wilt wijzigen, klik je in je organisatie-instellingen op Limieten, en scrol je omlaag naar Gebruikslimieten.
Als je projectlimieten wilt instellen, klik je in je organisatie-instellingen op het project dat je wilt bijwerken en selecteer je Limieten. Je kunt je Maandbudget, Meldingsdrempel en Modelgebruik bijwerken.
Door een maandbudget in te stellen, kun je zachte uitgavedrempels voor je project vastleggen. Wanneer het gebruik deze limiet binnen een bepaalde kalendermaand (UTC) overschrijdt, blijven API-verzoeken zonder onderbreking verwerkt worden. Deze functie is bedoeld om je te helpen het gebruik te monitoren via budgetwaarschuwingen, maar dwingt geen harde limiet op uitgaven af. Wanneer een projectbudget wordt gemaakt, wordt standaard een waarschuwing aangemaakt op de drempel van 100%. Aanvullende budgetten met verschillende drempels kunnen worden ingesteld door op Waarschuwing toevoegen te klikken.
Houd er rekening mee dat de organisatie-eigenaar(s) en projecteigenaar(s) deze berichten altijd ontvangen en dat dit niet kan worden aangepast.
Hoe verwijder of archiveer ik een project?
Projecten kunnen worden gearchiveerd via de nieuwe pagina met projectoverzicht of via de instellingen van een afzonderlijk project. Zodra een project is gearchiveerd, kan het niet worden hersteld. Wanneer je doorgaat met archiveren, wordt je gevraagd de naam van het project in te voeren om verder te gaan.
Je kunt een lijst met alle gearchiveerde projecten bekijken via het tabblad “Gearchiveerd” op dezelfde pagina met projectoverzicht.
Projecten verwijderen is niet mogelijk; we bewaren een geschiedenis van alle projecten om continuïteit in gebruiks- en factureringstracking te waarborgen.
Is er een limiet aan het aantal projecten dat ik in mijn organisatie kan hebben?
Organisaties kunnen standaard maximaal 2.000 projecten maken.
Kunnen resources tussen projecten worden gedeeld?
Projectresources (zoals bestanden, assistants, opslag of threads) zijn beperkt tot het project en zijn niet toegankelijk voor niet-adminleden buiten het project. Bovendien kunnen resources niet tussen projecten worden verplaatst.
De enige uitzondering is dat fine-tunes in het ‘Standaardproject’ vanuit andere projecten toegankelijk zijn.
Wat is het quota voor bestandsopslag per project?
OpenAI ondersteunt momenteel een quota voor bestandsopslag van 100 GB aan bestanden per project.
Als deze quota wordt overschreden, ziet u de volgende foutmelding:
U hebt uw quota voor bestandsopslag overschreden. Organisaties zijn beperkt tot 100 GB aan bestanden. Verklein het bestand of neem contact op met support.We raden je aan ongebruikte bestanden die in je account zijn opgeslagen te verwijderen. Ter referentie: je kunt bestanden bekijken en weergeven met de API.
Ik ben projecteigenaar. Waarom kan ik het gebruiksdashboard voor mijn project niet zien?
De zichtbaarheid van het gebruiksdashboard van een project is niet gerelateerd aan de rol van een gebruiker binnen een project. In plaats daarvan wordt dit bepaald door je rol binnen de organisatie en de instellingen op https://platform.openai.com/settings/organization/data-controls/visibility
Als je geen gebruiksdashboard kunt zien, is deze instelling waarschijnlijk ingesteld op "Zichtbaar voor organisatie-eigenaren".