OpenAI
Þessi síða var vélþýdd. Skoða upprunalegu ensku greinina.

Stjórnun verkefna á API-vettvanginum

Kynntu þér hvernig stofna og stjórna má OpenAI API-verkefnum, þar á meðal meðlimum, hlutverkum, þjónustureikningum, API-lyklum, notkunarmörkum og fjárhagsáætlunum.

Uppfært: 15 days ago

Verkefni eiga að hjálpa viðskiptavinum að skipuleggja vinnu sína. Fyrirtæki geta stjórnað aðgangi og mörkum, stofnað þjónustureikninga (í gegnum viðmótið) og rakið notkun innan afmarkaðs umfangs verkefnis (t.d. líkön, eiginleika, þræði, aðstoðara, fínstillingu, geymslu o.s.frv.). Hægt er að sundurliða notkunarvirkni eftir verkefnum og notendur geta skoðað reikningagerð og stillt útgjaldamörk fyrir hvert verkefni.

Eigendur fyrirtækis geta skoðað öll virk verkefni og verkefni í geymslu á verkefnasíðunni. Frekari upplýsingar um hlutverk notenda og heimildir í API Platform.

Image

Hver getur stofnað verkefni?

Aðeins eigendur stofnunar geta stofnað verkefni. Nánari upplýsingar er að finna í hlutverkum og heimildum.

Til að skipta á milli stofnana skaltu færa bendilinn yfir heiti stofnunarinnar efst til vinstri á síðunni og velja stofnun af listanum:

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

Hjá stofnunum sem eru með sameinaða greiðsluáætlun eru undirstofnanir auðkenndar sérstaklega. Ekki er hægt að stofna verkefni innan undirstofnana.

Image

Hvernig virka verkefni?

Hver stofnun inniheldur „Sjálfgefið verkefni“ sem ekki er hægt að eyða. Þú getur stillt hraðatakmarkanir, heimildir sýndarlíkana og útgjaldamörk (frá og með nóvember 2024). Það erfir allar stillingar stofnunarinnar og því er ekki hægt að bæta meðlimum eða þjónustureikningum beint við það.

Hvernig stofna ég verkefni?

Færðu fyrst bendilinn yfir heiti verkefnisins vinstra megin á síðunni og veldu Stofna verkefni.

API platform project menu with Create project highlighted under Default project

Gefðu upp heiti, lýsingu og vefsvæði verkefnisins og veldu síðan Stofna.

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

Hvernig bæti ég notendum við verkefni?

Nýjum meðlimum stofnunar er ekki sjálfkrafa bætt við „Sjálfgefið verkefni“. Hægt er að bjóða nýjum meðlimum í verkefnið annaðhvort þegar þeim er boðið í stofnunina (með því að haka við „Bjóða í sjálfgefið verkefni“) eða eftir að þeir hafa samþykkt boðið í stofnunina.

Um notendur sem boðið er í gegnum Admin API gilda reglurnar sem lýst er fyrir /organization/invites-endapunktinn.

Ef villa kemur upp þegar notendum er boðið í verkefni í gegnum notendaviðmótið eða Admin API skaltu fyrst staðfesta að viðkomandi verkefni sé til og hafi ekki verið sett í geymslu áður en boðið er sent aftur.

Eigendum stofnunar er sjálfkrafa bætt við sem eigendum nýrra verkefna sem stofnuð eru innan hennar.

Hvaða notendahlutverk eru í stofnunum og verkefnum og hvaða heimildir fylgja þeim?

Stofnanir hafa hlutverkin „eigandi“ og „lesandi“ en verkefni hafa hlutverkin „eigandi“ og „meðlimur“. Meðlimir verkefnis samsvara lesendum stofnunar. Í töflunni hér fyrir neðan er nánari lýsing á heimildunum sem fylgja hverju notendahlutverki.

HlutverkUmfangLýsing
EigandiStofnunGetur stofnað og skoðað öll verkefni, alla notendur og alla API-lykla. Getur fylgst með öllum verkefnum innan stofnunarinnar á

