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

Τα έργα έχουν ως στόχο να παρέχουν στους πελάτες τη δυνατότητα να οργανώνουν την εργασία τους. Οι οργανισμοί μπορούν να διαχειρίζονται την πρόσβαση και τα όρια, να παρέχουν λογαριασμούς υπηρεσίας (μέσω του UI) και να παρακολουθούν τη χρήση σε σχέση με ένα περιορισμένο πεδίο εντός ενός έργου (π.χ. μοντέλα, δυνατότητες, νήματα, βοηθοί, fine-tuning, αποθήκευση κ.λπ.). Η δραστηριότητα χρήσης μπορεί να αναλύεται ανά έργο, ενώ οι χρήστες μπορούν να προβάλλουν τη χρέωση και να ορίζουν όρια δαπάνης ανά έργο.

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

Ποιος μπορεί να δημιουργήσει ένα έργο;

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

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

Για τους οργανισμούς που έχουν ενοποιημένο πρόγραμμα χρέωσης, οι υπο-οργανισμοί προσδιορίζονται ξεχωριστά. Δεν μπορούν να δημιουργηθούν έργα μέσα σε υπο-οργανισμούς.

Πώς λειτουργούν τα έργα;

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

Πώς δημιουργώ ένα έργο;

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

Καταχωρίστε όνομα, περιγραφή και ιστότοπο για το έργο σας και, στη συνέχεια, επιλέξτε Δημιουργία.

Πώς προσθέτω χρήστες σε ένα έργο;

Τα νέα μέλη ενός οργανισμού δεν προστίθενται αυτόματα στο «Προεπιλεγμένο έργο». Τα νέα μέλη μπορούν να προσκληθούν στο έργο είτε όταν προσκαλούνται στον οργανισμό (ενεργοποιώντας το πλαίσιο ελέγχου "Πρόσκληση στο προεπιλεγμένο έργο") είτε αφού αποδεχτούν την πρόσκληση στον οργανισμό.

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

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

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

Ποιοι είναι οι διαφορετικοί ρόλοι χρηστών σε οργανισμούς και έργα και ποια δικαιώματα περιλαμβάνουν;

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

Αν δεν είμαι κάτοχος στον οργανισμό, σε τι έχω πρόσβαση;

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

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

• Τα μέλη ενός έργου μπορούν να βλέπουν όλα τα υπόλοιπα μέλη του έργου και τους ρόλους τους (δηλαδή Κάτοχος ή Μέλος).

Πώς ενημερώνω τον ρόλο ενός χρήστη σε ένα έργο ή πώς τον αφαιρώ από το έργο;

Μόνο ο κάτοχος ενός έργου μπορεί να ενημερώσει τον ρόλο ενός χρήστη στο έργο ή να αφαιρέσει έναν χρήστη από αυτό. Για περισσότερες πληροφορίες, ανατρέξτε στους ρόλους και τις άδειες.

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

Τι είναι ένας λογαριασμός υπηρεσίας και σε τι διαφέρει από έναν κανονικό λογαριασμό χρήστη;

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

Προσθήκη μέλους σε έργο

Αν κάνετε κλικ στο κουμπί + Προσθήκη μέλους, θα εμφανιστεί μια λίστα με τους χρήστες του οργανισμού σας που έχουν τον ρόλο Αναγνώστης. Αν θέλετε να προσθέσετε έναν χρήστη που δεν ανήκει στον οργανισμό σας, θα πρέπει πρώτα να τον προσθέσετε στον οργανισμό (μπορείτε να αφήσετε μη επιλεγμένο το πλαίσιο «Προσθήκη στο προεπιλεγμένο έργο», αν δεν θέλετε να του παραχωρήσετε ευρύτερη πρόσβαση). Η λίστα δεν περιλαμβάνει λογαριασμούς υπηρεσίας. Σε αυτό το βήμα μπορείτε να επιλέξετε αν ο ρόλος του θα είναι Κάτοχος ή Μέλος:

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

Πώς να δημιουργήσετε έναν λογαριασμό υπηρεσίας για ένα έργο

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

Στη συνέχεια, μεταβείτε στις ρυθμίσεις οργανισμού -> Έργο -> Μέλη -> και κάντε κλικ στην επιλογή + Λογαριασμός υπηρεσίας:

Ονομασία του λογαριασμού υπηρεσίας

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

Αποθήκευση του κλειδιού API του λογαριασμού υπηρεσίας

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

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

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

Οι λογαριασμοί υπηρεσίας διαχειρίζονται όπως οι κανονικοί λογαριασμοί. Από το μενού Οργανισμός -> Μέλη μπορείτε να Καταργήσετε έναν λογαριασμό υπηρεσίας ή να ενημερώσετε τον ρόλο:

