पाठ्यक्रम 250 में से पाठ 138 · संरचित आउटपुट और function/tool calling
संरचित आउटपुट और function/tool calling

बाँधे गए / schema-लागू आउटपुट

पिछले पाठों में आपने मॉडल JSON को हाथ से जाँचा। आधुनिक तरीका एक क़दम पहले जाता है: मॉडल को शुरू में ही ख़राब JSON बनाने से रोकें। यह constrained decoding है (इसे structured outputs भी कहते हैं)। आप API को एक schema देते हैं, और decoder को सिर्फ़ वे tokens चुनने की अनुमति है जो आउटपुट को उसके हिसाब से मान्य रखें। मॉडल सचमुच ग़ायब field या ग़लत प्रकार वाला मान नहीं बना सकता।

OpenAI-शैली API के साथ आप JSON Schema और strict: true वाला एक response_format देते हैं (सिर्फ़ उदाहरण -> हम यहाँ कोई मॉडल नहीं बुलाते):

resp = client.chat.completions.create(
    model="...",
    messages=[...],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "person",
            "strict": True,
            "schema": {
                "type": "object",
                "properties": {"name": {"type": "string"}, "age": {"type": "integer"}},
                "required": ["name", "age"],
            },
        },
    },
)

इस कोर्स का बाक़ी हिस्सा Anthropic को बुलाता है, जो पक्के-JSON जवाबों के लिए output_config और schema-पूर्ण tool inputs के लिए strict tool use से वही गारंटी देता है:

resp = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[...],
    output_config={"format": {
        "type": "json_schema",
        "schema": {
            "type": "object",
            "properties": {"name": {"type": "string"}, "age": {"type": "integer"}},
            "required": ["name", "age"],
        },
    }},
)

दोनों तरह प्रदाता बाँधने का काम करता है। पर constrained decoding फिर भी आपके business नियम नहीं जाँच सकता (क्या उम्र समझ में आती है? क्या currency वह है जिसे आप सँभालते हैं?), और हर मॉडल या gateway इसे नहीं सँभालता। इसलिए आप किसी भी हाल में अपनी तरफ़ जाँचते हैं। वही जाँचने वाला आप अब बनाते हैं।

Python की तरफ़ उस आकार को बताने और जाँचने का असल मानक Pydantic है। आप एक model class लिखते हैं और library आपके लिए parse, coerce, और validate करती है:

from pydantic import BaseModel

class Person(BaseModel):
    name: str
    age: int

record = Person.model_validate_json(text)   # raises if it does not fit

Pydantic इस ब्राउज़र sandbox में उपलब्ध नहीं है, इसलिए आप वही विचार मानक library से हाथ से बनाएँगे। ये libraries अंदर ठीक यही करती हैं, और इससे नियमों को गोलमोल करना असंभव हो जाता है। आप validate_against_schema(obj, schema) लिख रहे हैं।

schema एक dict है। हर मान या तो एक प्रकार-नाम स्ट्रिंग है ("int", "float", "str", "bool", "list", "dict") या {"type": "int", "default": 0} जैसी एक छोटी spec dict। आपका फ़ंक्शन एक नतीजा dict {"ok": bool, "value": dict, "errors": list} लौटाता है:

  • अगर obj एक dict नहीं है, तो एक root error और ख़ाली value के साथ ok=False लौटाएँ।
  • हर field के लिए: अगर वह ग़ायब है और spec में "default" है, तो default भरें (coerce/default दौर)। अगर बिना default के ग़ायब है, तो एक error दर्ज करें।
  • अगर मौजूद है, तो उसका प्रकार जाँचें। बेमेल पर field का नाम लेते हुए एक error दर्ज करें।
  • जब float चाहिए तो सादे int को float तक coerce करें (यह बिना नुक़सान और सुरक्षित है), पर बाक़ी कुछ coerce न करें।
  • अगर कोई error थी, तो इकट्ठा errors और ख़ाली value के साथ ok=False लौटाएँ; नहीं तो जाँचे value के साथ ok=True।

bool-is-int जाल। Python में bool int की सबक्लास है, इसलिए isinstance(True, int) True है और JSON true Python True में decode होता है। भोली प्रकार जाँच "age": true को int field से आराम से निकल जाने देगी। जहाँ भी int या float चाहिए, वहाँ bool को साफ़ तौर पर अस्वीकार करें:

if expected is int and isinstance(value, bool):
    errors.append(field + ": expected int, got bool")

इसे ऐसे बनाएँ कि दो अलग सही-रूप वाले payloads दोनों पास हों, ग़ायब field और ग़लत प्रकार हर एक errors में आए, default भरे, int float में coerce हो, और जहाँ संख्या चाहिए वहाँ चुपके से आया bool अस्वीकार हो।

आपकी बारी

validate_against_schema(obj, schema) लिखें जो {"ok", "value", "errors"} लौटाए। schema हर field को एक प्रकार-नाम स्ट्रिंग ("int"/"float"/"str"/"bool"/"list"/"dict") या एक spec dict {"type": ..., "default": ...} से जोड़ता है। ग़ैर-dict obj अस्वीकार करें, हर ग़ायब (बिना default) या ग़लत प्रकार वाले field के लिए error दर्ज करें, default दिया हो तो भरें, सादे int को float तक coerce करें, और जहाँ int या float चाहिए वहाँ bool अस्वीकार करें (bool-is-int जाल)। जाँचे value के साथ ok=True सिर्फ़ तब लौटाएँ जब कोई error न हो।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।