Cineálacha nach dtacaítear leo agus teorainneacha
Ar an leathanach seo
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:
- Ráthaíonn an scéima an struchtúr: ainmneacha réimsí, cineálacha, neadú
- 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/elseach oiread - Úsáid
anyOfin ionadallOfnuair is féidir - Aistrigh srianta ábhair chuig an leid
- Is é an chomhcheangal scéima (struchtúr) + leid (ábhar) an straitéis is fearr