Κλήση λειτουργιών στο OpenAI API

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

Μάθετε περισσότερα στον οδηγό προγραμματιστών για την κλήση λειτουργιών.

Τον Ιούνιο του 2024, παρουσιάσαμε τα δομημένα αποτελέσματα. Όταν τα ενεργοποιείτε ορίζοντας strict: true στον ορισμό της λειτουργίας σας, τα δομημένα αποτελέσματα εγγυώνται ότι τα ορίσματα που δημιουργούνται από το μοντέλο για μια κλήση λειτουργίας ταιριάζουν ακριβώς με το JSON Schema που δώσατε στον ορισμό της λειτουργίας.

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

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

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

• Δυνατότητα στους βοηθούς να ανακτούν δεδομένα:

• Δυνατότητα στους βοηθούς να εκτελούν ενέργειες:

• Δυνατότητα στους βοηθούς να εκτελούν υπολογισμούς:

• Δημιουργία πλούσιων ροών εργασίας:

• μια διοχέτευση εξαγωγής δεδομένων που ανακτά ακατέργαστο κείμενο, στη συνέχεια το μετατρέπει σε δομημένα δεδομένα και το αποθηκεύει σε μια βάση δεδομένων.

Η κλήση λειτουργιών υποστηρίζεται στο Responses API, το οποίο ενοποιεί δυνατότητες που προηγουμένως ήταν κατανεμημένες μεταξύ του Chat Completions API και του Assistants API.

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

Όταν η λειτουργία JSON είναι ενεργοποιημένη, διασφαλίζεται ότι το αποτέλεσμα του μοντέλου είναι έγκυρο JSON, εκτός από ορισμένες οριακές περιπτώσεις που πρέπει να εντοπίζετε και να χειρίζεστε κατάλληλα.

Για να ζητήσετε τη λειτουργία JSON με το Chat Completions API, ορίστε το response_format σε { "type": "json_object" } στα υποστηριζόμενα μοντέλα. Με το Responses API, ορίστε το text.format σε { "type": "json_object" }, για παράδειγμα text: { "format": { "type": "json_object" } }, όπου ισχύει. Σε οποιοδήποτε από τα δύο API, η λειτουργία JSON λειτουργεί μόνο όταν πληρούνται οι προϋποθέσεις μοντέλου/μηνύματος/εργαλείου (για παράδειγμα, το μοντέλο υποστηρίζει json_object, η συνομιλία περιλαμβάνει οδηγίες για παραγωγή JSON και τυχόν περιορισμοί εργαλείων είναι συμβατοί). Τουλάχιστον ένα μήνυμα αιτήματος ή μήνυμα εισόδου στο ενεργό περιβάλλον εισόδου πρέπει να περιέχει json σε μορφή χωρίς διάκριση πεζών-κεφαλαίων, όπως JSON, json ή Json· διαφορετικά, το API επιστρέφει σφάλμα. Στο Responses, το πεδίο οδηγιών ανώτατου επιπέδου από μόνο του δεν ικανοποιεί αυτήν την επικύρωση. Όταν χρησιμοποιείται κλήση λειτουργιών σε συμβατά μοντέλα/διαδρομές, οι περιορισμοί JSON εφαρμόζονται αυτόματα στα ορίσματα κλήσης λειτουργίας· ασύμβατα μοντέλα ή συνδυασμοί εργαλείου/μορφής απόκρισης μπορεί να απορριφθούν ή να μη χρησιμοποιήσουν δειγματοληψία με περιορισμούς JSON.

Σημαντικές σημειώσεις:

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

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

• Η εφαρμογή σας πρέπει να εντοπίζει και να χειρίζεται τις οριακές περιπτώσεις που μπορεί να έχουν ως αποτέλεσμα η έξοδος του μοντέλου να μην είναι ένα πλήρες αντικείμενο JSON (δείτε παρακάτω)