Διαχείριση έργων στην πλατφόρμα API

Επισκόπηση

Τα έργα οργανώνουν την εργασία μέσα σε έναν οργανισμό API. Χρησιμοποιήστε τα για να διαχειρίζεστε την πρόσβαση, να διαμορφώνετε όρια μοντέλων και όρια ρυθμού, να δημιουργείτε λογαριασμούς υπηρεσίας και να παρακολουθείτε τη χρήση, τη χρέωση και τα όρια δαπανών για ένα καθορισμένο σύνολο πόρων, όπως μοντέλα, δυνατότητες, νήματα, βοηθούς, λεπτομερή ρύθμιση και αποθηκευτικό χώρο.

Οι ιδιοκτήτες οργανισμού μπορούν να βλέπουν όλα τα ενεργά και αρχειοθετημένα έργα στη σελίδα Έργα.

Πριν ξεκινήσετε

Για να δημιουργήσετε ένα έργο, χρειάζεστε τον ρόλο ιδιοκτήτη οργανισμού. Από προεπιλογή, οι οργανισμοί μπορούν να δημιουργήσουν έως και 2.000 έργα.

Αν ο οργανισμός σας χρησιμοποιεί ενοποιημένη χρέωση, οι υποοργανισμοί εμφανίζονται ξεχωριστά στον επιλογέα οργανισμού. Δεν μπορείτε να δημιουργήσετε έργα μέσα σε έναν υποοργανισμό.

Για να αλλάξετε οργανισμό, ανοίξτε τον επιλογέα οργανισμού και επιλέξτε τον οργανισμό που θέλετε να χρησιμοποιήσετε.

Προεπιλεγμένο έργο

Κάθε οργανισμός περιλαμβάνει ένα Προεπιλεγμένο έργο, το οποίο δεν μπορεί να διαγραφεί. Κληρονομεί το σύνολο των ρυθμίσεων του οργανισμού. Μπορείτε να διαμορφώσετε τα όρια ρυθμού, τα δικαιώματα εικονικών μοντέλων και τα όρια δαπανών του.

Δεν μπορείτε να προσθέσετε μέλη ή λογαριασμούς υπηρεσίας απευθείας στο Προεπιλεγμένο έργο. Μπορείτε να δώσετε πρόσβαση στο Προεπιλεγμένο έργο όταν προσκαλείτε κάποιον στον οργανισμό, ακολουθώντας τα βήματα πρόσκλησης στον οργανισμό που περιγράφονται σε αυτό το άρθρο.

Δημιουργία έργου

1. Ανοίξτε τον επιλογέα έργου και επιλέξτε Δημιουργία έργου.

2. Εισαγάγετε όνομα, περιγραφή και ιστότοπο για το έργο σας.

3. Επιλέξτε Δημιουργία.

Οι ιδιοκτήτες του οργανισμού προστίθενται αυτόματα ως ιδιοκτήτες στα νέα έργα.

Κατανόηση ρόλων και πρόσβασης

Ο πίνακας συνοψίζει τους ρόλους ιδιοκτήτη και αναγνώστη οργανισμού, καθώς και τους ρόλους ιδιοκτήτη και μέλους έργου που χρησιμοποιούνται σε αυτά τα βήματα. Τα μέλη έργου έχουν παρόμοια δικαιώματα με τους αναγνώστες οργανισμού.

Για λεπτομέρειες σχετικά με τους ρόλους οργανισμού, δείτε τους ρόλους οργανισμού. Για πρόσθετους ρόλους, προσαρμοσμένους ρόλους και όλα τα δικαιώματα, δείτε τον οδηγό ρόλων και δικαιωμάτων API.

Ορατότητα έργων

Με αυτούς τους τυπικούς ρόλους, οι χρήστες που δεν είναι ιδιοκτήτες οργανισμού μπορούν να βλέπουν μόνο τα έργα στα οποία ανήκουν. Οι ιδιοκτήτες οργανισμού μπορούν να βλέπουν όλα τα έργα, τα μέλη και τα κλειδιά API σε επίπεδο έργου και έχουν πρόσβαση στη σελίδα Έργα.

Τα μέλη ενός έργου μπορούν να βλέπουν τα υπόλοιπα μέλη του έργου τους και τον ρόλο κάθε μέλους. Μόνο τα μέλη του έργου και οι ιδιοκτήτες του οργανισμού μπορούν να βλέπουν τα μοντέλα που έχουν υποβληθεί σε λεπτομερή ρύθμιση, τα νήματα βοηθών και τα αρχεία που δημιουργήθηκαν ή προστέθηκαν σε αυτό το έργο.

Μπορείτε να ανήκετε σε όσα έργα χρειάζεστε. Ένα προσωπικό κλειδί API που δημιουργείται μέσα σε ένα έργο περιορίζεται σε αυτό το έργο και στους πόρους του.

Όρια πρόσβασης στους πόρους

Τα αρχεία, οι βοηθοί, ο αποθηκευτικός χώρος και τα νήματα περιορίζονται στο έργο στο οποίο ανήκουν. Μέλη εκτός του έργου που δεν είναι διαχειριστές δεν έχουν πρόσβαση στους πόρους του, ενώ οι πόροι δεν μπορούν να μετακινηθούν μεταξύ έργων.

