โหมด JSON และผลลัพธ์จากการเรียกใช้เครื่องมือ

ความจำเป็นของโครงสร้าง

โหมด JSON (OpenAI)

from openai import OpenAI
client = OpenAI()

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=[
        {'role': 'system', 'content': 'Return a JSON object with name and age.'},
        {'role': 'user', 'content': 'Alice, 30 years old.'}
    ],
    response_format={'type': 'json_object'}
)
import json
data = json.loads(response.choices[0].message.content)

ข้อควรระวังของโหมด JSON

เอาต์พุตแบบมีโครงสร้าง (เข้มงวด)

schema = {
    'name': 'person',
    'schema': {
        'type': 'object',
        'properties': {
            'name': {'type': 'string'},
            'age': {'type': 'integer'}
        },
        'required': ['name', 'age'],
        'additionalProperties': False
    },
    'strict': True
}

response = client.chat.completions.create(
    model='gpt-4o-2024-08-06',
    messages=...,
    response_format={'type': 'json_schema', 'json_schema': schema}
)

โหมดเข้มงวดทำงานอย่างไร

การเรียกใช้เครื่องมือเป็นเอาต์พุตแบบมีโครงสร้าง

tools = [{'type': 'function', 'function': {
    'name': 'submit_person',
    'parameters': {
        'type': 'object',
        'properties': {'name': {'type': 'string'}, 'age': {'type': 'integer'}},
        'required': ['name', 'age']
    }
}}]

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=...,
    tools=tools,
    tool_choice={'type': 'function', 'function': {'name': 'submit_person'}}
)
args = json.loads(response.choices[0].message.tool_calls[0].function.arguments)

การใช้เครื่องมือของ Anthropic เป็นเอาต์พุต

tool_choice = {'type': 'tool', 'name': 'submit_person'}
print(tool_choice)

JSON ผ่านการเติมข้อมูลล่วงหน้า (Anthropic)

messages = [
    {'role': 'user', 'content': 'Give me JSON for Alice, 30.'},
    {'role': 'assistant', 'content': '{'}
]
# Output starts with { and likely produces valid JSON.
for m in messages:
    print(f"{m['role']}: {m['content']}")
print("Output starts with { and likely produces valid JSON.")

Pydantic + โหมดเข้มงวด

from pydantic import BaseModel

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

response = client.beta.chat.completions.parse(
    model='gpt-4o-2024-08-06',
    messages=...,
    response_format=Person
)
person = response.choices[0].message.parsed
# Pydantic instance, type-safe

ข้อผิดพลาดที่พบบ่อย

ต้นทุนของเอาต์พุตแบบมีโครงสร้าง

ใช้ร่วมกับการตรวจสอบความถูกต้อง

การรับประกันของโหมดเข้มงวด

สรุป