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

Formáid sonraí: comhráite JSONL

Ceacht 3 as 16 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. An fhormáid JSONL
  2. Struchtúr an chomhrá
  3. Comhráite il-chas
  4. Meáchanú le weight
  5. Script chruthaithe comhaid JSONL
  6. Príomhphointí

Nuashonrú 2 Samhain 2026 — Fáil ar fhíneáil. Tá an tseirbhís fhíneála féinseirbhíse ó OpenAI á céimniú amach: ón 7 Bealtaine 2026, ní féidir le heagraíochtaí nár úsáid riamh í post a chruthú a thuilleadh; ón 2 Iúil, caithfidh tú samhaltóir fíneáilte a bheith úsáidte agat laistigh de na 60 lá seo caite; agus ón 6 Eanáir 2027, ní bheidh aon chustaiméir in ann post nua a sheoladh. Fanann samhlacha atá traenáilte cheana inúsáidte go dtí go gcuirtear an bunsamhail as feidhm. Tá an cúrsa seo fós úsáideach chun samhail atá ann cheana a thuiscint agus a shaothrú; do thionscadail nua, tabhair tosaíocht d’innealtóireacht leideanna, RAG, agus meastóireachtaí.

An fhormáid JSONL

Is é JSONL (JSON Lines) an fhormáid a éilítear don API fíneála OpenAI. Is oibiacht JSON neamhspleách í gach líne sa chomhad a léiríonn sampla oiliúna iomlán. Ligeann an struchtúr seo sruthú a dhéanamh ar chorpas de dheich mílte sampla gan an comhad iomlán a lódáil riamh sa chuimhne.

{"messages": [{"role": "system", "content": "..."}, {"role": "user", "content": "..."}, {"role": "assistant", "content": "..."}]}
{"messages": [{"role": "system", "content": "..."}, {"role": "user", "content": "..."}, {"role": "assistant", "content": "..."}]}

Rialach bunúsach: líne amháin = oibiacht JSON amháin = sampla amháin. Ná cuir bristeacha líne isteach san oibiacht JSON féin. I bhfocail eile, brisfidh JSON “deas-printáilte” le heangú ó d’eagarthóir an comhad—is é seo an chúis is coitianta le diúltú uaslódála.

Struchtúr an chomhrá

Is oibiacht é gach sampla a bhfuil eochair messages aige ina bhfuil eagar teachtaireachtaí. Tá role agus content ag gach teachtaireacht. Ní ghlactar ach le trí ról:

  • system: treoracha domhanda don chúntóir (roghnach, ach moltar é)
  • user: teachtaireacht an úsáideora
  • assistant: an freagra ar chóir don tsamhail foghlaim a tháirgeadh

Baineann an fhormáid íosta le malartú aonair idir úsáideoir agus cúntóir. Tá sé seo leordhóthanach nuair nach mbraitheann an iompar atá ag teastáil ar chreatlach ar leith, mar shampla do shamhail atá tiomnaithe do thasc amháin.

{
  "messages": [
    {"role": "user", "content": "Dia dhuit, conas atá tú?"},
    {"role": "assistant", "content": "Dia dhuit! Táim réidh le cabhrú. Cad is féidir liom a dhéanamh duit?"}
  ]
}

Chomh luath agus a theastaíonn ón tsamhail ról ar leith a ghlacadh, cuir teachtaireacht chórais leis—agus coinnigh í mar an gcéanna ar fud do chuid samplaí go léir. Tabhair faoi deara sa sampla thíos go bhfuil an treoir “tairg cruinniú taispeána i gcónaí” urramaithe i ndáiríre i bhfreagra an chúntóra: déanann an teachtaireacht chórais cur síos ar shriain, agus léiríonn an sampla conas a fheictear í nuair a chuirtear i bhfeidhm í.

{
  "messages": [
    {
      "role": "system",
      "content": "Is cúntóir díolacháin tú do TechCorp. Freagair go gonta agus go gairmiúil. Tairg cruinniú taispeána i gcónaí."
    },
    {
      "role": "user",
      "content": "Tá mé ag lorg réiteach CRM do mo fhoireann de 50 duine."
    },
    {
      "role": "assistant",
      "content": "Tá CRM TechCorp deartha d'fhoirne de 20 go 200 duine, le bainistíocht teagmhála, píblíne díolacháin, agus tuairisciú comhtháite. D'fhoireann de 50, molaim an plean Gnó ag €29/in úsáideora/mí. Ar mhaith leat taispeántas pearsantaithe a sceidealú an tseachtain seo?"
    }
  ]
}

Comhráite il-chas

Is féidir leat comhráite le malartuithe iolracha a chur san áireamh. Ansin foghlaimíonn an tsamhail comhsheasmhacht a choinneáil thar chasanna: anseo, braitheann an dara freagra ar chéim 2 a fógraíodh sa chéad cheann, rud nach bhféadfadh sampla aonair a mhúineadh.