Πώς διαχειρίζομαι τα κλειδιά API στα έργα του οργανισμού μου;

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

Για να δημιουργήσετε ένα νέο μυστικό κλειδί, επιλέξτε + Δημιουργία νέου μυστικού κλειδιού. Μπορείτε επίσης να επιλέξετε το εικονίδιο Επεξεργασίας δίπλα σε ένα μυστικό κλειδί για να επεξεργαστείτε τις άδειές του.

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

Διατίθενται τρία επίπεδα αδειών: Όλα, Περιορισμένη πρόσβαση και Μόνο για ανάγνωση.

• Όλα — Παρέχονται πλήρεις άδειες στο μυστικό κλειδί. Αυτή είναι η προεπιλεγμένη ρύθμιση.

• Περιορισμένη πρόσβαση — Επιτρέπει στον χρήστη να ορίσει άδειες Καμία, Ανάγνωση και Εγγραφή για κάθε τελικό σημείο.

• Για παράδειγμα, δημιουργείτε ένα κλειδί API που συγκεκριμένα δεν έχει άδεια ανάγνωσης ή εγγραφής στο τελικό σημείο /v1/assistants:

• Μόνο για ανάγνωση — Παρέχονται άδειες ανάγνωσης για όλα τα τελικά σημεία.

Πώς διαχειρίζεται η πρόσβαση για χρήστες που ανήκουν σε πολλά έργα ή οργανισμούς;

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

Πώς ορίζω και διαχειρίζομαι όρια ρυθμού για τα έργα του οργανισμού μου;

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

Στις ρυθμίσεις οργανισμού, κάντε κλικ στο έργο που θέλετε να ενημερώσετε και επιλέξτε Όρια στην ενότητα Έργο της λίστας πλοήγησης. Μπορείτε να ενημερώσετε τη Χρήση μοντέλου σε αυτήν τη σελίδα.

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

Πώς ορίζω και διαχειρίζομαι τα όρια δαπανών για τα έργα του οργανισμού μου;

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

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

Ο ορισμός ενός μηνιαίου ορίου δαπανών σάς επιτρέπει να καθορίσετε ενδεικτικά όρια δαπανών για το έργο σας. Όταν η χρήση υπερβαίνει αυτό το όριο μέσα σε έναν ημερολογιακό μήνα (UTC), η επεξεργασία των αιτημάτων API συνεχίζεται χωρίς διακοπή. Αυτή η δυνατότητα έχει σχεδιαστεί για να σας βοηθά να παρακολουθείτε τη χρήση μέσω ειδοποιήσεων για τα όρια δαπανών, αλλά δεν επιβάλλει ανώτατο όριο στις δαπάνες. Όταν δημιουργείται ένα όριο δαπανών έργου, από προεπιλογή δημιουργείται μια ειδοποίηση στο όριο του 100%. Μπορείτε να ορίσετε πρόσθετες ειδοποιήσεις σε διαφορετικά όρια κάνοντας κλικ στην επιλογή Προσθήκη ειδοποίησης.

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

Πώς ορίζω όρια δαπάνης για τον οργανισμό ή το έργο μου;

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

Πώς διαγράφω ή αρχειοθετώ ένα έργο;

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

Μπορείτε να δείτε μια λίστα με όλα τα αρχειοθετημένα έργα από την καρτέλα «Αρχειοθετημένα» στην ίδια σελίδα λίστας έργων.

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

Υπάρχει όριο στον αριθμό των έργων που μπορώ να έχω στον οργανισμό μου;

Οι οργανισμοί μπορούν να δημιουργήσουν έως 2.000 έργα από προεπιλογή.

Μπορούν οι πόροι να κοινοποιηθούν μεταξύ έργων;

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

Ποιο είναι το όριο αποθήκευσης αρχείων ανά έργο;

Η OpenAI υποστηρίζει επί του παρόντος όριο αποθήκευσης αρχείων 100 GB ανά έργο.

Αν ξεπεραστεί αυτό το όριο, θα εμφανιστεί το ακόλουθο σφάλμα:

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

Είμαι κάτοχος έργου. Γιατί δεν μπορώ να δω τον Πίνακα χρήσης του έργου μου;

Η ορατότητα του Πίνακα χρήσης ενός έργου δεν σχετίζεται με τον ρόλο ενός χρήστη στο έργο. Αντίθετα, καθορίζεται από τον ρόλο σας στον οργανισμό και από τις ρυθμίσεις στη διεύθυνση https://platform.openai.com/settings/organization/data-controls/visibility

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