Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Μη υποστηριζόμενοι τύποι και περιορισμοί

Μάθημα 3 / 12 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Τι δεν μπορούν να κάνουν τα σχήματα
  2. Οι τρεις κύριοι περιορισμοί
  3. Άλλοι περιορισμοί που πρέπει να γνωρίζετε
  4. Η στρατηγική: σχήμα + prompt
  5. Βασικά σημεία

Τι δεν μπορούν να κάνουν τα σχήματα

Η κατανόηση των ορίων των δομημένων εξόδων είναι εξίσου σημαντική με την κατάκτηση των δυνατοτήτων τους. Το 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

Η βέλτιστη προσέγγιση συνδυάζει και τα δύο:

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