OpenAI
Denne side er maskinoversat. Se den originale engelske artikel.

Administration af projekter i API-platformen

Opdateret: 7 days ago

Projekter har til formål at give kunder mulighed for at organisere deres arbejde. Organisationer kan administrere adgang og grænser, klargøre tjenestekonti (via brugergrænsefladen) og spore forbrug inden for et afgrænset område i et projekt (f.eks. modeller, funktioner, tråde, assistenter, finjustering, lagerplads osv.). Forbrugsaktivitet kan opdeles efter projekt, og brugere kan se fakturering og angive forbrugsgrænser pr. projekt.

Organisationsejere kan se alle deres aktive og arkiverede projekter på projektsiden. Få mere at vide om brugerroller og tilladelser i API-platformen.

Image

Hvem kan oprette et projekt?

Kun organisationsejere kan oprette et projekt. Se roller og tilladelser for flere oplysninger.

For at skifte mellem organisationer skal du holde markøren over din organisations navn øverst til venstre på siden og vælge organisationen på listen:

Projects page with the organization switcher open, listing Personal and Staging organizations

For de organisationer, der er på en konsolideret faktureringsplan, identificeres underorganisationer separat. Projekter kan ikke oprettes i underorganisationer.

Image

Hvordan fungerer projekter?

Hver organisation har et “standardprojekt”, som ikke kan slettes. Du kan konfigurere rategrænser, tilladelser til virtuelle modeller og forbrugsgrænser (fra november 2024). Det arver hele organisationens konfiguration, så du kan ikke føje medlemmer eller tjenestekonti direkte til det.

Hvordan opretter jeg et projekt?

Hold først markøren over projektnavnet i venstre hjørne af siden, og vælg Opret projekt.

API platform project menu with Create project highlighted under Default project

Angiv et navn, en beskrivelse og et websted til projektet, og vælg derefter Opret.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Hvordan føjer jeg brugere til et projekt?

Nye organisationsmedlemmer føjes ikke automatisk til »Standardprojekt«. Nye medlemmer kan inviteres til projektet, enten når de inviteres til organisationen (ved at markere afkrydsningsfeltet "Inviter til standardprojekt"), eller efter at medlemmet har accepteret invitationen til organisationen.

Brugere, der inviteres via Admin API, følger reglerne for /organization/invites-endepunktet.

Hvis der opstår en fejl, når du inviterer brugere til et projekt via brugerfladen eller Admin API, skal du først kontrollere, at projektet findes og ikke er arkiveret, før du sender invitationen igen.

Organisationsejere tilføjes automatisk som ejere af nye projekter, der oprettes i organisationen.

Hvilke forskellige brugerroller findes der i organisationer og projekter, og hvilke tilladelser indebærer de?

Mens organisationer har rollerne “ejer” og “læser”, har projekter rollerne “ejer” og “medlem”. Projektmedlemmer svarer til organisationslæsere. Se tabellen nedenfor for en mere detaljeret beskrivelse af, hvilke tilladelser der følger med hver brugerrolle.

RolleOmfangBeskrivelse
EjerOrganisationKan oprette/se alle projekter, alle brugere og alle API-nøgler. Kan overvåge på tværs af alle projekter i organisationen via

projektsiden
. Kan angive forbrugsgrænser for organisationen og for projekter. Kan give tilladelser til at se forbrugsoplysninger for andre i organisationen. Kan arkivere projekter.
LæserOrganisationKan udføre inferens, bruge ressourcer og oprette nøgler i deres projekter. Kan føjes til projekter.
Kan ikke oprette projekter eller administrere brugere.
EjerProjektKan føje andre brugere til projektet og omdøbe projektet samt gøre alt, hvad et medlem kan. Kan angive forbrugsgrænser for projektet. Kan arkivere projektet.
MedlemProjektKan udføre inferens, bruge ressourcer og oprette nøgler på projektniveau.

Hvad har jeg adgang til, hvis jeg ikke er ejer i organisationen?

Brugere, der ikke er ejere i organisationen, kan kun se de projekter, som de er medlemmer af. Kun organisationsejeren kan se alle projekter, medlemmer og API-nøgler på projektniveau og har adgang til siden Projekter.

  • Kun projektmedlemmer og organisationsejere kan se de finjusterede modeller, der er oprettet i projektet, trådene fra oprettede Assistants eller tilføjede filer.

  • Projektmedlemmer kan se alle projektets øvrige medlemmer og deres roller (dvs. Ejer eller Medlem).

Hvordan ændrer jeg en brugers projektrolle eller fjerner en bruger fra et projekt?

Kun projektejeren kan ændre en brugers projektrolle eller fjerne en bruger fra et projekt. Se roller og tilladelser for at få flere oplysninger.

