Επισκόπηση

Το Agents API είναι διαθέσιμο σε έκδοση beta. Επιτρέπει στους προγραμματιστές να δημιουργούν εφαρμογές με έναν πράκτορα Codex υπό τη διαχείριση της OpenAI, ο οποίος μπορεί να εκτελεί εργασίες σε πολλά βήματα και να συνεχίζει στην ίδια συνεδρία.

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

Τι μπορεί να κάνει ένας πράκτορας;

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

Δείτε την επισκόπηση του Agents API για τις υποστηριζόμενες δυνατότητες και παραδείγματα.

Πώς μπορώ να ξεκινήσω;

1. Δημιουργήστε ένα κλειδί API εφαρμογής στο έργο σας στην πλατφόρμα της OpenAI. Εκχωρήστε τα δικαιώματα api.agents.read και api.agents.write για τις συνεδρίες, καθώς και το api.responses.write για αιτήματα προς το μοντέλο.

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

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

Κρατήστε το κλειδί API σας εκτός του sandbox του πράκτορα. Τα αιτήματα απαιτούν την κεφαλίδα OpenAI-Beta: agents=v1. Τα SDK της OpenAI προσθέτουν αυτόματα αυτή την κεφαλίδα.

Χρειάζεται ο πράκτοράς μου sandbox;

Επιλέξτε το περιβάλλον που ταιριάζει στην εργασία:

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

• Sandbox που φιλοξενείται από την OpenAI: Ο πράκτορας χρειάζεται να εκτελεί δέσμες ενεργειών ή να εργάζεται με αρχεία και θέλετε η OpenAI να διαχειρίζεται το sandbox του.

• Sandbox που φιλοξενείτε εσείς: Χρειάζεστε δική σας υποδομή, λογισμικό ή ιδιωτικό δίκτυο. Η εφαρμογή σας διαχειρίζεται τον κύκλο ζωής του περιβάλλοντος.

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

Πού μπορώ να ελέγξω μια συνεδρία;

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

Ο οδηγός παρατηρησιμότητας εξηγεί επίσης πώς να ελέγξετε την καταγεγραμμένη χρήση token.

Τι γίνεται αν διακοπεί η σύνδεση στη ροή συμβάντων;

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

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

Πώς χρεώνεται η χρήση;

Τα αιτήματα προς το μοντέλο χρεώνονται με τις τιμές API του επιλεγμένου μοντέλου. Για τα εργαλεία της OpenAI και τα sandbox που φιλοξενεί η OpenAI ισχύουν οι αντίστοιχες χρεώσεις εργαλείων και container.

Δείτε την τιμολόγηση API για τις τρέχουσες τιμές.

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

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

Το Agents API υποστηρίζει προς το παρόν τη γεωγραφική διαμονή δεδομένων μόνο στις Ηνωμένες Πολιτείες. Δεν υποστηρίζει τη μη διατήρηση δεδομένων, ακόμη και όταν χρησιμοποιείτε sandbox που φιλοξενείτε εσείς. Δείτε την τεκμηρίωση του Agents API για λεπτομέρειες σχετικά με τους ελέγχους δεδομένων.