Формат на данните: разговори в JSONL
На тази страница
Актуализация от 2 ноември 2026 г. — Наличност на фина настройка. Собствената услуга за фина настройка на OpenAI се премахва поетапно: от 7 май 2026 г. организации, които никога не са я използвали, вече не могат да създават задачи; от 2 юли трябва да сте използвали фина настроен модел през последните 60 дни; а считано от 6 януари 2027 г. никой клиент няма да може да стартира нови задачи. Вече обучените модели остават използваеми до оттеглянето на базовия им модел. Този курс остава полезен за разбиране и използване на съществуващ модел; за нови проекти дайте приоритет на инженерството на подкани (prompt engineering), RAG и оценяването.
Форматът JSONL
JSONL (JSON Lines) е задължителният формат за API за фина настройка на OpenAI. Всеки ред във файла представлява независим JSON обект, описващ пълен пример за обучение. Тази структура Ви позволява да предавате потоково корпус от десетки хиляди примери, без никога да зареждате целия файл в паметта.
{"messages": [{"role": "system", "content": "..."}, {"role": "user", "content": "..."}, {"role": "assistant", "content": "..."}]}
{"messages": [{"role": "system", "content": "..."}, {"role": "user", "content": "..."}, {"role": "assistant", "content": "..."}]}
Основно правило: един ред = един JSON обект = един пример. Не включвайте нови редове вътре в самия JSON обект. С други думи, „форматираният“ с отстъпи JSON от Вашия редактор ще развали файла – това е най-честата причина за отхвърляне при качване.
Структура на разговора
Всеки пример е обект с ключ messages, съдържащ масив от съобщения. Всяко съобщение има role и content. Приети са само три роли:
- system: глобални инструкции за асистента (по избор, но препоръчително)
- user: съобщението на потребителя
- assistant: отговорът, който моделът трябва да се научи да генерира
Минималният формат се състои от един обмен между потребител и асистент. Това е достатъчно, когато желаното поведение не зависи от специфична рамка, например за модел, посветен на една единствена задача.
{
"messages": [
{"role": "user", "content": "Здравей, как си?"},
{"role": "assistant", "content": "Здравей! Готов съм да помогна. Какво мога да направя за теб?"}
]
}
Веднага щом моделът трябва да приеме специфична роля, добавете системно съобщение – и го запазете идентично във всички Ваши примери. Обърнете внимание в примера по-долу, че инструкцията „винаги предлагай демонстрационна среща“ всъщност се спазва в отговора на асистента: системното съобщение описва ограничение, а примерът показва как то изглежда приложено на практика.
{
"messages": [
{
"role": "system",
"content": "Вие сте търговски асистент за TechCorp. Отговаряйте стегнато и професионално. Винаги предлагайте демонстрационна среща."
},
{
"role": "user",
"content": "Търся CRM решение за моя екип от 50 души."
},
{
"role": "assistant",
"content": "Нашият TechCorp CRM е проектиран за екипи от 20 до 200 души, с управление на контакти, търговска фуния и интегрирана отчетност. За екип от 50 души препоръчвам бизнес плана на цена от 29 евро/потребител/месец. Бихте ли искали да насрочите персонализирана демонстрация тази седмица?"
}
]
}
Разговори с много реплики
Можете да включите разговори с множество размени. Тогава моделът се учи да поддържа последователност през репликите: тук вторият отговор надгражда стъпка 2, обявена в първия, нещо, което изолиран пример не би могъл да преподаде.
{
"messages": [
{
"role": "system",
"content": "Вие сте технически асистент за платежно API."
},
{
"role": "user",
"content": "Как да интегрирам вашето платежно API?"
},
{
"role": "assistant",
"content": "Интеграцията става в 3 стъпки: 1) Инсталирайте SDK с pip install paycorp-sdk, 2) Конфигурирайте Вашия API ключ, 3) Създайте първото си плащане. С коя стъпка бихте искали да започнете?"
},
{
"role": "user",
"content": "Как да конфигурирам API ключа?"
},
{
"role": "assistant",
"content": "Вземете ключа си от таблото за управление (Settings > API Keys), след което го конфигурирайте във Вашия код:\n\nfrom paycorp import PayCorp\nclient = PayCorp(api_key=\"your_key\")\n\nИзползвайте тестовия ключ (префикс sk_test_) в разработка и производствения ключ (sk_live_) в продукция. Никога не комитвайте ключовете си в изходния код."
}
]
}
Претегляне с weight
Можете да укажете на модела кои съобщения от асистента са най-важни, като добавите поле weight:
{
"messages": [
{"role": "user", "content": "Обобщи този документ."},
{"role": "assistant", "content": "Ето обобщението...", "weight": 1}
]
}
Стойност 0 за weight означава, че моделът няма да се обучава върху това конкретно съобщение от асистента; стойността по подразбиране е 1. Типичният случай на употреба са разговорите с много реплики, където има значение само последната размяна: запазвате предишните размени, защото осигуряват необходим контекст, но не искате моделът да се учи да ги възпроизвежда – просто ги задайте на 0.
Скрипт за създаване на JSONL файл
На практика никога няма да пишете този файл на ръка. Функцията по-долу сериализира списък с примери и Ви предпазва от двете най-чести грешки: пропускане на крайния нов ред и неправилно екраниране на акценти.
import json
def create_jsonl_file(examples: list[dict], path: str):
"""Creates a JSONL file from a list of examples."""
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"File created: {path} ({len(examples)} examples)")
# Your examples
examples = [
{
"messages": [
{"role": "system", "content": "TechCorp customer support assistant."},
{"role": "user", "content": "My account is locked."},
{"role": "assistant", "content": "I understand your frustration. To unlock your account, I need your registration email address. I'll check the status and guide you through the reactivation process."}
]
},
{
"messages": [
{"role": "system", "content": "TechCorp customer support assistant."},
{"role": "user", "content": "How do I change my password?"},
{"role": "assistant", "content": "To change your password: go to Settings > Security > Change Password. Enter your current password, then the new one (minimum 12 characters, with uppercase, number, and special character). Confirm and click Save."}
]
}
]
create_jsonl_file(examples, "training_data.jsonl")
Грешките, с които ще се сблъскате, винаги са едни и същи и всички могат да бъдат открити преди качването. Липсващ нов ред между два обекта слива два примера в един нечетим ред. Неправилен JSON – липсваща кавичка, излишна запетая – проваля целия ред. Празно content предизвиква грешка при валидиране от страна на OpenAI, както и измислена роля: приети са само system, user и assistant. Накрая, винаги пишете в UTF-8 с ensure_ascii=False, в противен случай Вашите символи с акценти ще се превърнат в escape последователности, които моделът съвестно ще се научи да възпроизвежда.
Ключови изводи
- Един ред JSONL = един JSON обект = един пълен разговор
- Всеки разговор съдържа поне едно съобщение
userи едно съобщениеassistant - Съобщението
systemе по избор, но препоръчително за последователност - Използвайте
weight: 0, за да изключите определени реплики от обучението в разговори с много размени - Винаги валидирайте Вашия JSONL файл преди качване