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

Περιορισμοί Λειτουργίας JSON και Διαχείριση Σφαλμάτων

Μάθημα 6 / 12 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το Έγκυρο Δεν Σημαίνει Σωστό
  2. Καμία Εγγύηση Σχήματος
  3. Υποχρεωτική Επικύρωση στην Πλευρά του Πελάτη
  4. Τρεις Αποτυχίες που Θα Συναντήσετε
  5. Επαναληπτική Δοκιμή με Ανατροφοδότηση
  6. Το Σήμα για Αλλαγή Προσέγγισης
  7. Βασικά σημεία

Το Έγκυρο Δεν Σημαίνει Σωστό

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

Καμία Εγγύηση Σχήματος

Ο μηχανισμός δεν γνωρίζει τίποτα για το σχήμα σας: δεν έχει δει ποτέ τη δομή που αναμένει ο κώδικάς σας. Το μοντέλο μπορεί να παραλείψει ένα πεδίο που χρειάζεστε, να προσθέσει ένα που δεν ζητήσατε, να μετονομάσει ένα κλειδί—firstName αντί για first_name—ή να αλλάξει έναν τύπο επιστρέφοντας το "42" ως συμβολοσειρά όταν αναμένατε τον αριθμό 42. Κανένα από αυτά δεν αποτελεί άκυρο JSON.

# Αναμένετε αυτό:
# {"name": "Alice", "age": 30, "city": "Paris"}

# Αλλά μπορεί να λάβετε:
# {"nom": "Alice", "âge": "trente ans", "ville": "Paris", "pays": "France"}

Το JSON είναι έγκυρο, αλλά η δομή δεν ταιριάζει με αυτή που αναμένει ο κώδικάς σας. Αυτή είναι η θεμελιώδης διαφορά από τις Προσαρμοσμένες Δομημένες Εξόδους (Custom Structured Outputs).

Υποχρεωτική Επικύρωση στην Πλευρά του Πελάτη

Δεδομένου ότι το σχήμα δεν είναι εγγυημένο, η επικύρωση εναπόκειται σε εσάς. Το ελάχιστο μοτίβο κάνει τρία πράγματα με σειρά: επιχειρεί την ανάλυση, επαληθεύει ότι η ρίζα είναι ένα αντικείμενο (όχι λίστα ή βαθμωτή τιμή) και στη συνέχεια ελέγχει για τα απαιτούμενα κλειδιά. Κάθε αποτυχία προκαλεί ένα ValueError με ένα μήνυμα που μπορείτε να χρησιμοποιήσετε στα αρχεία καταγραφής σας.

import json
from typing import Optional

def parse_and_validate(raw_content: str, required_keys: list[str]) -> dict:
    """Ανάλυση JSON και επαλήθευση απαιτούμενων κλειδιών."""
    try:
        data = json.loads(raw_content)
    except json.JSONDecodeError as e:
        raise ValueError(f"Μη έγκυρο JSON: {e}")

    if not isinstance(data, dict):
        raise ValueError(f"Αναμενόταν αντικείμενο JSON, ελήφθη {type(data).__name__}")

    missing = [k for k in required_keys if k not in data]
    if missing:
        raise ValueError(f"Λείπουν κλειδιά: {missing}")

    return data

# Χρήση
try:
    result = parse_and_validate(
        response.choices[0].message.content,
        required_keys=["name", "category", "priority"]
    )
    process_ticket(result)
except ValueError as e:
    log_error(f"Μη έγκυρη έξοδος: {e}")
    fallback_processing(raw_content)

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

interface TicketClassification {
  category: string;
  priority: string;
  sentiment: string;
  summary: string;
}

function validateTicket(raw: string): TicketClassification {
  const data = JSON.parse(raw);

  const requiredKeys = ["category", "priority", "sentiment", "summary"];
  const missing = requiredKeys.filter((k) => !(k in data));

  if (missing.length > 0) {
    throw new Error(`Λείπουν κλειδιά: ${missing.join(", ")}`);
  }

  const validCategories = ["billing", "account", "technical", "feature_request", "other"];
  if (!validCategories.includes(data.category)) {
    throw new Error(`Μη έγκυρη κατηγορία: ${data.category}`);
  }

  return data as TicketClassification;
}

Τρεις Αποτυχίες που Θα Συναντήσετε

Η πρώτη είναι το περικομμένο JSON. Εάν η απάντηση χτυπήσει το όριο max_tokens, διακόπτεται στη μέση της ροής και γίνεται άκυρη—η άγκιστρο κλεισίματος δεν φτάνει ποτέ. Μπορείτε να εντοπίσετε το σύμπτωμα πριν καν κάνετε ανάλυση: το finish_reason ισούται με "length" αντί για "stop".

response = client.chat.complete(
    model="mistral-small-latest",
    messages=messages,
    response_format={"type": "json_object"},
    max_tokens=50  # Πολύ μικρό για πλήρες JSON
)

