Неподдържани типове и ограничения
На тази страница
Какво не могат да правят схемите
Разбирането на ограниченията на структурираните изходи е също толкова важно, колкото и овладяването на техните възможности. 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 не са налични.
Стратегията: схема + подкана
Най-добрият подход комбинира и двете:
- Схемата гарантира структурата: имена на полета, типове, влагане.
- Подканата насочва съдържанието: дължини, специфични формати, бизнес правила.
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, когато е възможно. - Прехвърлете ограниченията за съдържанието към подканата.
- Комбинирането на схема (структура) и подкана (съдържание) е оптималната стратегия.