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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Τα μέλη ενός έργου μπορούν να δουν ποια είναι όλα τα άλλα μέλη αυτού του έργου και τους ρόλους τους (δηλ. Owner ή Member).

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

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

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

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

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

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

Αν κάνετε κλικ στο κουμπί + Add member, θα δείτε μια λίστα χρηστών στον οργανισμό σας με τον ρόλο Reader. Αν θέλετε να προσθέσετε χρήστη που δεν ανήκει αυτήν τη στιγμή στον οργανισμό σας, θα πρέπει πρώτα να τον προσθέσετε στον οργανισμό (μπορείτε να αφήσετε το πλαίσιο επιλογής 'Add to Default Project" μη επιλεγμένο αν δεν θέλετε να δώσετε σε αυτούς τους χρήστες ευρύτερη πρόσβαση). Αυτή η λίστα δεν θα περιλαμβάνει λογαριασμούς υπηρεσίας. Κατά τη διάρκεια αυτού του βήματος μπορείτε να επιλέξετε αν ο ρόλος τους θα είναι Owner ή Member:

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

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

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

Έπειτα μεταβείτε στις ρυθμίσεις οργανισμού -> Project -> Members -> κάντε κλικ στο + Service account:

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

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

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

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

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

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

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

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

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

Για να δημιουργήσετε νέο μυστικό κλειδί, επιλέξτε + Create new secret key. Μπορείτε επίσης να επιλέξετε το εικονίδιο Edit δίπλα σε ένα μυστικό κλειδί για να επεξεργαστείτε τα δικαιώματά του.

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

Υπάρχουν τρία επίπεδα δικαιωμάτων: All, Restricted και Read Only.

• All — Ορίζονται πλήρη δικαιώματα για το μυστικό κλειδί. Αυτή είναι η προεπιλεγμένη ρύθμιση.

• Restricted — Επιτρέπει στον χρήστη να ορίσει δικαιώματα None, Read και Write για κάθε τελικό σημείο.

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

    

• Read Only — Ορίζονται δικαιώματα ανάγνωσης για όλα τα τελικά σημεία.

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

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

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

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

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

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

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

Μόνο οι Owners ενός οργανισμού και οι Owners ενός έργου μπορούν να ορίζουν και να διαχειρίζονται προϋπολογισμούς έργου. Ανατρέξτε στους ρόλους και τα δικαιώματα για περισσότερες πληροφορίες. Για να αλλάξετε τα όρια σε επίπεδο οργανισμού, στις ρυθμίσεις οργανισμού, κάντε κλικ στο Limits, και μετακινηθείτε προς τα κάτω στο Usage limits.

Για να ορίσετε τα όρια του έργου σας, στις ρυθμίσεις οργανισμού, κάντε κλικ στο έργο που θέλετε να ενημερώσετε και επιλέξτε Limits. Μπορείτε να ενημερώσετε τα Monthly budget, Notification threshold και Model Usage.

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

Σημειώστε ότι οι owner(s) του οργανισμού και οι owner(s) του έργου θα λαμβάνουν πάντα αυτά τα μηνύματα και αυτό δεν μπορεί να προσαρμοστεί.

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

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

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

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

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

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

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

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

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

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

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

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

Είμαι owner έργου, γιατί δεν μπορώ να δω το Usage Dashboard για το έργο μου;

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

Αν δεν μπορείτε να δείτε Usage Dashboard, αυτή η ρύθμιση πιθανότατα είναι ορισμένη σε "Visible to organization owners".