Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Ei-tuetut tyypit ja rajoitukset

Oppitunti 3 / 12 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Mitä skeemat eivät pysty tekemään
  2. Kolme päärajoitusta
  3. Muut huomattavat rajoitukset
  4. Strategia: skeema + kehote
  5. Keskeiset asiat

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:

  1. Skeema takaa rakenteen: kenttien nimet, tyypit, sisäkkäisyys
  2. 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, minItems ja maxItems eivät ole tuettuja
  • Myöskään pattern, default ja if/then/else -rajoitteet eivät ole tuettuja
  • Käytä anyOf:ta allOf:n sijaan aina kun mahdollista
  • Siirrä sisältörajoitteet kehotteeseen
  • Skeeman (rakenne) ja kehotteen (sisältö) yhdistäminen on optimaalinen strategia