Από τις 11 Μαρτίου 2025, κυκλοφορήσαμε τα δομικά στοιχεία της νέας μας πλατφόρμας πρακτόρων. Για λεπτομέρειες, δείτε την τεκμηρίωση API για το Responses API, εργαλεία όπως τα Web Search, File Search και Computer Use, καθώς και το Agents SDK με Tracing. Με βάση τα σχόλιά σας για το Assistants API beta, έχουμε ενσωματώσει βασικές βελτιώσεις στο Responses API. Αφού επιτύχουμε πλήρη ισοδυναμία λειτουργιών, θα ανακοινώσουμε ένα πλάνο κατάργησης του Assistants API αργότερα φέτος, με στοχευμένη ημερομηνία απόσυρσης το πρώτο εξάμηνο του 2026.
Συχνές ερωτήσεις
Τι είναι το Assistants API;
Το Assistants API επιτρέπει στους προγραμματιστές να δημιουργούν εύκολα ισχυρούς βοηθούς τεχνητής νοημοσύνης μέσα στις εφαρμογές τους. Αυτό το API καταργεί την ανάγκη διαχείρισης του ιστορικού συνομιλιών και παρέχει πρόσβαση σε εργαλεία που φιλοξενούνται από την OpenAI, όπως το Code Interpreter και το File Search. Το API υποστηρίζει επίσης βελτιωμένη κλήση λειτουργιών για εργαλεία τρίτων.
Μπορώ να συνεχίσω να χρησιμοποιώ την έκδοση beta v1 του Assistants API;
Όχι. Από τις 18 Δεκεμβρίου 2024, οι χρήστες δεν έχουν πλέον πρόσβαση στην έκδοση v1 της έκδοσης beta του Assistants API. Προς το παρόν υποστηρίζουμε μόνο την έκδοση v2. Συμβουλευτείτε αυτόν τον οδηγό μετεγκατάστασης για να μετατρέψετε τις κλήσεις API από v1 σε v2.
Πώς αποκτώ πρόσβαση σε αυτό;
Το Assistants API είναι διαθέσιμο σε οποιονδήποτε διαθέτει λογαριασμό OpenAI API, αλλά έχει καταργηθεί και θα αφαιρεθεί τον Αύγουστο του 2026. Για νέα έργα, χρησιμοποιήστε αντ’ αυτού το Responses API. Αν χρησιμοποιείτε ήδη το Assistants API, προγραμματίστε τη μετεγκατάστασή σας στο Responses API. Μπορείτε ακόμη να αποκτάτε πρόσβαση σε υπάρχοντες assistants στο Assistants Playground όσο το API παραμένει διαθέσιμο.
Τι είναι ένας βοηθός;
Ένας βοηθός είναι ένα σύστημα τεχνητής νοημοσύνης σχεδιασμένο για συγκεκριμένο σκοπό, το οποίο χρησιμοποιεί τα μοντέλα της OpenAI και μπορεί να έχει πρόσβαση σε αρχεία, να διατηρεί νήματα συνομιλίας και να καλεί εργαλεία.
Τι είναι ένα νήμα;
Ένα νήμα είναι μια συνεδρία συνομιλίας μεταξύ ενός βοηθού και ενός χρήστη. Τα νήματα απλοποιούν την ανάπτυξη εφαρμογών, αποθηκεύοντας το ιστορικό μηνυμάτων και περικόπτοντάς το όταν η συνομιλία υπερβαίνει το όριο μήκους του πλαισίου του μοντέλου.
Τι είναι το εργαλείο File Search;
Το εργαλείο file_search εφαρμόζει εξαρχής διάφορες βέλτιστες πρακτικές ανάκτησης, ώστε να σας βοηθά να εξάγετε τα κατάλληλα δεδομένα από τα αρχεία σας και να εμπλουτίζετε τις απαντήσεις του μοντέλου.
Από προεπιλογή, το εργαλείο file_search χρησιμοποιεί τις ακόλουθες ρυθμίσεις:
Μέγεθος τμήματος: 800 token
Επικάλυψη τμημάτων: 400 token
Μοντέλο διανυσματικών αναπαραστάσεων: text-embedding-3-large με 256 διαστάσεις
Μέγιστος αριθμός τμημάτων που προστίθενται στο πλαίσιο: 20
Ποιοι είναι οι περιορισμοί για τη μεταφόρτωση αρχείων;
Οι περιορισμοί για τη μεταφόρτωση αρχείων είναι οι εξής:
512 MB ανά αρχείο
5 εκατ. token ανά αρχείο
10.000 αρχεία ανά αποθήκη διανυσμάτων
1 αποθήκη διανυσμάτων ανά βοηθό
1 αποθήκη διανυσμάτων ανά νήμα
Το συνολικό όριο αποθήκευσης για κάθε έργο σε έναν οργανισμό είναι 100 GB.
Ποιοι είναι οι περιορισμοί του εργαλείου File Search;
Υπάρχουν ορισμένοι γνωστοί περιορισμοί, τους οποίους εργαζόμαστε για να άρουμε τους επόμενους μήνες:
Προς το παρόν, δεν υπάρχει τρόπος τροποποίησης των ρυθμίσεων κατάτμησης, διανυσματικής αναπαράστασης ή ανάκτησης.
Δεν υποστηρίζεται η ανάλυση εικόνων μέσα σε έγγραφα.
Δεν υποστηρίζεται η ανάκτηση από δομημένες μορφές αρχείων (όπως αρχεία .csv ή .jsonl). Δείτε τους υποστηριζόμενους τύπους αρχείων.
Ποια είναι τα όρια ρυθμού αιτημάτων για το Assistants API;
Τα όρια ρυθμού αιτημάτων για το Assistants API δεν εξαρτώνται από τη βαθμίδα χρήσης και το μοντέλο. Αντίθετα, υπάρχουν προεπιλεγμένα όρια ανά τύπο αιτήματος, με ορισμένες εξαιρέσεις:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 αιτήματα ανά λεπτό
Πώς χρεώνεται το Code Interpreter στο API;
Το Code Interpreter χρεώνεται με 0,03 $ ανά συνεδρία. Αν ο βοηθός σας καλέσει το Code Interpreter ταυτόχρονα σε δύο διαφορετικά νήματα, θα δημιουργηθούν δύο συνεδρίες Code Interpreter (2 * 0,03 $). Κάθε συνεδρία παραμένει ενεργή από προεπιλογή για μία ώρα. Αυτό σημαίνει ότι θα χρεωθείτε μόνο μία φορά αν ο χρήστης σας συνεχίσει να δίνει οδηγίες στο Code Interpreter στο ίδιο νήμα για έως και μία ώρα.
Πώς χρεώνεται το File Search στο API;
Το File Search χρεώνεται με 0,10 $/GB χώρου αποθήκευσης διανυσμάτων ανά ημέρα (το πρώτο GB αποθήκευσης είναι δωρεάν). Το μέγεθος της αποθήκης διανυσμάτων υπολογίζεται μετά την ανάλυση του αρχείου σας, την κατάτμησή του και τη μετατροπή του σε διανυσματικές αναπαραστάσεις.
Οι αποθήκες διανυσμάτων που δημιουργήθηκαν πριν από τις 17 Απριλίου 2024 θα παραμείνουν δωρεάν έως το τέλος του 2024. Έπειτα, είτε:
Θα χρεώνονται με τις ισχύουσες τιμές (επί του παρόντος 0,10 $/GB/ημέρα), εφόσον έχουν χρησιμοποιηθεί τουλάχιστον μία φορά σε ένα Run που δημιουργήθηκε μετά τις 17 Απριλίου 2024.
Θα διαγραφούν, αν δεν έχουν χρησιμοποιηθεί σε κανένα Run μεταξύ 17 Απριλίου 2024 και 31 Δεκεμβρίου 2024. Έτσι, δεν θα χρεωθείτε για αποθήκες διανυσμάτων που ενδέχεται να δημιουργήσατε πριν ανακοινωθεί αυτή η αλλαγή τιμολόγησης, αλλά δεν χρησιμοποιήσατε ποτέ.
Υπάρχει όριο στο πόσους assistants μπορώ να δημιουργήσω;
Δεν υπάρχει όριο στο πόσους assistants μπορεί να δημιουργήσει ένας οργανισμός.
Υποστηρίζεται η ροή δεδομένων στο API;
Ναι, η ροή δεδομένων υποστηρίζεται στο Assistants API.
Είναι διαθέσιμη η λειτουργία JSON στο Assistants API;
Ναι, η λειτουργία JSON είναι διαθέσιμη στο Assistants API μέσω της παραμέτρου response_format στα αντικείμενα Assistants ή Run.
Θα διαχειρίζεται το Assistants API και αιτήματα για κλήσεις λειτουργιών τρίτων;
Όχι. Παρότι η κλήση λειτουργιών επιτρέπει στο μοντέλο να επιλέγει εργαλεία και να μορφοποιεί αιτήματα για αυτά, η OpenAI δεν διαχειρίζεται την εκτέλεση κλήσεων σε εργαλεία τρίτων.
Πώς γίνεται η διαχείριση των δεδομένων που στέλνω στην OpenAI;
Όπως και στην υπόλοιπη πλατφόρμα μας, τα δεδομένα και τα αρχεία που αποστέλλονται στο OpenAI API δεν χρησιμοποιούνται ποτέ για την εκπαίδευση των μοντέλων μας και μπορείτε να διαγράψετε τα δεδομένα σας όποτε χρειαστεί. Τα δεδομένα που μεταφορτώνονται στο Assistants API αποθηκεύονται επ’ αόριστον, μέχρι κάποιος χρήστης να τα διαγράψει χειροκίνητα.
Είναι διαθέσιμο το DALL-E μέσω του Assistants API;
Προς το παρόν, το DALL-E δεν είναι διαθέσιμο.
Υπάρχει UI για το Assistants API;
Μπορείτε να δοκιμάσετε το Playground για το Assistants API. Βεβαιωθείτε ότι βρίσκεστε στην προβολή Assistants στην αριστερή πλαϊνή γραμμή και ότι χρησιμοποιείτε ένα μοντέλο συμβατό με τα εργαλεία που θέλετε να ενεργοποιήσετε.
Ποιο είναι το όριο χαρακτήρων για τις οδηγίες του βοηθού στο Assistants API;
Το πεδίο οδηγιών του βοηθού έχει μέγιστο μήκος 256.000 χαρακτήρων.
Λαμβάνω ένα μήνυμα σφάλματος όπως «Παρουσιάστηκε σφάλμα στον διακομιστή κατά την επεξεργασία του αιτήματός σας. Λυπούμαστε γι’ αυτό! Μπορείτε να υποβάλετε ξανά το αίτημά σας ή να επικοινωνήσετε μαζί μας μέσω του κέντρου βοήθειας στη διεύθυνση help.openai.com, αν το σφάλμα επιμένει. » Τι πρέπει να κάνω;
Αν λαμβάνετε αυτό το σφάλμα, ενδέχεται η προτροπή σας να μην έχει διαμορφωθεί σωστά. Αν το αίτημα εξακολουθεί να αποτυγχάνει παρά τις επαναλαμβανόμενες προσπάθειες, μπορείτε να δοκιμάσετε τα εξής:
αναδιαρθρώστε την προτροπή σας ώστε τυχόν εντολές που μοιάζουν με συναρτήσεις να αντιμετωπίζονται ως συναρτήσεις
προσθέστε κάθε εντολή της προτροπής σας ως συνάρτηση στο tools
Γιατί το εργαλείο File Search δεν λειτουργεί καλά;
Όταν χρησιμοποιείτε το εργαλείο File Search, συνιστούμε να ορίζετε την τιμή της παραμέτρου max_prompt_tokens σε τουλάχιστον 20.000. Για μεγαλύτερες συνομιλίες ή πολλές αλληλεπιδράσεις με το File Search, εξετάστε το ενδεχόμενο να αυξήσετε αυτό το όριο σε 50.000 ή, ιδανικά, να καταργήσετε εντελώς τα όρια max_prompt_tokens για να έχετε την καλύτερη δυνατή ποιότητα αποτελεσμάτων.
Πώς μπορώ να στείλω σχόλια;
Θα χαρούμε να ακούσουμε τα σχόλιά σας στο Φόρουμ προγραμματιστών, μέσω του Κέντρου Βοήθειας στη διεύθυνση help.openai.com ή στο Twitter, στο @OpenAIDevs.