# Το response.choices[0].finish_reason θα είναι "length" αντί για "stop"
if response.choices[0].finish_reason == "length":
    print("Προειδοποίηση: Περικομμένη απάντηση, αυξήστε το max_tokens")

Ελέγχετε πάντα το finish_reason: εάν ισούται με "length", η απάντηση είναι ημιτελής, ανεξάρτητα από το τι λέει το υπόλοιπο περιεχόμενο.

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

def safe_get_int(data: dict, key: str, default: int = 0) -> int:
    """Εξαγωγή ακεραίου, με μετατροπή εάν χρειάζεται."""
    value = data.get(key)
    if value is None:
        return default
    if isinstance(value, int):
        return value
    if isinstance(value, float):
        return int(value)
    if isinstance(value, str):
        try:
            return int(value)
        except ValueError:
            return default
    return default

# Χρήση
age = safe_get_int(data, "age", default=0)

Η τρίτη είναι η μετονομασία κλειδιών. Με ένα γαλλικό prompt, το μοντέλο μπορεί εύκολα να αλλάξει το phone σε telephone, ή το name σε nom. Μια χαρτογράφηση συνωνύμων απορροφά αυτές τις παραλλαγές χωρίς να απαιτείται να επαναλάβετε την κλήση.

def normalize_keys(data: dict, key_mapping: dict) -> dict:
    """Κανονικοποίηση κλειδιών χρησιμοποιώντας χαρτογράφηση συνωνύμων."""
    normalized = {}
    for standard_key, aliases in key_mapping.items():
        for alias in aliases:
            if alias in data:
                normalized[standard_key] = data[alias]
                break
    return normalized

# Χαρτογράφηση συνωνύμων
mapping = {
    "name": ["name", "nom", "full_name", "fullName"],
    "email": ["email", "mail", "e-mail", "emailAddress"],
    "phone": ["phone", "telephone", "tel", "phoneNumber"],
}

normalized = normalize_keys(raw_data, mapping)

Επαναληπτική Δοκιμή με Ανατροφοδότηση

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

import json

def call_with_retry(client, messages, max_retries=3):
    """Κλήση με επαναληπτική δοκιμή και ανατροφοδότηση σφάλματος."""
    for attempt in range(max_retries):
        response = client.chat.complete(
            model="mistral-large-latest",
            messages=messages,
            response_format={"type": "json_object"},
            temperature=0
        )

        raw = response.choices[0].message.content
        try:
            data = json.loads(raw)
            validate_schema(data)  # Η συνάρτηση επικύρωσής σας
            return data
        except (json.JSONDecodeError, ValueError) as e:
            if attempt < max_retries - 1:
                # Προσθήκη ανατροφοδότησης σφάλματος στο πλαίσιο
                messages.append({"role": "assistant", "content": raw})
                messages.append({
                    "role": "user",
                    "content": f"Η απάντησή σας είναι άκυρη: {e}. Διορθώστε την και επιστρέψτε έγκυρο JSON."
                })
            else:
                raise RuntimeError(f"Αποτυχία μετά από {max_retries} προσπάθειες: {e}")

Το Σήμα για Αλλαγή Προσέγγισης

Εάνβρείτε τον εαυτό σας να γράφετε εκτεταμένο κώδικα επικύρωσης, αυτό είναι ένα ισχυρό σήμα ότι ήρθε η ώρα να μεταβείτε σε Προσαρμοσμένες Δομημένες Εξόδους. Τρία τυπικά όρια επιβεβαιώνουν αυτό: πέρα από πέντε πεδία προς επικύρωση, η συνάρτηση ελέγχου γίνεται μεγαλύτερη από την ίδια την κλήση· μόλις οι τύποι γίνουν πολύπλοκοι με εμφωλευμένες λίστες ή απαριθμήσεις, η χειροκίνητη επικύρωση γίνεται αξεχώριστη από τα σφάλματα που εισάγει· και για οποιαδήποτε κρίσιμη γραμμή παραγωγής, η ανάθεση περιορισμών στο σχήμα είναι απλά πιο ασφαλής από την ανακατασκευή τους με το χέρι.

Βασικά σημεία

  • Η Λειτουργία JSON εγγυάται έγκυρο JSON, όχι έγκυρο σχήμα
  • Πάντα να επικυρώνετε την έξοδο στην πλευρά του πελάτη: ελέγξτε για απαιτούμενα κλειδιά, σωστούς τύπους και τιμές εντός ορίων
  • Ελέγξτε το finish_reason για να εντοπίσετε περικομμένες απαντήσεις
  • Υλοποιήστε έναν μηχανισμό επαναληπτικής δοκιμής με ανατροφοδότηση σφάλματος
  • Εάν η επικύρωση γίνει πολύπλοκη, μεταβείτε σε Προσαρμοσμένες Δομημένες Εξόδους