Verkefnasíðunni
. Getur stillt útgjaldamörk stofnunar og verkefna. Getur veitt öðrum innan stofnunarinnar heimild til að skoða upplýsingar um notkun. Getur sett verkefni í geymslu.
LesandiStofnunGetur keyrt ályktanir, notað tilföng og búið til lykla í sínum verkefnum. Hægt er að bæta honum við verkefni.
Getur ekki stofnað verkefni eða stjórnað notendum.
EigandiVerkefniGetur bætt öðrum notendum við verkefnið og breytt heiti þess, auk þess að hafa allar heimildir meðlims. Getur stillt útgjaldamörk verkefnis. Getur sett verkefnið í geymslu.
MeðlimurVerkefniGetur keyrt ályktanir, notað tilföng og búið til lykla fyrir verkefnið.

Að hverju hef ég aðgang ef ég er ekki eigandi stofnunarinnar?

Notendur sem eru ekki eigendur stofnunarinnar sjá aðeins verkefni sem þeir eiga aðild að. Aðeins eigandi stofnunarinnar getur séð öll verkefni, alla meðlimi og alla API-lykla verkefna og hefur aðgang að Verkefnasíðunni.

  • Aðeins meðlimir verkefnis (og eigendur stofnunarinnar) geta séð fínstillt líkön sem búin hafa verið til innan verkefnisins, þræði frá aðstoðarmönnum sem hafa verið búnir til og skrár sem hefur verið bætt við.

  • Meðlimir verkefnis geta séð alla aðra meðlimi þess og hlutverk þeirra (þ.e. Eigandi eða Meðlimur).

Hvernig breyti ég hlutverki notanda í verkefni eða fjarlægi hann úr því?

Aðeins eigandi verkefnis getur breytt hlutverki notanda í verkefninu eða fjarlægt hann úr því. Nánari upplýsingar er að finna í hlutverkum og heimildum.

Til að uppfæra notanda í verkefni skaltu fara í stillingar stofnunarinnar, velja verkefnið og smella á Meðlimir. Þú getur stillt hlutverk hvers meðlims á Meðlimur eða Eigandi. Þú getur einnig valið Fjarlægja til að fjarlægja notandann úr verkefninu.

Hvað er þjónustureikningur og hvernig er hann frábrugðinn venjulegum notandareikningi?

Þjónustureikningur virkar sem sýndarnotandi fyrir kerfisaðgang og er aðskilinn frá reikningum einstakra notenda. Aðeins eigendur stofnunar og verkefnis geta stofnað þjónustureikninga.

Þjónustureikningar eru aðeins bundnir við verkefni.

Bæta meðlim við verkefni

Ef þú smellir á hnappinn + Bæta við meðlim birtist listi yfir notendur í stofnuninni þinni sem hafa hlutverkið Lesandi. Ef þú vilt bæta við notanda sem er ekki í stofnuninni þinni þarftu fyrst að bæta honum við stofnunina (þú getur skilið gátreitinn „Bæta við sjálfgefið verkefni“ auðan ef þú vilt ekki veita þessum notendum víðtækari aðgang). Þjónustureikningar birtast ekki á þessum lista. Í þessu skrefi geturðu valið hvort hlutverk notandans sé Eigandi eða Meðlimur:

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

Þegar þú bætir við liðsmanni þarftu að úthluta honum annaðhvort hlutverkinu Meðlimur eða Eigandi. Meðlimir verkefnis geta sent API-beiðnir sem lesa eða breyta gögnum en eigendur verkefnis geta einnig breytt verkefnastillingum og útgjaldamörkum þess og haft umsjón með meðlimum. Nánari upplýsingar er að finna í hlutverkum og heimildum.

Hvernig stofna á þjónustureikning fyrir verkefni

Farðu fyrst í verkefnið sem þú vilt stofna þjónustureikning fyrir með því að velja það úr fellilistanum á yfirlitsstikunni:

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

Farðu síðan í stillingar stofnunarinnar -> Verkefni -> Meðlimir -> smelltu á + Þjónustureikningur:

Þjónustureikningar sem eru stofnaðir á verkefnastigi eru einstakir fyrir verkefnið og ekki er hægt að nota þá utan þess verkefnis sem þeir eru stofnaðir í.

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

Heiti þjónustureikningsins

