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

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

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

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

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

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

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

• Επιτρέποντας στους βοηθούς να ανακτούν δεδομένα:

  • ένας βοηθός TN πρέπει να ανακτήσει τα πιο πρόσφατα δεδομένα πελατών από ένα εσωτερικό σύστημα όταν ένας χρήστης ρωτά «ποιες είναι οι πρόσφατες παραγγελίες μου;» πριν μπορέσει να δημιουργήσει την απάντηση προς τον χρήστη

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

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

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

  • ένας βοηθός διδασκαλίας μαθηματικών πρέπει να εκτελέσει έναν μαθηματικό υπολογισμό.

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

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

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

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

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

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

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

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

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

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