Управување со проекти во API платформата

Преглед

Проектите ја организираат работата во рамките на API-организација. Користете ги за управување со пристапот, поставување ограничувања за моделите и ограничувања на брзината, создавање сервисни сметки и следење на користењето, наплатата и ограничувањата на трошењето за одреден збир ресурси, како што се модели, можности, нишки, асистенти, фино прилагодување и простор за складирање.

Сопствениците на организацијата можат да ги видат сите активни и архивирани проекти на страницата Проекти.

Пред да започнете

За да создадете проект, потребна ви е улогата сопственик на организацијата. Стандардно, организациите можат да создадат до 2.000 проекти.

Ако вашата организација користи обединета наплата, подорганизациите се прикажуваат одделно во избирачот на организации. Не можете да создавате проекти во подорганизација.

За да преминете во друга организација, отворете го избирачот на организации и изберете ја организацијата што сакате да ја користите.

Стандарден проект

Секоја организација вклучува стандарден проект што не може да се избрише. Тој ја наследува целосната конфигурација на организацијата. Можете да ги поставите неговите ограничувања на брзината, дозволи за виртуелни модели и ограничувања на трошењето.

Не можете да додавате членови или сервисни сметки директно во стандардниот проект. Можете да вклучите пристап до стандардниот проект кога поканувате некого во организацијата, следејќи ги чекорите за поканување во организација во оваа статија.

Создавање проект

1. Отворете го избирачот на проекти и изберете Создај проект.

2. Внесете име, опис и веб-локација за вашиот проект.

3. Изберете Создај.

Сопствениците на организацијата автоматски се додаваат како сопственици на новите проекти.

Разбирање на улогите и пристапот

Табелата ги сумира улогите сопственик и читател на организацијата и сопственик и член на проектот што се користат во овие чекори. Членовите на проектот имаат дозволи слични на оние на читателите во организацијата.

За детали за улогите во организацијата, видете: улоги во организацијата. За дополнителни улоги, приспособени улоги и сите дозволи, видете го водичот за улоги и дозволи за API.

Видливост на проектите

Со овие стандардни улоги, корисниците што не се сопственици на организацијата можат да ги гледаат само проектите во кои членуваат. Сопствениците на организацијата можат да ги гледаат сите проекти, членови и API-клучеви на ниво на проект и да пристапат до страницата Проекти.

Членовите на проектот можат да ги гледаат другите членови на својот проект и улогата на секој член. Само членовите на проектот и сопствениците на организацијата можат да ги гледаат фино прилагодените модели, нишките на асистентите и датотеките создадени или додадени во тој проект.

Можете да членувате во онолку проекти колку што ви се потребни. Личен API-клуч создаден во проект е ограничен на тој проект и неговите ресурси.

Граници на пристап до ресурсите

Датотеките, асистентите, просторот за складирање и нишките се ограничени на својот проект. Членовите надвор од тој проект што не се администратори не можат да пристапат до неговите ресурси, а ресурсите не можат да се преместуваат меѓу проекти.

Исклучок се фино прилагодените модели во стандардниот проект: до нив може да се пристапи од други проекти.

Управување со членовите на проектот

Поканување некого во вашата организација

Кога поканувате некого во организацијата, можете да му дадете и пристап до стандардниот проект со избирање на таа опција во формуларот за покана. Оставете ја опцијата неизбрана ако не сакате да дадете пристап до стандардниот проект. Новите членови на организацијата не се додаваат автоматски во стандардниот проект.

Не треба да создадете друг проект пред да поканите некого. Можете да додадете некого во проект и откако ќе ја прифати поканата за организацијата.

Поканите испратени преку администраторскиот API ги следат правилата за крајната точка /organization/invites.

Додавање член на организацијата во проект

Сопствениците на организацијата и на проектите можат да додаваат членови:

1. Одете во поставките на организацијата.

2. Изберете го проектот, па отворете Членови.