Hvort sem þú stofnar þjónustureikning fyrir alla stofnunina eða eingöngu fyrir tiltekið verkefni geturðu valið honum einkvæmt auðkenni úr bókstöfum, tölustöfum og bandstrikum svo auðvelt sé að þekkja hann.

Vista API-lykil þjónustureikningsins

Þegar hnappurinn Stofna er valinn er API-lykill samstundis búinn til fyrir þjónustureikninginn og leynilykillinn birtist. Vistaðu leynilykilinn á öruggum stað. Af öryggisástæðum geturðu ekki skoðað hann aftur í OpenAI-reikningnum þínum. Ef þú glatar leynilyklinum þarftu að búa til nýjan.

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

API-lykill þjónustureikningsins fær sjálfgefið les- og skrifheimildir fyrir öll API-tilföng verkefnisins. Hægt er að uppfæra þessar heimildir í stillingum API-lykla verkefnisins.

Þjónustureikningar eru skráðir ásamt meðlimum verkefnisins á stillingasíðu meðlima. Nánari upplýsingar um að uppfæra eða fjarlægja aðgang þjónustureiknings á stillingasíðu meðlima verkefnisins er að finna hér.

Allir þjónustureikningar í bæði verkefnum og stofnunum birtast samhliða mannlegum notendum þínum á meðlimasíðu á stofnunarstigi.

Þjónustureikningum er stjórnað eins og venjulegum reikningum. Í Stofnun -> Meðlimavalmynd geturðu Fjarlægt þjónustureikning eða uppfært hlutverkið:

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

Hvernig stjórna ég API-lyklum í verkefnum stofnunarinnar minnar?

Þú getur búið til og stjórnað API-lyklum hvers verkefnis á stillingasíðu þess. Farðu í stillingar stofnunarinnar, veldu verkefnið og smelltu á API-lyklar.

Til að búa til nýjan leynilykil skaltu velja + Búa til nýjan leynilykil. Þú getur einnig valið breytingatáknið við hlið leynilykils til að breyta heimildum hans.

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

Þú getur stillt heimildir hvers API-lykils þegar þú býrð til nýjan leynilykil eða með því að breyta lykli sem þegar er til.

Þrjú heimildastig eru í boði: Allt, Takmarkað og Aðeins lestur.

  • Allt — Leynilykillinn fær allar heimildir. Þetta er sjálfgefin stilling.

  • Takmarkað — Gerir notandanum kleift að stilla Engar, Lesa og Skrifa heimildir fyrir hvern endapunkt.

  • Til dæmis geturðu búið til API-lykil sem hefur sérstaklega hvorki les- né skrifheimild fyrir /v1/assistants-endapunktinn:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Aðeins lestur — Lesheimildir eru stilltar fyrir alla endapunkta.

Hvernig er aðgangi stjórnað fyrir notendur sem tilheyra mörgum verkefnum eða stofnunum?

Notendur geta átt aðild að eins mörgum verkefnum og þörf er á. Innan verkefnis geta notendur búið til persónulegan API-lykil sem er bundinn við aðgang að því verkefni og tilföngum þess.

Hvernig stilli ég og stjórna hraðatakmörkunum verkefna stofnunarinnar minnar?

Aðeins eigandi stofnunar getur stillt og stjórnað hraðatakmörkunum verkefna. Nánari upplýsingar er að finna í hlutverkum og heimildum.

Farðu í stillingar stofnunarinnar, smelltu á verkefnið sem þú vilt uppfæra og veldu Mörk í hlutanum Verkefni í yfirlitsvalmyndinni. Á þessari síðu geturðu uppfært Líkannotkun.

Með Líkannotkun geturðu valið hvaða líkön verkefnið má nota og stillt hraðatakmarkanir fyrir hvert líkan eftir þörfum.

Hvernig stilli ég og stjórna útgjaldamörkum verkefna stofnunarinnar minnar?

Aðeins eigendur stofnunar og eigendur verkefnis geta stillt og stjórnað útgjaldamörkum verkefnis. Nánari upplýsingar er að finna í hlutverkum og heimildum. Til að breyta mörkum stofnunarinnar skaltu fara í stillingar stofnunarinnar, smella á Mörk og fletta niður að Notkunarmörkum.

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