Εξαίρεση αποτελούν τα μοντέλα που έχουν υποβληθεί σε λεπτομερή ρύθμιση στο Προεπιλεγμένο έργο: είναι προσβάσιμα και από άλλα έργα.

Διαχείριση μελών έργου

Πρόσκληση κάποιου στον οργανισμό σας

Όταν προσκαλείτε κάποιον στον οργανισμό, μπορείτε να του δώσετε πρόσβαση στο Προεπιλεγμένο έργο, επιλέγοντας την αντίστοιχη επιλογή στη φόρμα πρόσκλησης. Αφήστε την επιλογή ανενεργή αν δεν θέλετε να παραχωρήσετε πρόσβαση στο Προεπιλεγμένο έργο. Τα νέα μέλη του οργανισμού δεν προστίθενται αυτόματα στο Προεπιλεγμένο έργο.

Δεν χρειάζεται να δημιουργήσετε άλλο έργο πριν προσκαλέσετε κάποιον. Μπορείτε επίσης να προσθέσετε κάποιον σε ένα έργο αφού αποδεχτεί την πρόσκληση στον οργανισμό.

Οι προσκλήσεις που αποστέλλονται μέσω του Admin API ακολουθούν τους κανόνες για το τελικό σημείο /organization/invites.

Προσθήκη μέλους του οργανισμού σε έργο

Οι ιδιοκτήτες οργανισμών και έργων μπορούν να προσθέτουν μέλη:

1. Μεταβείτε στις ρυθμίσεις οργανισμού.

2. Επιλέξτε το έργο και ανοίξτε την ενότητα Μέλη.

3. Επιλέξτε + Προσθήκη μέλους.

4. Επιλέξτε τον χρήστη και εκχωρήστε τον ρόλο Μέλος ή Ιδιοκτήτης.

Η λίστα χρηστών εμφανίζει τους χρήστες του οργανισμού με τον ρόλο Αναγνώστης. Δεν περιλαμβάνει λογαριασμούς υπηρεσίας.

Αν μια πρόσκληση αποτύχει στο περιβάλλον χρήστη ή στο Admin 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% του ορίου. Επιλέξτε Προσθήκη ειδοποίησης για να προσθέσετε ειδοποιήσεις σε άλλα επίπεδα δαπανών.

Οι ιδιοκτήτες οργανισμών και έργων λαμβάνουν ειδοποιήσεις για τις δαπάνες των έργων. Μπορείτε να προσθέσετε άλλους παραλήπτες email στις ρυθμίσεις ειδοποιήσεων.

Για τα ισχύοντα βήματα διαμόρφωσης και τον τρόπο επιβολής των ορίων, δείτε τον οδηγό ορίων δαπανών.

Προβολή χρήσης και χρέωσης

Η δραστηριότητα χρήσης μπορεί να αναλυθεί ανά έργο και μπορείτε να βλέπετε τη χρέωση και να ορίζετε όρια δαπανών για μεμονωμένα έργα.

Η πρόσβαση στον Πίνακα ελέγχου χρήσης ενός έργου εξαρτάται από τον ρόλο σας στον οργανισμό και από τις ρυθμίσεις ορατότητας του Πίνακα ελέγχου χρήσης. Η ιδιότητα του ιδιοκτήτη έργου δεν παρέχει από μόνη της πρόσβαση.

Αν δεν μπορείτε να δείτε τον Πίνακα ελέγχου χρήσης ενός έργου, ελέγξτε αν η ορατότητα έχει οριστεί σε Ορατός στους ιδιοκτήτες του οργανισμού.

Διαχείριση αποθηκευτικού χώρου αρχείων

Κάθε έργο έχει όριο αποθήκευσης αρχείων 100 GB. Αν το υπερβείτε, ενδέχεται να εμφανιστεί αυτό το σφάλμα:

Έχετε υπερβεί το όριο αποθήκευσης αρχείων. Οι οργανισμοί έχουν όριο 100 GB για αρχεία. Μειώστε το μέγεθος του αρχείου ή επικοινωνήστε με την υποστήριξη.

Διαγράψτε αρχεία που δεν χρησιμοποιείτε για να ελευθερώσετε αποθηκευτικό χώρο. Μπορείτε να λάβετε μια λίστα αποθηκευμένων αρχείων μέσω του API για να εντοπίσετε αρχεία που δεν χρειάζεστε πλέον.

Αρχειοθέτηση έργου

Οι ιδιοκτήτες οργανισμών και έργων μπορούν να αρχειοθετούν έργα από τη σελίδα Έργα ή από τις ρυθμίσεις του αντίστοιχου έργου. Εισαγάγετε το όνομα του έργου όταν σας ζητηθεί, για επιβεβαίωση.

Η αρχειοθέτηση είναι οριστική: ένα αρχειοθετημένο έργο δεν μπορεί να επαναφερθεί.

Για να δείτε τα αρχειοθετημένα έργα, ανοίξτε την καρτέλα Αρχειοθετημένα στη σελίδα Έργα.

Τα έργα δεν μπορούν να διαγραφούν. Η OpenAI διατηρεί το ιστορικό τους για την παρακολούθηση της χρήσης και της χρέωσης.