Hvis du vil opdatere en bruger i et projekt, skal du gå til organisationsindstillingerne, vælge projektet og klikke på Medlemmer. Du kan angive hvert medlems rolle som Medlem eller Ejer. Du kan også vælge Fjern for at fjerne brugeren fra projektet.

Hvad er en servicekonto, og hvordan adskiller den sig fra en almindelig brugerkonto?

En servicekonto fungerer som en pseudo-bruger, der er designet til systemadgang, og som adskiller sig fra individuelle brugerkonti. Kun organisations- og projektejere kan oprette servicekonti.

Servicekonti er kun afgrænset til projekter.

Føj et medlem til et projekt

Hvis du klikker på knappen + Tilføj medlem, vises en liste over brugere i organisationen med rollen Læser. Hvis du vil tilføje en bruger, der ikke allerede er i organisationen, skal du først føje vedkommende til organisationen (lad afkrydsningsfeltet "Føj til standardprojekt" være umarkeret, hvis brugeren ikke skal have bredere adgang). Tjenestekonti vises ikke på listen. Her kan du vælge rollen Ejer eller Medlem:

Project members with Add team members dialog assigning a user the Member role

Når du tilføjer et teammedlem, skal du tildele vedkommende rollen Medlem eller Ejer. Projektmedlemmer kan foretage API-anmodninger, der læser eller ændrer data, mens projektejere også kan ændre projektindstillinger og projektets forbrugsgrænser samt administrere projektmedlemmer. Se roller og tilladelser for at få flere oplysninger.

Sådan opretter du en tjenestekonto til et projekt

Gå først til det projekt, du vil oprette en tjenestekonto til, ved at vælge det i rullemenuen på navigationslinjen:

API platform project switcher open with options to create a project or manage projects

Gå derefter til organisationsindstillingerne -> Projekt -> Medlemmer -> klik på + Tjenestekonto:

Servicekonti, der oprettes på projektniveau, er unikke for projektet og kan ikke bruges uden for det projekt, de er oprettet i.

Project Members page with Create a service account dialog after selecting the Service account option

Navngivning af servicekontoen

Uanset om du opretter servicekontoen på organisationsniveau eller opretter en, der er unik for et projekt, kan du, når du opretter en servicekonto, oprette et unikt servicekonto-id bestående af bogstaver, tal og bindestreger for nemt at identificere servicekontoen.

Gem tjenestekontoens API-nøgle

Når du har valgt knappen Opret, oprettes der straks en API-nøgle til tjenestekontoen, og den hemmelige nøgle vises. Gem den hemmelige nøgle et sikkert sted. Af sikkerhedsmæssige årsager kan du ikke se den igen via din OpenAI-konto. Hvis du mister den hemmelige nøgle, skal du oprette en ny.

Members page with Save your key modal after creating a service account

Tjenestekontoens API-nøgle har som standard læse- og skriveadgang til alle projektets API-ressourcer. Disse tilladelser kan opdateres under projektets indstillinger for API-nøgler.

Tjenestekonti vises sammen med projektmedlemmer på siden med projektets medlemsindstillinger. Se her for at få mere at vide om, hvordan du opdaterer eller fjerner en tjenestekontos adgang på siden med projektets medlemsindstillinger.

Alle tjenestekonti på tværs af både projekter og organisationer vises sammen med dine menneskelige brugere på medlemssiden på organisationsniveau.

Tjenestekonti administreres som almindelige konti. Fra Organisation -> menuen Medlemmer kan du Fjerne en tjenestekonto eller opdatere rollen:

OpenAI API Members settings with a service account role menu open for Reader or Owner

Hvordan administrerer jeg API-nøgler i min organisations projekter?

Du kan oprette og administrere API-nøgler for hvert projekt på projektets indstillingsside. Gå til organisationsindstillingerne, vælg projektet, og klik på API-nøgler.

Vælg + Opret ny hemmelig nøgle for at oprette en ny hemmelig nøgle. Du kan også vælge redigeringsikonet ud for en hemmelig nøgle for at redigere dens tilladelser.

API keys page for a project with the Create new secret key button highlighted

Du kan angive tilladelser for hver API-nøgle, når du opretter en ny hemmelig nøgle, eller ved at redigere en eksisterende nøgle.

Der findes tre tilladelsesniveauer: Alle, Begrænset og Skrivebeskyttet.

  • Alle — Den hemmelige nøgle får fulde tilladelser. Dette er standardindstillingen.

  • Begrænset — Giver brugeren mulighed for at angive tilladelserne Ingen, Læs og Skriv for hvert endepunkt.

  • Du kan f.eks. oprette en API-nøgle, som specifikt ikke har tilladelse til at læse fra eller skrive til endepunktet /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Skrivebeskyttet — Der angives læsetilladelse for alle endepunkter.

Hvordan administreres adgang for brugere, der tilhører flere projekter eller organisationer?