3. Изберете + Додај член.

4. Изберете го корисникот и доделете му ја улогата Член или Сопственик.

Списокот со корисници ги прикажува корисниците на организацијата со улогата Читател. Тој не ги вклучува сервисните сметки.

Ако поканата е неуспешна во корисничкиот интерфејс или преку администраторскиот API, проверете дали целниот проект постои и не е архивиран пред повторно да ја испратите поканата.

Промена на улога или отстранување член

Сопствениците на организацијата и на проектите можат да ја променат улогата на корисник во проект или да го отстранат корисникот од тој проект.

1. Одете во поставките на организацијата.

2. Изберете го проектот, па отворете Членови.

3. Поставете ја улогата на корисникот на Член или Сопственик, или изберете Отстрани за да го отстраните.

Создавање и управување со сервисни сметки

Сервисната сметка обезбедува пристап за системи, наместо да претставува поединечен корисник. Сервисните сметки се ограничени на проекти.

За создавање сервисни сметки се потребни дозволи за управување со сервисни сметки. Сопствениците на организацијата и на проектите ги имаат овие дозволи.

Создавање сервисна сметка

1. Изберете го проектот во избирачот на проекти.

2. Одете во поставките на организацијата и изберете го проектот.

3. Отворете Членови и изберете + Сервисна сметка.

4. Внесете единствен идентификатор за сервисната сметка користејќи букви, бројки и цртички.

5. Изберете Создај.

Истиот формат на идентификатор важи без разлика дали ја создавате сервисната сметка преку поставките на ниво на организација или на проект.

Сервисната сметка создадена за одреден проект е единствена за тој проект и не може да се користи надвор од него.

Зачувување на тајниот клуч

При создавање на сервисната сметка веднаш се создава API-клуч и се прикажува неговиот таен клуч. Зачувајте го тајниот клуч на безбедно место. Не можете повторно да го видите преку вашата сметка на OpenAI. Ако го изгубите, генерирајте нов клуч.

Стандардно, клучот на сервисната сметка има пристап за читање и запишување до сите API-ресурси во својот проект. Можете да ги промените тие дозволи подоцна во поставките API-клучеви на проектот.

Сервисните сметки се прикажуваат заедно со корисниците во поставките Членови на проектот. За да управувате со нивниот пристап до проектот, користете ги истите чекори за промена на улога и отстранување како и за другите членови на проектот.

Сите сервисни сметки се прикажуваат и заедно со корисниците на страницата Членови на организацијата, вклучувајќи ги сметките создадени преку поставките на ниво на организација и на проект.

Од менито Членови на организацијата можете да ја промените улогата на сервисна сметка или да изберете Отстрани.

Создавање и управување со API-клучеви

Секој проект има свои API-клучеви:

1. Одете во поставките на организацијата.

2. Изберете го проектот, па отворете API-клучеви.

3. Изберете + Создај нов таен клуч за да создадете клуч или изберете ја иконата за уредување до постоечки клуч за да ги промените неговите дозволи.

Избирање дозволи за клучот

За клучевите во сопственост на корисници, можете да ги поставите дозволите при создавањето на клучот или да ги уредите подоцна:

• Сите: Целосни дозволи. Ова е стандардната поставка.

• Ограничени: Изберете опсег на пристап за одредени ресурси или крајни точки. Достапните опции зависат од ресурсот и може да вклучуваат Нема, Читање, Запишување или дозволи за конкретни барања.

• Само читање: Дозволи за читање за сите крајни точки.

На пример, клуч со ограничени дозволи може да го исклучи пристапот за читање и запишување до крајната точка /v1/assistants.

За создавање клучеви за сервисни сметки се потребни дозволи за управување со сервисни сметки. Ако не ја гледате таа опција, побарајте од сопственик на организацијата или на проектот да го создаде клучот за сервисната сметка. Дијалогот за создавање клуч не ги прикажува овие контроли за дозволи за клучевите на сервисните сметки; променете ги нивните дозволи подоцна во поставките API-клучеви на проектот.