{
  "messages": [
    {
      "role": "system",
      "content": "Is cúntóir teicniúil tú d'API íocaíochta."
    },
    {
      "role": "user",
      "content": "Conas a chomhtháthaím bhur API íocaíochta?"
    },
    {
      "role": "assistant",
      "content": "Tarlaíonn an comhtháthú i 3 chéim: 1) Suiteáil an SDK le pip install paycorp-sdk, 2) Cumraigh do eochair API, 3) Cruthaigh do chéad íocaíocht. Cén chéim ar mhaith leat tosú léi?"
    },
    {
      "role": "user",
      "content": "Conas a chumraím an eochair API?"
    },
    {
      "role": "assistant",
      "content": "Faigh do eochair ón deasc rialaithe (Socruithe > Eochracha API), ansin cumraigh é i do chód:\n\nfrom paycorp import PayCorp\nclient = PayCorp(api_key=\"your_key\")\n\nÚsáid an eochair tástála (réimír sk_test_) i bhforbairt agus an eochair beo (sk_live_) i dtáirgeadh. Ná déan do chuid eochracha a chur i gcrích sa chód foinse riamh."
    }
  ]
}

Meáchanú le weight

Is féidir leat a chur in iúl don tsamhail cé na teachtaireachtaí cúntóra is tábhachtaí trí réimse weight a chur leis:

{
  "messages": [
    {"role": "user", "content": "Déan achoimre ar an doiciméad seo."},
    {"role": "assistant", "content": "Seo an achoimre...", "weight": 1}
  ]
}

Ciallaíonn weight de 0 nach ndéanfaidh an tsamhail oiliúint ar an teachtaireacht chúntóra sin ar leith; is é 1 an luach réamhshocraithe. Is é an cás úsáide tipiciúil ná comhráite il-chas nach mbaineann ach an cas deireanach leo: coinníonn tú na malartuithe roimhe seo toisc go soláthraíonn siad comhthéacs riachtanach, ach ní mian leat go bhfoghlaimíonn an tsamhail iad a atáirgeadh—socraigh iad go 0 simplí.

Script chruthaithe comhaid JSONL

Go praiticiúil, ní scríobhfaidh tú an comhad seo de láimh riamh. Déanann an fheidhm thíos sraithliostú ar liosta samplaí agus cosnaíonn sí thú ón dá phitfall is coitianta: dearmad a dhéanamh ar an mbriste líne deiridh agus mí láimhseáil ar éalú aicinn.

import json

def create_jsonl_file(examples: list[dict], path: str):
    """Cruthaíonn comhad JSONL ó liosta samplaí."""
    with open(path, "w", encoding="utf-8") as f:
        for example in examples:
            line = json.dumps(example, ensure_ascii=False)
            f.write(line + "\n")
    print(f"Comhad cruthaithe: {path} ({len(examples)} sampla)")

# Do shamplaí
examples = [
    {
        "messages": [
            {"role": "system", "content": "Cúntóir tacaíochta custaiméirí TechCorp."},
            {"role": "user", "content": "Tá mo chuntas glasáilte."},
            {"role": "assistant", "content": "Tuigim do frustrachas. Chun do chuntas a dhíghlasáil, teastaíonn do sheoladh ríomhphoist clárúcháin uaim. Seiceálfaidh mé an stádas agus treoróidh mé tú tríd an bpróiseas athghníomhachtaithe."}
        ]
    },
    {
        "messages": [
            {"role": "system", "content": "Cúntóir tacaíochta custaiméirí TechCorp."},
            {"role": "user", "content": "Conas a athraím mo phasfhocal?"},
            {"role": "assistant", "content": "Chun do phasfhocal a athrú: téigh go Socruithe > Slándáil > Athraigh Pasfhocal. Cuir isteach do phasfhocal reatha, ansin an ceann nua (12 charachtar ar a laghad, le ceannlitir, uimhir, agus carachtar speisialta). Deimhnigh agus cliceáil Sábháil."}
        ]
    }
]

create_jsonl_file(examples, "training_data.jsonl")

Is iad na hearráidí a thiocfaidh ort ná cinn chéanna i gcónaí, agus is féidir iad go léir a bhrath roimh uaslódáil. Cuimsíonn briste líne in easnamh idir dhá oibiacht dhá shampla i líne amháin nach féidir a léamh. Teipeann ar an líne iomlán mar gheall ar JSON míchumtha—comhartha luachana in easnamh, camóg breise. Spreagann content folús earráid bailíochtaithe ar thaobh OpenAI, mar a dhéanann ról cumtha: ní ghlactar ach le system, user, agus assistant. Ar deireadh, scríobh i UTF-8 i gcónaí le ensure_ascii=False, nó casfaidh do charachtair aicinn ina seichimh éalaithe a dhéanfaidh an tsamhail foghlaim go dícheallach a atáirgeadh.

Príomhphointí

  • Líne JSONL amháin = oibiacht JSON amháin = comhrá iomlán amháin
  • Tá teachtaireacht user amháin ar a laghad agus teachtaireacht assistant amháin i ngach comhrá
  • Tá an teachtaireacht system roghnach ach moltar í le haghaidh comhsheasmhachta
  • Úsáid weight: 0 chun casanna áirithe a eisiamh ón oiliúint i gcomhráite il-chas
  • Bailíochtaigh do chomhad JSONL i gcónaí roimh uaslódáil