Typy nieobsługiwane i ograniczenia
Na tej stronie
Czego nie potrafią schematy
Zrozumienie ograniczeń wyjść strukturalnych jest równie ważne, jak opanowanie ich możliwości. API Grok nie obsługuje niektórych ograniczeń JSON Schema. Próba ich użycia spowoduje błąd lub nieprzewidywalne zachowanie.
Trzy główne ograniczenia
allOf — kompozycja niedozwolona
W JSON Schema słowo kluczowe allOf łączy wiele podschematów, którym obiekt musi spełniać jednocześnie. API Grok nie obsługuje tej funkcji.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternatywa: użyj pojedynczego obiektu ze wszystkimi właściwościami:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — brak ograniczeń długości ciągu
Nie możesz wymusić na modelu wygenerowania ciągu o minimalnej lub maksymalnej długości.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternatywa: określ ograniczenie w monicie (prompt), a nie w schemacie:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Model w większości przypadków zastosuje się do instrukcji, ale nie jest to tak gwarantowane, jak w przypadku ograniczenia schematu.
minItems / maxItems — brak ograniczeń rozmiaru tablicy
Nie możesz wymusić minimalnej ani maksymalnej liczby elementów w tablicy.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternatywa: użyj monitu, aby pokierować modelem:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Inne ograniczenia, o których warto wiedzieć
Brak wzorców regex
API nie obsługuje ograniczeń pattern dla ciągów znaków. Nie możesz wymusić formatu e-maila, UUID ani numeru telefonu za pomocą schematu.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Brak wartości domyślnych
Słowo kluczowe default nie ma żadnego efektu. Jeśli pole znajduje się w schemacie, model zawsze je wypełni.
Brak warunków
Słowa kluczowe JSON Schema if, then i else są niedostępne.
Strategia: schemat + monit
Najlepsze podejście łączy obie metody:
- Schemat gwarantuje strukturę: nazwy pól, typy, zagnieżdżenie
- Monit kieruje treścią: długości, konkretne formaty, reguły biznesowe
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."""
}]
Schemat gwarantuje typy i strukturę. Monit kontroluje wartości i ograniczenia treści.
Kluczowe wnioski
allOf,minLength,maxLength,minItemsimaxItemssą nieobsługiwane- Ograniczenia
pattern,defaultorazif/then/elserównież nie są obsługiwane - Używaj
anyOfzamiastallOf, gdy to możliwe - Przenieś ograniczenia dotyczące treści do monitu
- Połączenie schematu (struktura) i monitu (treść) to optymalna strategia