Поставување пристап до модели и ограничувања на брзината

За управување со ограничувањата на брзината на проектот се потребни администраторски дозволи. Сопствениците на организацијата ги имаат овие дозволи, а и сопствениците на проектите можат да управуваат со ограничувањата на брзината на проектите преку API за управување.

1. Одете во поставките на организацијата.

2. Изберете го проектот, па отворете Ограничувања.

3. Преку Користење модели изберете кои модели може да ги користи проектот.

4. По потреба, поставете ограничување на брзината за секој модел.

Поставување ограничувања и известувања за трошење

Месечните ограничувања на трошењето за API се достапни и на ниво на организација и на ниво на проект. За да промените ограничување, потребна ви е дозвола за управување со поставките на соодветната организација или проект.

Ограничувањето на трошењето може да служи за следење на трошоците без да ги запира барањата. Вклучете Примени строго ограничување на трошењето ако сакате API-барањата да бидат неуспешни откако евидентираното трошење ќе го достигне ограничувањето. Ограничувањето не се применува веднаш, па евидентираното трошење може малку да го надмине поставениот износ.

Известувањата за трошење ве известуваат кога ќе се достигне одреден праг; тие не ги запираат барањата.

Поставување ограничување на трошењето за организација

1. Одете во поставките на организацијата.

2. Отворете Ограничувања и најдете Трошење.

Поставување ограничување на трошењето за проект

1. Одете во поставките на организацијата.

2. Изберете го проектот, па отворете Ограничувања.

3. Поставете ги вредностите за Ограничување на месечното трошење и Извести кога трошењето ќе достигне.

4. Вклучете Примени строго ограничување на трошењето ако сакате да го запрете API-сообраќајот откако евидентираното трошење ќе го достигне ограничувањето.

На оваа страница можете да ја промените и поставката Користење модели.

Управување со известувањата за трошење

При создавање ограничување на трошењето за проект, стандардно се создава и известување за достигнување 100% од ограничувањето. Изберете Додај известување за да додадете известувања за други прагови.

Сопствениците на организацијата и на проектите ги добиваат известувањата за трошење на проектите. Во поставките за известувања можете да додадете и други примачи на е-пошта.

За тековните чекори за поставување и начинот на примена на ограничувањата, видете го водичот за ограничувања на трошењето.

Преглед на користењето и наплатата

Користењето може да се прикажува по проект, а за поединечни проекти можете да ја прегледувате наплатата и да поставувате ограничувања на трошењето.

Пристапот до контролната табла за користење на проектот зависи од вашата улога во организацијата и од поставките за видливост на контролната табла за користење. Самата улога сопственик на проект не ви дава пристап.

Ако не ја гледате контролната табла за користење на проектот, проверете дали видливоста е поставена на Видливо за сопствениците на организацијата.

Управување со просторот за складирање датотеки

Секој проект има квота од 100 GB за складирање датотеки. Ако ја надминете, може да се прикаже оваа грешка:

Ја надминавте вашата квота за складирање датотеки. Организациите се ограничени на 100 GB датотеки. Намалете ја големината на датотеката или контактирајте со поддршката.

Избришете ги датотеките што не ги користите за да ослободите простор. Можете да добиете список на зачуваните датотеки преку API за да ги најдете датотеките што повеќе не ви требаат.

Архивирање проект

Сопствениците на организацијата и на проектите можат да архивираат проекти од страницата Проекти или од поставките на поединечниот проект. Внесете го името на проектот кога ќе се побара потврда.

Архивирањето е трајно: архивиран проект не може да се врати.

За да ги видите архивираните проекти, отворете го јазичето Архивирани на страницата Проекти.

Проектите не можат да се избришат. OpenAI ја чува нивната историја за следење на користењето и наплатата.