OpenAI
Denne siden ble maskinoversatt. Se den opprinnelige engelske artikkelen.

Administrere prosjekter i API-plattformen

Oppdatert: 8 days ago

Prosjekter har som mål å gi kunder mulighet til å organisere arbeidet sitt. Organisasjoner kan administrere tilgang og grenser, klargjøre tjenestekontoer (via brukergrensesnittet) og spore bruk mot et avgrenset omfang i et prosjekt (f.eks. modeller, funksjoner, tråder, assistenter, finjustering, lagring osv.). Bruksaktivitet kan brytes ned etter prosjekt, og brukere kan vise fakturering og angi budsjetter per prosjekt.

Organisasjonseiere kan vise alle aktive og arkiverte prosjekter på Prosjekter-siden. Finn ut mer om brukerroller og tillatelser i API-plattformen.

Image

Hvem kan opprette et prosjekt?

Bare organisasjonseiere kan opprette et prosjekt. Se roller og tillatelser for mer informasjon.

For å bytte mellom organisasjoner holder du pekeren over organisasjonens navn øverst til venstre på siden og velger organisasjonen fra listen:

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

For organisasjoner som har en konsolidert faktureringsplan, identifiseres underorganisasjoner separat. Prosjekter kan ikke opprettes i underorganisasjoner.

Image

Hvordan fungerer prosjekter?

Hver organisasjon inkluderer et «Standardprosjekt» som ikke kan slettes. Du kan konfigurere hastighetsgrenser, tillatelser for virtuelle modeller og forbruksbudsjetter (fra november 2024). Det arver hele konfigurasjonen til organisasjonen, så du kan ikke legge til medlemmer eller tjenestekontoer direkte i det.

Hvordan oppretter jeg et prosjekt?

Hold først pekeren over prosjektnavnet i venstre hjørne av siden og velg Create project.

API platform project menu with Create project highlighted under Default project

Oppgi navn, beskrivelse og nettsted for prosjektet, og velg deretter Create.

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

Hvordan legger jeg til brukere i et prosjekt?

Nylig tillagte organisasjonsmedlemmer legges ikke automatisk til i «Standardprosjektet». Nye medlemmer kan inviteres til prosjektet enten når de inviteres til organisasjonen (ved å aktivere avmerkingsboksen «Inviter til standardprosjekt») eller etter at medlemmet har godtatt organisasjonsinvitasjonen.

Brukere som inviteres via Admin API, følger reglene som er beskrevet av /organization/invites-endepunktet.

Hvis du får en feil når du inviterer brukere til et prosjekt via brukergrensesnittet eller Admin API, må du først bekrefte at målprosjektet finnes og ikke er arkivert før du sender invitasjonen på nytt.

Organisasjonseiere legges automatisk til som eiere i nye prosjekter som opprettes i en organisasjon.

Hva er de ulike brukerrollene i organisasjoner og prosjekter, og hvilke tillatelser innebærer de?

Mens organisasjoner har rollene «eier» og «leser», har prosjekter rollene «eier» og «medlem». Prosjektmedlemmer tilsvarer organisasjonslesere. Se tabellen nedenfor for en mer detaljert beskrivelse av hvilke tillatelser som følger med hver brukerrolle.

RolleOmfangBeskrivelse
EierOrganisasjonKan opprette/vise alle prosjekter, alle brukere og alle API-nøkler. Har mulighet til å overvåke på tvers av alle prosjekter i organisasjonen med

Prosjekter-siden
. Kan angi organisasjonsbudsjetter og prosjektbudsjetter. Kan gi andre i organisasjonen tillatelse til å se bruksinformasjon. Kan arkivere prosjekter.
LeserOrganisasjonKan utføre inferens, bruke ressurser og opprette nøkler i prosjektene sine. Kan legges til i prosjekter.
Kan ikke opprette prosjekter og administrere brukere.
EierProsjektKan legge til andre brukere i prosjektet og gi prosjektet nytt navn, samt ha alle mulighetene til et medlem. Kan angi prosjektbudsjetter. Kan arkivere prosjektet.
MedlemProsjektKan utføre inferens, bruke ressurser og opprette nøkler på prosjektnivå.

Hvis jeg ikke er eier i organisasjonen, hva har jeg tilgang til?

Brukere som ikke er eiere i organisasjonen, kan bare se prosjekter de er medlemmer av. Bare organisasjonseieren kan se alle prosjekter, medlemmer og API-nøkler på prosjektnivå og ha tilgang til Prosjekter-siden.

  • Bare medlemmene av et prosjekt (og organisasjonseiere) kan se de finjusterte modellene som er opprettet i prosjektet, trådene fra eventuelle opprettede Assistants, eller filer som er lagt til.

  • Medlemmer av et prosjekt kan se hvem alle de andre medlemmene av prosjektet er, og rollene deres (dvs. eier eller medlem).

