Nepalaikomi tipai ir apribojimai
Šiame puslapyje
Ko schemos negali padaryti
Suprasti struktūrizuotų išvesčių ribotumą yra taip pat svarbu, kaip ir įvaldyti jų galimybes. Grok API nepalaiko tam tikrų JSON Schema apribojimų. Bandymas juos naudoti sukels klaidą arba netikėtą elgseną.
Trys pagrindiniai apribojimai
allOf — kompozicija neleidžiama
JSON Schema raktažodis allOf sujungia kelias poschemes, kurias objektas turi atitikti vienu metu. Grok API nepalaiko šios funkcijos.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternatyva: naudokite vieną objektą su visomis savybėmis:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength – jokių eilučių ilgio apribojimų
Negalite priversti modelio sugeneruoti eilutės, kurios ilgis būtų minimalus arba maksimalus.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternatyva: nurodykite apribojimą užklausoje (prompt), o ne schemoje:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Modelis daugeliu atvejų laikysis instrukcijos, tačiau tai nėra taip garantuota, kaip būtų naudojant schemos apribojimą.
minItems / maxItems – jokių masyvo dydžio apribojimų
Negalite užtikrinti minimalaus arba maksimalaus elementų skaičiaus masyve.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternatyva: naudokite užklausą modelio nukreipimui:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Kiti apribojimai, kuriuos verta žinoti
Nėra reguliariųjų išraiškų (regex) šablonų
API nepalaiko pattern apribojimų eilutėms. Negalite priverstinai nustatyti el. pašto formato, UUID arba telefono numerio per schemą.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Nėra numatytųjų reikšmių
Raktažodis default neturi jokio poveikio. Jei laukas yra schemoje, modelis jį visada užpildys.
Nėra sąlyginių operatorių
JSON Schema raktažodžiai if, then ir else nėra prieinami.
Strategija: schema + užklausa
Geriausias būdas – derinti abu:
- Schema garantuoja struktūrą: laukų pavadinimus, tipus, įdėtumą.
- Užklausa nukreipia turinį: ilgius, specifinius formatus, verslo taisykles.
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."""
}]
Schema garantuoja tipus ir struktūrą. Užklausa kontroliuoja reikšmes ir turinio apribojimus.
Svarbiausi punktai
allOf,minLength,maxLength,minItemsirmaxItemsnepalaikomipattern,defaultirif/then/elseapribojimai taip pat nepalaikomi- Kai įmanoma, vietoj
allOfnaudokiteanyOf - Turinio apribojimus perkelkite į užklausą
- Schemos (struktūra) ir užklausos (turinys) derinimas yra optimali strategija