Datņu formāts: JSONL sarunas
Šajā lapā
Atjauninājums 2026. gada 2. novembrī — Smalkās noregulēšanas pieejamība. OpenAI pašapkalpošanās smalkās noregulēšanas pakalpojums tiek pakāpeniski izbeigts: kopš 2026. gada 7. maija organizācijas, kas to nekad nav izmantojušas, vairs nevar izveidot uzdevumus; kopš 2. jūlija jums ir jābūt izmantojušam smalki noregulētu modeli pēdējo 60 dienu laikā; un sākot ar 2027. gada 6. janvāri, neviens klients vairs nevarēs uzsākt jaunus uzdevumus. Jau apmācītie modeļi paliek lietojami, līdz tiek izslēgts to bāzes modelis. Šis kurss joprojām ir noderīgs, lai saprastu un izmantotu esošu modeli; jauniem projektiem dodiet priekšroku uzvedņu inženierijai (prompt engineering), RAG un novērtējumiem.
JSONL formāts
JSONL (JSON Lines) ir obligātais formāts OpenAI smalkās noregulēšanas API. Katra rinda failā ir neatkarīgs JSON objekts, kas attēlo vienu pilnu apmācības piemēru. Šī struktūra ļauj straumēt desmitiem tūkstošu piemēru korpusu, nekad neielādējot visu failu atmiņā.
{"messages": [{"role": "system", "content": "..."}, {"role": "user", "content": "..."}, {"role": "assistant", "content": "..."}]}
{"messages": [{"role": "system", "content": "..."}, {"role": "user", "content": "..."}, {"role": "assistant", "content": "..."}]}
Pamatlikums: viena rinda = viens JSON objekts = viens piemērs. Neiekļaujiet rindu pārrāvumus paša JSON objekta iekšienē. Citiem vārdiem sakot, jūsu redaktora ģenerēts “skaisti noformēts” (pretty-printed) JSON ar atkāpēm sabojās failu — tas ir visbiežākais augšupielādes noraidīšanas iemesls.
Sarunas struktūra
Katrs piemērs ir objekts ar atslēgu messages, kas satur ziņojumu masīvu. Katram ziņojumam ir role (loma) un content (saturs). Tiek pieņemtas tikai trīs lomas:
- system: globālās instrukcijas asistentam (neobligāti, bet ieteicams)
- user: lietotāja ziņojums
- assistant: atbilde, ko modelim ir jāiemācās ģenerēt
Minimālais formāts sastāv no viena lietotāja/asistenta apmaiņas cikla. Tas ir pietiekami, ja vēlamā uzvedība nav atkarīga no specifiska ietvara, piemēram, modelim, kas veltīts vienam konkrētam uzdevumam.
{
"messages": [
{"role": "user", "content": "Sveiki, kā jums klājas?"},
{"role": "assistant", "content": "Sveiki! Esmu gatavs palīdzēt. Ko varu darīt jūsu labā?"}
]
}
Tiklīdz modelim ir jāieņem specifiska loma, pievienojiet sistēmas ziņojumu — un saglabājiet to identisku visos piemēros. Ņemiet vērā zemāk esošajā piemērā, ka instrukcija „vienmēr piedāvāt demonstrācijas tikšanos” faktiski tiek ievērota asistenta atbildē: sistēmas ziņojums apraksta ierobežojumu, un piemērs parāda, kā tas izskatās pielietojumā.
{
"messages": [
{
"role": "system",
"content": "Jūs esat TechCorp pārdošanas asistents. Atbildiet kodolīgi un profesionāli. Vienmēr piedāvājiet demonstrācijas tikšanos."
},
{
"role": "user",
"content": "Meklēju CRM risinājumu savai 50 cilvēku komandai."
},
{
"role": "assistant",
"content": "Mūsu TechCorp CRM ir paredzēts komandām no 20 līdz 200 cilvēkiem, piedāvājot kontaktu pārvaldību, pārdošanas piltuvi un integrētu ziņošanu. 50 cilvēku komandai iesaku Biznesa plānu par 29 EUR/lietotājs/mēnesī. Vai vēlaties šonedēļ ieplānot personalizētu demonstrāciju?"
}
]
}
Daudzu gājienu sarunas
Jūs varat iekļaut sarunas ar vairākiem apmaiņas cikliem. Tad modelis iemācās uzturēt konsekvenci visā sarunas gaitā: šeit otrā atbilde balstās uz pirmajā solī paziņoto 2. soli, ko izolēts piemērs nevarētu iemācīt.
{
"messages": [
{
"role": "system",
"content": "Jūs esat tehniskais asistents maksājumu API jomā."
},
{
"role": "user",
"content": "Kā integrēt jūsu maksājumu API?"
},
{
"role": "assistant",
"content": "Integrācija notiek 3 soļos: 1) Instalējiet SDK ar pip install paycorp-sdk, 2) Konfigurējiet savu API atslēgu, 3) Izveidojiet savu pirmo maksājumu. Ar kuru soli vēlaties sākt?"
},
{
"role": "user",
"content": "Kā konfigurēt API atslēgu?"
},
{
"role": "assistant",
"content": "Iegūstiet savu atslēgu no vadības paneļa (Settings > API Keys), pēc tam konfigurējiet to savā kodā:\n\nfrom paycorp import PayCorp\nclient = PayCorp(api_key=\"your_key\")\n\nIzstrādes vidē izmantojiet testa atslēgu (prefikss sk_test_), bet ražošanas vidē — dzīvo atslēgu (sk_live_). Nekad neiekļaujiet savas atslēgas pirmkoda krātuvē."
}
]
}
Svarošana ar weight
Jūs varat norādīt modelim, kuri asistenta ziņojumi ir vissvarīgākie, pievienojot lauku weight:
{
"messages": [
{"role": "user", "content": "Apkopojiet šo dokumentu."},
{"role": "assistant", "content": "Šeit ir kopsavilkums...", "weight": 1}
]
}
weight vērtība 0 nozīmē, ka modelis nemācīsies no šī konkrētā asistenta ziņojuma; noklusējuma vērtība ir 1. Tipisks lietojuma gadījums ir daudzgājienu sarunas, kur svarīgs ir tikai pēdējais gājiens: jūs saglabājat iepriekšējos apmaiņas ciklus, jo tie nodrošina nepieciešamo kontekstu, bet nevēlaties, lai modelis mācītos tos reproducēt — vienkārši iestatiet tiem vērtību 0.
JSONL faila izveides skripts
Praksē jūs nekad nerakstīsiet šo failu ar roku. Zemāk esošā funkcija serializē piemēru sarakstu un pasargā jūs no divām visbiežāk sastopamajām kļūdām: aizmirstas beigu rindu pārrāvuma un nepareizas akcentētu simbolu apstrādes.
import json
def create_jsonl_file(examples: list[dict], path: str):
"""Izveido JSONL failu no piemēru saraksta."""
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"Fails izveidots: {path} ({len(examples)} piemēri)")
# Jūsu piemēri
examples = [
{
"messages": [
{"role": "system", "content": "TechCorp klientu atbalsta asistents."},
{"role": "user", "content": "Mans konts ir bloķēts."},
{"role": "assistant", "content": "Saprotu jūsu vilšanos. Lai atbloķētu kontu, man nepieciešama jūsu reģistrācijas e-pasta adrese. Pārbaudīšu statusu un vadīšu jūs cauri reaktivācijas procesam."}
]
},
{
"messages": [
{"role": "system", "content": "TechCorp klientu atbalsta asistents."},
{"role": "user", "content": "Kā nomainīt paroli?"},
{"role": "assistant", "content": "Lai nomainītu paroli: dodieties uz Settings > Security > Change Password. Ievadiet pašreizējo paroli, tad jauno (minimāli 12 rakstzīmes, ar lielo burtu, ciparu un speciālo simbolu). Apstipriniet un noklikšķiniet Saglabāt."}
]
}
]
create_jsonl_file(examples, "training_data.jsonl")
Kļūdas, ar kurām saskarsieties, vienmēr ir vienādas, un visas tās var noteikt pirms augšupielādes. Trūkstošs rindu pārrāvums starp diviem objektiem sapludina divus piemērus vienā nelasāmā rindā. Nepareizs JSON — trūkstoša pēdiņa, lieka komats — padara visu rindu nederīgu. Tukšs content izraisa validācijas kļūdu OpenAI pusē, tāpat kā izgudrota loma: tiek pieņemtas tikai system, user un assistant. Visbeidzot, vienmēr rakstiet UTF-8 kodējumā ar ensure_ascii=False, pretējā gadījumā jūsu akcentētās rakstzīmes pārvērtīsies ekvivalences secībās (escape sequences), kuras modelis apzinīgi iemācīsies reproducēt.
Galvenās atziņas
- Viena JSONL rinda = viens JSON objekts = viena pilna saruna
- Katra saruna satur vismaz vienu
userziņojumu un vienuassistantziņojumu systemziņojums ir neobligāts, bet ieteicams konsekvences nodrošināšanai- Izmantojiet
weight: 0, lai izslēgtu noteiktus sarunas gājienus no apmācības daudzgājienu sarunās - Vienmēr validējiet savu JSONL failu pirms augšupielādes