Премини към основното съдържание
Български— Изберете език
Меню

Неподдържани типове и ограничения

Урок 3 от 12 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Какво не могат да правят схемите
  2. Трите основни ограничения
  3. Други ограничения, които трябва да знаете
  4. Стратегията: схема + подкана
  5. Ключови изводи

Какво не могат да правят схемите

Разбирането на ограниченията на структурираните изходи е също толкова важно, колкото и овладяването на техните възможности. Grok API не поддържа определени ограничения на JSON Schema. Опитът да ги използвате ще предизвика грешка или ще доведе до неочаквано поведение.

Трите основни ограничения

allOf — композицията не е позволена

В JSON Schema ключовата дума allOf комбинира множество подсхеми, на които един обект трябва да отговаря едновременно. Grok API не поддържа тази функция.

// DOES NOT WORK
{
  "allOf": [
    { "properties": { "nom": { "type": "string" } } },
    { "properties": { "age": { "type": "number" } } }
  ]
}

Алтернатива: използвайте един единствен обект с всички свойства:

// WORKS
{
  "type": "object",
  "properties": {
    "nom": { "type": "string" },
    "age": { "type": "number" }
  }
}

minLength / maxLength — няма ограничения за дължината на низа

Не можете да принудите модела да генерира низ с минимална или максимална дължина.

// DOES NOT WORK
{
  "properties": {
    "code": {
      "type": "string",
      "minLength": 3,
      "maxLength": 10
    }
  }
}

Алтернатива: посочете ограничението в подканата (prompt), а не в схемата:

messages=[{
    "role": "user",
    "content": "Generate a product code between 3 and 10 characters."
}]

Моделът ще следва инструкцията в повечето случаи, но това не е гарантирано така, както би било при ограничение в схемата.

minItems / maxItems — няма ограничения за размера на масива

Не можете да наложите минимален или максимален брой елементи в масив.

// DOES NOT WORK
{
  "properties": {
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1,
      "maxItems": 5
    }
  }
}

Алтернатива: използвайте подканата, за да насочите модела:

messages=[{
    "role": "user",
    "content": "List between 1 and 5 relevant tags for this article."
}]

Други ограничения, които трябва да знаете

Няма regex шаблони

API не поддържа ограниченията pattern за низове. Не можете да наложите формат за имейл, UUID или телефонен номер чрез схемата.

// DOES NOT WORK
{
  "properties": {
    "email": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
    }
  }
}

Няма стойности по подразбиране

Ключовата дума default няма ефект. Ако едно поле присъства в схемата, моделът винаги ще го попълни.

Няма условни конструкции

Ключовите думи на JSON Schema if, then и else не са налични.

Стратегията: схема + подкана

Най-добрият подход комбинира и двете:

  1. Схемата гарантира структурата: имена на полета, типове, влагане.
  2. Подканата насочва съдържанието: дължини, специфични формати, бизнес правила.
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."""
}]

Схемата гарантира типовете и структурата. Подканата контролира стойностите и ограниченията на съдържанието.

Ключови изводи

  • allOf, minLength, maxLength, minItems и maxItems не се поддържат.
  • Ограниченията pattern, default и if/then/else също не се поддържат.
  • Използвайте anyOf вместо allOf, когато е възможно.
  • Прехвърлете ограниченията за съдържанието към подканата.
  • Комбинирането на схема (структура) и подкана (съдържание) е оптималната стратегия.