Til að stilla mörk verkefnis skaltu fara í stillingar stofnunarinnar, smella á verkefnið sem þú vilt uppfæra og velja Mörk. Þú getur uppfært Mánaðarleg útgjaldamörk, Tilkynningarmörk og Líkannotkun.

Með því að stilla mánaðarleg útgjaldamörk geturðu skilgreint mjúk útgjaldaviðmið fyrir verkefnið. Ef notkun fer yfir þessi mörk innan tiltekins almanaksmánaðar (UTC) verður áfram unnið úr API-beiðnum án truflana. Eiginleikinn auðveldar þér að fylgjast með notkun með viðvörunum um útgjaldamörk en setur ekki ófrávíkjanlegt hámark á útgjöld. Þegar útgjaldamörk verkefnis eru stofnuð er sjálfgefið að viðvörun sé búin til við 100% mörkin. Hægt er að stilla fleiri viðvaranir við önnur mörk með því að smella á Bæta við viðvörun.

Athugaðu að eigendur stofnunarinnar og verkefnisins fá alltaf þessi skilaboð og ekki er hægt að breyta því.

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

Hvernig stilli ég útgjaldamörk fyrir stofnunina mína eða verkefni?

OpenAI styður nú mánaðarleg útgjaldamörk API bæði fyrir stofnanir og verkefni. Útgjaldamörk geta vaktað útgjöld án þess að stöðva þau, eða þau geta verið ófrávíkjanleg þannig að API-beiðnir mistakist þegar mörkunum er náð. Nýjustu leiðbeiningar um uppsetningu og virkni er að finna undir Útgjaldamörk í skjölum fyrir forritara.

Hvernig eyði ég verkefni eða set það í geymslu?

Hægt er að setja verkefni í geymslu annaðhvort á nýju síðunni með verkefnalistanum eða í stillingum viðkomandi verkefnis. Þegar verkefni hefur verið sett í geymslu er ekki hægt að endurheimta það. Þegar þú setur verkefni í geymslu verður þú beðin(n) um að slá inn heiti þess til að halda áfram.

Þú getur séð lista yfir öll verkefni í geymslu á flipanum „Í geymslu“ á sömu síðu með verkefnalistanum.

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

Ekki er hægt að eyða verkefnum. Við varðveitum feril allra verkefna til að tryggja samfellu í skráningu notkunar og reikningsfærslu.

Eru takmörk á því hversu mörg verkefni ég get haft í stofnuninni minni?

Sjálfgefið geta stofnanir stofnað allt að 2.000 verkefni.

Er hægt að deila tilföngum á milli verkefna?

Tilföng verkefnis (svo sem skrár, aðstoðarmenn, geymsla eða þræðir) tilheyra verkefninu og meðlimir utan þess sem ekki eru stjórnendur hafa ekki aðgang að þeim. Auk þess er ekki hægt að flytja tilföng á milli verkefna.

Eina undantekningin er sú að fínstillingar í „Sjálfgefna verkefninu“ er hægt að nálgast úr öðrum verkefnum.

Hver er skráageymslukvóti hvers verkefnis?

OpenAI styður nú skráageymslukvóta upp á 100 GB fyrir hvert verkefni.

Ef farið er yfir kvótann birtist eftirfarandi villa:

Þú hefur farið yfir geymslukvóta skráa. Fyrirtæki eru takmörkuð við 100 GB af skrám. Vinsamlegast minnkaðu skráarstærðina eða hafðu samband við þjónustudeild.

Við mælum með að þú eyðir ónotuðum skrám sem eru vistaðar á reikningnum þínum. Til viðmiðunar geturðu skoðað og skráð skrár með API.

Ég er eigandi verkefnis. Hvers vegna sé ég ekki notkunaryfirlit verkefnisins?

Sýnileiki notkunaryfirlits verkefnis tengist ekki hlutverki notanda innan verkefnisins. Hann ræðst þess í stað af hlutverki þínu innan stofnunarinnar og stillingunum á https://platform.openai.com/settings/organization/data-controls/visibility

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

Ef þú sérð ekki notkunaryfirlit er þessi stilling líklega stillt á „Sýnilegt eigendum stofnunar“.

Var þessi grein gagnleg?