Brugere kan være medlemmer af så mange projekter, som der er behov for. I et projekt kan brugere generere en personlig API-nøgle, der er afgrænset og begrænset til adgang til det pågældende projekt og dets ressourcer.

Hvordan angiver og administrerer jeg brugsgrænser for min organisations projekter?

Kun ejeren af en organisation kan angive og administrere brugsgrænser på projektniveau. Se roller og tilladelser for flere oplysninger.

I dine organisationsindstillinger skal du klikke på det projekt, du vil opdatere, og vælge Grænser i afsnittet Projekt i navigationslisten. Du kan opdatere din Modelbrug på denne side.

Modelbrug giver dig mulighed for at konfigurere, hvilke modeller der kan bruges af projektet, og brugsgrænser kan angives for hver model efter behov.

Hvordan angiver og administrerer jeg forbrugsgrænser for min organisations projekter?

Kun organisationsejere og projektejere kan angive og administrere et projekts forbrugsgrænser. Se roller og tilladelser for at få flere oplysninger. Hvis du vil ændre grænserne på organisationsniveau, skal du gå til organisationsindstillingerne, klikke på Grænser og rulle ned til Forbrugsgrænser.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Hvis du vil angive projektgrænser, skal du gå til organisationsindstillingerne, klikke på det projekt, du vil opdatere, og vælge Grænser. Du kan opdatere Månedlig forbrugsgrænse, Notifikationstærskel og Modelbrug.

Med en månedlig forbrugsgrænse kan du angive vejledende forbrugstærskler for projektet. Hvis forbruget overstiger grænsen i en given kalendermåned (UTC), behandles API-anmodninger fortsat uden afbrydelse. Funktionen hjælper dig med at overvåge forbruget via advarsler om forbrugsgrænsen, men håndhæver ikke et fast loft over forbruget. Når der oprettes en forbrugsgrænse for et projekt, oprettes der som standard en advarsel ved tærsklen på 100 %. Du kan angive flere advarsler ved forskellige tærskler ved at klikke på Tilføj advarsel.

Bemærk, at organisations- og projektejere altid modtager disse beskeder, og at dette ikke kan tilpasses.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Hvordan angiver jeg forbrugsgrænser for min organisation eller mit projekt?

OpenAI understøtter nu månedlige grænser for API-forbrug på både organisations- og projektniveau. En forbrugsgrænse kan overvåge forbruget uden håndhævelse, eller du kan håndhæve den som en hård grænse, så API-anmodninger mislykkes, når forbruget når grænsen. Se Forbrugsgrænser i udviklerdokumentationen for de nyeste konfigurationstrin og den nyeste funktionsmåde.

Hvordan sletter eller arkiverer jeg et projekt?

Projekter kan arkiveres enten via den nye side med projektoversigten eller under indstillingerne for det enkelte projekt. Når et projekt er arkiveret, kan det ikke gendannes. Når du arkiverer et projekt, bliver du bedt om at indtaste projektets navn for at fortsætte.

Du kan se en liste over alle arkiverede projekter på fanen »Arkiveret« på samme side med projektoversigten.

API platform Projects page with the Archived tab selected to view archived projects

Projekter kan ikke slettes. Vi gemmer historikken for alle projekter for at sikre kontinuitet i registreringen af forbrug og fakturering.

Er der en grænse for, hvor mange projekter jeg kan have i min organisation?

Organisationer kan som standard oprette op til 2.000 projekter.

Kan ressourcer deles på tværs af projekter?

Projektressourcer (såsom filer, assistants, lager eller tråde) er afgrænset til projektet og kan ikke tilgås af ikke-adminmedlemmer uden for projektet. Desuden kan ressourcer ikke flyttes mellem projekter.

Den ene undtagelse er, at finjusteringer i "Standardprojekt" kan tilgås fra andre projekter.

Hvor stor er lagerkvoten for filer pr. projekt?

OpenAI understøtter i øjeblikket en lagerkvote på 100 GB filer pr. projekt.

Hvis denne kvote overskrides, vises følgende fejl:

Du har overskredet din filopbevaringskvote. Organisationer er begrænset til 100 GB filer. Reducer filstørrelsen, eller kontakt support.

Vi anbefaler, at du sletter ubrugte filer, der er gemt på din konto. Som reference kan du se og liste filer med API'en.

Jeg er projektejer. Hvorfor kan jeg ikke se forbrugsdashboardet for mit projekt?

Synligheden af et projekts forbrugsdashboard afhænger ikke af brugerens rolle i projektet. Den bestemmes i stedet af din rolle i organisationen og indstillingerne på https://platform.openai.com/settings/organization/data-controls/visibility

Project setting for Usage dashboard visibility with Visible to organization owners selected

Hvis du ikke kan se et forbrugsdashboard, er denne indstilling sandsynligvis sat til "Synligt for organisationsejere".

Var denne artikel nyttig?