Hvordan oppdaterer jeg en brukers prosjektrolle eller fjerner en bruker fra et prosjekt?

Bare eieren av et prosjekt kan oppdatere en brukers prosjektrolle eller fjerne en bruker fra et prosjekt. Se roller og tillatelser for mer informasjon.

For å oppdatere en bruker i et prosjekt går du til organisasjonsinnstillingene, velger prosjektet og klikker på Medlemmer. Du kan angi hvert medlems rolle som medlem eller eier. Du kan også velge Fjern for å fjerne brukeren fra prosjektet.

Hva er en tjenestekonto, og hvordan skiller den seg fra en vanlig brukerkonto?

En tjenestekonto fungerer som en pseudobruker laget for systemtilgang, forskjellig fra individuelle brukerkontoer. Bare organisasjons- og prosjekteiere kan opprette tjenestekontoer.

Tjenestekontoer er bare avgrenset til prosjekter.

Legg til et medlem i et prosjekt

Hvis du klikker på + Add member-knappen, ser du en liste over brukere i organisasjonen din med rollen Reader. Hvis du vil legge til en bruker som ikke er i organisasjonen din nå, må du først legge vedkommende til i organisasjonen (du kan la avmerkingsboksen «Legg til i standardprosjekt» være uavmerket hvis du ikke vil gi disse brukerne bredere tilgang). Denne listen inkluderer ikke tjenestekontoer. I dette trinnet kan du velge om rollen deres skal være enten Owner eller Member:

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

Når du legger til et teammedlem, må du tildele vedkommende rollen Medlem eller Eier. Prosjektmedlemmer kan sende API-forespørsler som leser eller endrer data, mens prosjekteiere også kan endre prosjektinnstillinger og prosjektbudsjetter samt administrere prosjektmedlemmer. Se roller og tillatelser for mer informasjon.

Slik oppretter du en tjenestekonto for et prosjekt

Gå først til prosjektet du vil opprette en tjenestekonto for, ved å velge fra rullegardinmenyen i navigasjonslinjen:

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

Gå deretter til organisasjonsinnstillingene -> Prosjekt -> Medlemmer -> klikk på + Service account:

Tjenestekontoer som opprettes på prosjektnivå er unike for prosjektet og kan ikke brukes utenfor prosjektet de er opprettet i.

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

Navngi tjenestekontoen

Uansett om du oppretter tjenestekontoen på organisasjonsnivå eller oppretter en unik for et prosjekt, kan du når du oppretter en tjenestekonto lage en unik tjenestekonto-ID bestående av bokstaver, tall og bindestreker for enkelt å identifisere tjenestekontoen.

Lagre API-nøkkelen for tjenestekontoen

Etter at du har valgt Opprett-knappen, opprettes det umiddelbart en API-nøkkel for tjenestekontoen, og den hemmelige nøkkelen vises. Lagre denne hemmelige nøkkelen et trygt og sikkert sted. Av sikkerhetsgrunner kan du ikke se den igjen via OpenAI-kontoen din. Hvis du mister denne hemmelige nøkkelen, må du generere en ny.

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

Tillatelsene for API-nøkkelen til tjenestekontoen er som standard satt til å lese og skrive alle prosjektets API-ressurser. Disse tillatelsene kan oppdateres i prosjektets API-nøkkelinnstillinger.

Tjenestekontoer vises sammen med prosjektmedlemmer på siden for medlemsinnstillinger i prosjektet. Se her for å lære mer om å oppdatere eller fjerne tilgangen til en tjenestekonto på siden for medlemsinnstillinger i prosjektet.

Alle tjenestekontoer på tvers av både prosjekter og organisasjoner vises sammen med de menneskelige brukerne dine på medlemssiden på organisasjonsnivå.

Tjenestekontoer administreres som vanlige kontoer. Fra Organisasjon -> Medlemmer-menyen kan du fjerne en tjenestekonto eller oppdatere rollen:

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

Hvordan administrerer jeg API-nøkler i organisasjonens prosjekter?

Du kan opprette og administrere API-nøkler for hvert prosjekt på innstillingssiden for prosjektet. I organisasjonsinnstillingene velger du prosjektet og klikker på API-nøkler.

For å opprette en ny hemmelig nøkkel velger du + Create new secret key. Du kan også velge redigeringsikonet ved siden av en hemmelig nøkkel for å redigere tillatelsene.

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

Du kan angi tillatelser for hver av API-nøklene dine når du oppretter en ny hemmelig nøkkel eller ved å redigere en eksisterende nøkkel.

