Tipuri neacceptate și limitări
Pe această pagină
Ce nu pot face schemele
Înțelegerea limitărilor ieșirilor structurate este la fel de importantă ca și stăpânirea capacităților acestora. API-ul Grok nu acceptă anumite constrângeri JSON Schema. Încercarea de a le utiliza va declanșa o eroare sau va provoca un comportament neașteptat.
Cele trei restricții majore
allOf — compunerea nu este permisă
În JSON Schema, cuvântul cheie allOf combină mai multe subscheme pe care un obiect trebuie să le respecte simultan. API-ul Grok nu acceptă această funcționalitate.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternativă: utilizați un singur obiect cu toate proprietățile:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — fără constrângeri de lungime pentru șiruri
Nu puteți forța modelul să producă un șir cu o lungime minimă sau maximă.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternativă: specificați constrângerea în prompt în loc de schemă:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Modelul va urma instrucțiunea în majoritatea cazurilor, dar acest lucru nu este garantat așa cum ar fi o constrângere de schemă.
minItems / maxItems — fără constrângeri de dimensiune pentru tablouri
Nu puteți impune un număr minim sau maxim de elemente într-un tablou.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternativă: utilizați promptul pentru a ghida modelul:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Alte limitări de cunoscut
Fără modele regex
API-ul nu acceptă constrângerile pattern asupra șirurilor de caractere. Nu puteți impune un format de e-mail, UUID sau număr de telefon prin intermediul schemei.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Fără valori implicite
Cuvântul cheie default nu are niciun efect. Dacă un câmp se află în schemă, modelul îl va popula întotdeauna.
Fără condiționale
Cuvintele cheie JSON Schema if, then și else nu sunt disponibile.
Strategia: schemă + prompt
Cea mai bună abordare le combină pe ambele:
- Schema garantează structura: numele câmpurilor, tipurile, imbricarea
- Promptul ghidează conținutul: lungimi, formate specifice, reguli de afaceri
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 garantează tipurile și structura. Promptul controlează valorile și constrângerile de conținut.
Puncte cheie
allOf,minLength,maxLength,minItemsșimaxItemsnu sunt acceptate- Constrângerile
pattern,defaultșiif/then/elsenu sunt nici ele acceptate - Utilizați
anyOfîn loc deallOfatunci când este posibil - Delegați constrângerile de conținut către prompt
- Combinarea schemei (structură) + prompt (conținut) reprezintă strategia optimă