Ei-tuetut tyypit ja rajoitukset
Tällä sivulla
Mitä skeemat eivät pysty tekemään
Jäsenneltyjen tulosteiden rajoitusten ymmärtäminen on yhtä tärkeää kuin niiden ominaisuuksien hallitseminen. Grok API ei tue tiettyjä JSON Schema -rajoitteita. Niiden käyttäminen aiheuttaa virheen tai odottamatonta käyttäytymistä.
Kolme päärajoitusta
allOf — yhdistäminen ei ole sallittua
JSON Schemassa allOf-avainsana yhdistää useita aliskeemoja, jotka objektin on täytettävä samanaikaisesti. Grok API ei tue tätä ominaisuutta.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Vaihtoehto: käytä yhtä objektia, jossa on kaikki ominaisuudet:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — ei merkkijonon pituusrajoitteita
Et voi pakottaa mallia tuottamaan merkkijonoa, jonka pituus on vähintään tai enintään tietty määrä.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Vaihtoehto: määritä rajoite kehotteessa skeeman sijaan:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Malli noudattaa ohjetta useimmissa tapauksissa, mutta se ei ole taattua kuten skeemarajoite olisi.
minItems / maxItems — ei taulukon kokorajoitteita
Et voi pakottaa taulukon sisältämään vähintään tai enintään tiettyä määrää alkioita.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Vaihtoehto: käytä kehotetta ohjaamaan mallia:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Muut huomattavat rajoitukset
Ei säännöllisiä lausekkeita (regex)
API ei tue pattern-rajoitteita merkkijonoille. Et voi pakottaa sähköpostiosoitteen, UUID:n tai puhelinnumeron muotoa skeeman kautta.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Ei oletusarvoja
Avainsanalla default ei ole vaikutusta. Jos kenttä on skeemassa, malli täyttää sen aina.
Ei ehdollisia lausekkeita
JSON Scheman avainsanat if, then ja else eivät ole käytettävissä.
Strategia: skeema + kehote
Paras lähestymistapa yhdistää molemmat:
- Skeema takaa rakenteen: kenttien nimet, tyypit, sisäkkäisyys
- Kehote ohjaa sisältöä: pituudet, tietyt muodot, liiketoimintasäännöt
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."""
}]
Skeema takaa tyypit ja rakenteen. Kehote hallitsee arvoja ja sisältörajoitteita.
Keskeiset asiat
allOf,minLength,maxLength,minItemsjamaxItemseivät ole tuettuja- Myöskään
pattern,defaultjaif/then/else-rajoitteet eivät ole tuettuja - Käytä
anyOf:taallOf:n sijaan aina kun mahdollista - Siirrä sisältörajoitteet kehotteeseen
- Skeeman (rakenne) ja kehotteen (sisältö) yhdistäminen on optimaalinen strategia