Przejdź do głównej treści
Polski— Wybierz język
Menu

Typy nieobsługiwane i ograniczenia

Lekcja 3 z 12 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Czego nie potrafią schematy
  2. Trzy główne ograniczenia
  3. Inne ograniczenia, o których warto wiedzieć
  4. Strategia: schemat + monit
  5. Kluczowe wnioski

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:

  1. Schemat gwarantuje strukturę: nazwy pól, typy, zagnieżdżenie
  2. 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, minItems i maxItems są nieobsługiwane
  • Ograniczenia pattern, default oraz if/then/else również nie są obsługiwane
  • Używaj anyOf zamiast allOf, gdy to możliwe
  • Przenieś ograniczenia dotyczące treści do monitu
  • Połączenie schematu (struktura) i monitu (treść) to optymalna strategia