Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tipi mhux appoġġjati u limitazzjonijiet

Lezzjoni 3 / 12 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. X’ma jistgħux jagħmlu l-iskemi
  2. It-tliet restrizzjonijiet ewlenin
  3. Limitazzjonijiet oħra li għandek tkun taf bihom
  4. L-istrateġija: skema + prompt
  5. Punti Ewlenin

X’ma jistgħux jagħmlu l-iskemi

Li tifhem il-limiti tal-outputs strutturati huwa daqstant importanti kemm li tħaddan il-kapaċitajiet tagħhom. L-API ta’ Grok ma tappoġġjax ċerti restrizzjonijiet ta’ JSON Schema. Jekk tipprova tużahom, se tiġġenera żball jew tikkawża mġiba mhux mistennija.

It-tliet restrizzjonijiet ewlenin

allOf — il-kompożizzjoni mhix permessa

F’JSON Schema, il-kelma ewlenija allOf tgħaqqad diversi sottoskemi li oġġett irid jissodisfa fl-istess ħin. L-API ta’ Grok ma tappoġġjax din il-karatteristika.

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

Alternattiva: uża oġġett wieħed bil-proprjetajiet kollha:

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

minLength / maxLength — l-ebda restrizzjoni fuq it-tul tal-katina

Ma tistax tifforza lill-mudell biex jipproduċi katina b’tul minimu jew massimu.

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

Alternattiva: speċifika r-restrizzjoni fil-prompt minflok fl-iskema:

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

Il-mudell isegwi l-istruzzjoni fil-biċċa l-kbira tal-każijiet, iżda dan mhuwiex garantit daqslikieku kien restrizzjoni tal-iskema.

minItems / maxItems — l-ebda restrizzjoni fuq id-daqs tal-array

Ma tistax timponi numru minimu jew massimu ta’ elementi f’array.

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

Alternattiva: uża l-prompt biex tiggwida lill-mudell:

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

Limitazzjonijiet oħra li għandek tkun taf bihom

L-ebda mudelli regex

L-API ma tappoġġjax restrizzjonijiet ta’ pattern fuq il-katini. Ma tistax timponi format ta’ email, UUID, jew numru tat-telefon permezz tal-iskema.

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

L-ebda valuri predefiniti

Il-kelma ewlenija default m’għandha l-ebda effett. Jekk qasam ikun fl-iskema, il-mudell dejjem jimlah.

L-ebda kundizzjonali

Il-kliem ewlieni ta’ JSON Schema if, then, u else mhumiex disponibbli.

L-istrateġija: skema + prompt

L-aħjar approċċ jgħaqqad it-tnejn:

  1. L-iskema tiggarantixxi l-istruttura: ismijiet tal-oqsma, tipi, u t-tbejjit
  2. Il-prompt jiggwida l-kontenut: it-tulijiet, formati speċifiċi, u r-regoli tan-negozju
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."""
}]

L-iskema tiggarantixxi t-tipi u l-istruttura. Il-prompt jikkontrolla l-valuri u r-restrizzjonijiet tal-kontenut.

Punti Ewlenin

  • allOf, minLength, maxLength, minItems, u maxItems mhumiex appoġġjati
  • Ir-restrizzjonijiet pattern, default, u if/then/else lanqas huma appoġġjati
  • Uża anyOf minflok allOf meta possibbli
  • Ħalli r-restrizzjonijiet tal-kontenut f’idejn il-prompt
  • Il-kombinazzjoni ta’ skema (istruttura) + prompt (kontenut) hija l-istrateġija ottimali