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

Η κλήση λειτουργιών σάς επιτρέπει να συνδέετε μοντέλα της OpenAI με εξωτερικά εργαλεία και συστήματα. Αυτό είναι χρήσιμο σε πολλές περιπτώσεις, όπως για την παροχή δυνατοτήτων σε βοηθούς τεχνητής νοημοσύνης ή τη δημιουργία στενών ενοποιήσεων μεταξύ των εφαρμογών σας και των 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 (δείτε παρακάτω)