Tre tillatelsesnivåer er tilgjengelige: Alle, Begrenset og Skrivebeskyttet.

  • Alle — Fullstendige tillatelser er angitt for den hemmelige nøkkelen. Dette er standardinnstillingen.

  • Begrenset — Lar brukeren angi tillatelsene Ingen, Lese og Skrive for hvert endepunkt.

    • Du kan for eksempel opprette en API-nøkkel som spesifikt ikke har tillatelse til å lese eller skrive til /v1/assistants-endepunktet:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Skrivebeskyttet — Lesetillatelser er angitt for alle endepunkter.

Hvordan administreres tilgang for brukere som tilhører flere prosjekter eller organisasjoner?

Brukere kan være medlemmer av så mange prosjekter som nødvendig. I et prosjekt kan brukere generere en personlig API-nøkkel som er avgrenset og begrenset til tilgang til det prosjektet og ressursene det inneholder.

Hvordan angir og administrerer jeg bruksgrenser for organisasjonens prosjekter?

Bare eieren av en organisasjon kan angi og administrere bruksgrenser på prosjektnivå. Se roller og tillatelser for mer informasjon.

I organisasjonsinnstillingene klikker du på prosjektet du vil oppdatere, og velger Grenser i Prosjekt-delen av navigasjonslisten. Du kan oppdatere modellbruken din på denne siden.

Modellbruk lar deg konfigurere hvilke modeller som kan brukes av prosjektet, og bruksgrenser kan angis for hver modell etter behov.

Hvordan angir og administrerer jeg budsjetter for organisasjonens prosjekter?

Bare eiere av en organisasjon og eiere av et prosjekt kan angi og administrere prosjektbudsjetter. Se roller og tillatelser for mer informasjon. For å endre grensene på organisasjonsnivå klikker du på Grenser, i organisasjonsinnstillingene og ruller ned til Bruksgrenser.

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

For å angi prosjektgrensene går du til organisasjonsinnstillingene, klikker på prosjektet du vil oppdatere, og velger Grenser. Du kan oppdatere månedlig budsjett, varslingsgrense og modellbruk.

Ved å angi et månedlig budsjett kan du opprette myke utgiftsterskler for prosjektet ditt. Når bruken overstiger denne grensen i en gitt kalendermåned (UTC), vil API-forespørsler fortsatt bli behandlet uten avbrudd. Denne funksjonen er utformet for å hjelpe deg med å overvåke bruk gjennom budsjettvarsler, men den håndhever ikke et hardt tak på forbruk. Når et prosjektbudsjett opprettes, opprettes det som standard et varsel ved terskelen på 100 %. Flere budsjetter med ulike terskler kan angis ved å klikke på Legg til varsel.

Vær oppmerksom på at organisasjonseier(e) og prosjekteier(e) alltid vil motta disse meldingene, og at dette ikke kan tilpasses.

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

Hvordan sletter eller arkiverer jeg et prosjekt?

Prosjekter kan arkiveres enten via den nye siden med prosjektlisten eller i innstillingene for et enkelt prosjekt. Når et prosjekt er arkivert, kan det ikke gjenopprettes. Når du fortsetter med arkivering, blir du bedt om å skrive inn prosjektets navn for å gå videre.

Du kan se en liste over alle arkiverte prosjekter via fanen «Arkivert» på den samme siden med prosjektlisten.

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

Det er ikke mulig å slette prosjekter. Vi beholder en historikk over alle prosjekter for å sikre kontinuitet i sporing av bruk og fakturering.

Er det en grense for hvor mange prosjekter jeg kan ha i organisasjonen min?

Organisasjoner kan opprette opptil 2 000 prosjekter som standard.

Kan ressurser deles på tvers av prosjekter?

Prosjektressurser (som filer, assistants, lagring eller tråder) er avgrenset til prosjektet og kan ikke nås av ikke-admin-medlemmer utenfor prosjektet. Ressurser kan heller ikke flyttes mellom prosjekter.

Det ene unntaket er at finjusteringer i "Standardprosjektet" kan nås fra andre prosjekter.

Hva er fillagringskvoten per prosjekt?

OpenAI støtter for øyeblikket en fillagringskvote på 100 GB med filer per prosjekt.

Hvis denne kvoten overskrides, vil du se følgende feil:

Du har overskredet kvoten for fillagring. Organisasjoner er begrenset til 100 GB med filer. Reduser filstørrelsen eller kontakt brukerstøtte.

Vi anbefaler at du sletter ubrukte filer som er lagret på kontoen din. Som referanse kan du vise og liste filer med API-et.

Jeg er prosjekteier. Hvorfor kan jeg ikke se bruksoversikten for prosjektet mitt?

Synligheten til et prosjekts bruksoversikt er ikke relatert til en brukers rolle i et prosjekt. I stedet bestemmes den av rollen din i organisasjonen og innstillingene 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 en bruksoversikt, er denne innstillingen sannsynligvis satt til «Synlig for organisasjonseiere».

Var denne artikkelen nyttig?