Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cineálacha nach dtacaítear leo agus teorainneacha

Ceacht 3 as 12 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Cad nach féidir le scéimí a dhéanamh
  2. Na trí phríomhshrian
  3. Teorainneacha eile le bheith ar an eolas fúthu
  4. An straitéis: scéima + leid
  5. Príomhphointí

Cad nach féidir le scéimí a dhéanamh

Tá sé chomh tábhachtach céanna teorainneacha na n-aschur struchtúrtha a thuiscint agus atá a n-acmhainní a mháistriú. Ní thacaíonn API Grok le srianta áirithe JSON Schema. Má úsáideann tú iad, spreagfar earráid nó tarlóidh iompar gan choinne.

Na trí phríomhshrian

allOf — ní cheadaítear comhdhéanamh

I JSON Schema, úsáidtear an eochairfhocal allOf chun roinnt foscéimí a chomhcheangal ar cheart d’object a bheith sásta leo go léir ag an am céanna. Ní thacaíonn API Grok leis an ngné seo.

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

Rogha eile: úsáid object amháin ina bhfuil na hairíonna go léir:

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

minLength / maxLength — gan srianta faid teaghráin

Ní féidir leis an tsamhail a chur faoi iallach teaghrán a ghiniúint a bhfuil fad íosta nó uasta aige.

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

Rogha eile: sonraigh an srian sa leid in ionad sa scéima:

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

Leanfaidh an tsamhail an treoir i bhformhór na gcásanna, ach níl sé ráthaithe mar a bheadh srian scéime.

minItems / maxItems — gan srianta méide eagar

Ní féidir líon íosta nó uasta eilimintí in eagar a fhorfheidhmiú.

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

Rogha eile: úsáid an leid chun an tsamhail a threorú:

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

Teorainneacha eile le bheith ar an eolas fúthu

Gan patrúin regex

Ní thacaíonn an API le srianta pattern ar theaghráin. Ní féidir formáid ríomhphoist, UUID, nó uimhir theileafóin a fhorfheidhmiú tríd an scéima.

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

Gan luachanna réamhshocraithe

Níl aon éifeacht ag an eochairfhocal default. Má tá réimse sa scéima, líonfaidh an tsamhail é i gcónaí.

Gan coinníollacha

Níl na heochairfhocail JSON Schema if, then, agus else ar fáil.

An straitéis: scéima + leid

Is é an cur chuige is fearr ná an dá cheann a chomhcheangal:

  1. Ráthaíonn an scéima an struchtúr: ainmneacha réimsí, cineálacha, neadú
  2. Treoraíonn an leid an t-ábhar: faid, formáidí sonracha, rialacha gnó
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."""
}]

Ráthaíonn an scéima cineálacha agus struchtúr. Rialaíonn an leid luachanna agus srianta ábhair.

Príomhphointí

  • Ní thacaítear le allOf, minLength, maxLength, minItems, ná maxItems
  • Ní thacaítear le srianta pattern, default, ná if/then/else ach oiread
  • Úsáid anyOf in ionad allOf nuair is féidir
  • Aistrigh srianta ábhair chuig an leid
  • Is é an chomhcheangal scéima (struchtúr) + leid (ábhar) an straitéis is fearr