Tipi mhux appoġġjati u limitazzjonijiet
F'din il-paġna
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:
- L-iskema tiggarantixxi l-istruttura: ismijiet tal-oqsma, tipi, u t-tbejjit
- 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, umaxItemsmhumiex appoġġjati- Ir-restrizzjonijiet
pattern,default, uif/then/elselanqas huma appoġġjati - Uża
anyOfminflokallOfmeta possibbli - Ħalli r-restrizzjonijiet tal-kontenut f’idejn il-prompt
- Il-kombinazzjoni ta’ skema (istruttura) + prompt (kontenut) hija l-istrateġija ottimali