Μη υποστηριζόμενοι τύποι και περιορισμοί
Σε αυτήν τη σελίδα
Τι δεν μπορούν να κάνουν τα σχήματα
Η κατανόηση των ορίων των δομημένων εξόδων είναι εξίσου σημαντική με την κατάκτηση των δυνατοτήτων τους. Το API του Grok δεν υποστηρίζει συγκεκριμένους περιορισμούς του JSON Schema. Η προσπάθεια χρήσης τους θα προκαλέσει σφάλμα ή απρόβλεπτη συμπεριφορά.
Οι τρεις κύριοι περιορισμοί
allOf — η σύνθεση δεν επιτρέπεται
Στο JSON Schema, η λέξη-κλειδί allOf συνδυάζει πολλαπλά υπο-σχήματα που ένα αντικείμενο πρέπει να ικανοποιεί ταυτόχρονα. Το API του Grok δεν υποστηρίζει αυτή τη λειτουργία.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Εναλλακτική λύση: χρησιμοποιήστε ένα μοναδικό αντικείμενο με όλες τις ιδιότητες:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — χωρίς περιορισμούς μήκους συμβολοσειράς
Δεν μπορείτε να αναγκάσετε το μοντέλο να παράγει μια συμβολοσειρά με ελάχιστο ή μέγιστο μήκος.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Εναλλακτική λύση: καθορίστε τον περιορισμό στο prompt αντί για το σχήμα:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Το μοντέλο θα ακολουθήσει την οδηγία στις περισσότερες περιπτώσεις, αλλά αυτό δεν είναι εγγυημένο όπως θα ήταν με έναν περιορισμό σχήματος.
minItems / maxItems — χωρίς περιορισμούς μεγέθους πίνακα
Δεν μπορείτε να επιβάλετε ελάχιστο ή μέγιστο αριθμό στοιχείων σε έναν πίνακα.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Εναλλακτική λύση: χρησιμοποιήστε το prompt για να καθοδηγήσετε το μοντέλο:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Άλλοι περιορισμοί που πρέπει να γνωρίζετε
Χωρίς μοτίβα regex
Το API δεν υποστηρίζει περιορισμούς pattern σε συμβολοσειρές. Δεν μπορείτε να επιβάλετε μορφή email, UUID ή αριθμού τηλεφώνου μέσω του σχήματος.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Χωρίς προεπιλεγμένες τιμές
Η λέξη-κλειδί default δεν έχει κανένα αποτέλεσμα. Εάν ένα πεδίο υπάρχει στο σχήμα, το μοντέλο θα το συμπληρώσει πάντα.
Χωρίς υπό όρους λογική
Οι λέξεις-κλειδιά του JSON Schema if, then και else δεν είναι διαθέσιμες.
Η στρατηγική: σχήμα + prompt
Η βέλτιστη προσέγγιση συνδυάζει και τα δύο:
- Το σχήμα εγγυάται τη δομή: ονόματα πεδίων, τύπους, εμφώλευση
- Το prompt καθοδηγεί το περιεχόμενο: μήκη, συγκεκριμένες μορφές, επιχειρηματικούς κανόνες
class Report(BaseModel):
title: str
summary: str
key_points: list[str]
score: float
category: str
messages=[{
"role": "user",
"content": """Analyze this text and produce a report.
- The summary must be 2-3 sentences.
- List exactly 5 key points.
- The score is between 0 and 10.
- Category among: positive, negative, neutral."""
}]
Το σχήμα εγγυάται τους τύπους και τη δομή. Το prompt ελέγχει τις τιμές και τους περιορισμούς περιεχομένου.
Βασικά σημεία
- Τα
allOf,minLength,maxLength,minItemsκαιmaxItemsδεν υποστηρίζονται - Οι περιορισμοί
pattern,defaultκαιif/then/elseδεν υποστηρίζονται επίσης - Χρησιμοποιήστε το
anyOfαντί τουallOfόταν είναι δυνατόν - Μεταφέρετε τους περιορισμούς περιεχομένου στο prompt
- Ο συνδυασμός σχήματος (δομή) + prompt (περιεχόμενο) αποτελεί τη βέλτιστη στρατηγική