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

Seoladh Mionchoigeartú tríd an API

Ceacht 5 as 16 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Forbhreathnú ar an bPróiseas
  2. An SDK a Shuiteáil agus a Chumrú
  3. Comhaid a Uaslódáil
  4. An Jab Mionchoigeartaithe a Chruthú
  5. Dul chun cinn a Rianú
  6. An Múnla Mionchoigeartaithe a Úsáid
  7. Do Chuid Jabanna a Bhainistiú
  8. Costais agus Fad Ama
  9. Príomhphointí

Nuashonrú 2 Samhain, 2026 — Fáilteacht mionchoigeartaithe. Tá an tseirbhís fhéinseirbhíse mionchoigeartaithe ó OpenAI á céimniú amach: ón 7 Bealtaine, 2026, ní féidir le heagraíochtaí nach rith jab mionchoigeartaithe riamh ceann nua a chruthú; ón 2 Iúil, caithfidh tú múnla mionchoigeartaithe a bheith úsáidte agat laistigh de na 60 lá roimhe sin; agus ag tosú 6 Eanáir, 2027, ní bheidh aon chustaiméir in ann jabanna nua a sheoladh. Fanann múnlaí atá traenáilte cheana inúsáidte go dtí go gcuirtear an bunmhúnla ar scor. Tá an cúrsa seo fós úsáideach chun múnla atá ann cheana a thuiscint agus a shaothrú; do thionscadail nua, tabhair tosaíocht d’innealtóireacht leideanna, RAG, agus meastóireachtaí.

Forbhreathnú ar an bPróiseas

Tá do chuid sonraí réidh, bailíochtaithe, agus roinnte ina sraitheanna traenála agus bailíochtaithe. Tagann an chéim iarbhír traenála anuas ar thrí ghluaiseacht: uaslódáil do chomhad sonraí, cruthaigh jab mionchoigeartaithe, ansin fan go gcríochnóidh an traenáil. Téann gach rud tríd an SDK oifigiúil Python, agus feicfidh tú go n-oireann an cód do thart ar thríocha líne—rinneadh an chuid is mó den obair thuas an sruth.

An SDK a Shuiteáil agus a Chumrú

Déantar an cliant a shamhlú gan aon argóintí: léann sé an athróg timpeallachta OPENAI_API_KEY go huathoibríoch.

# Suiteáil
# pip install openai

from openai import OpenAI

# Úsáideann an cliant an athróg timpeallachta OPENAI_API_KEY go huathoibríoch
client = OpenAI()

Déan cinnte go bhfuil an athróg seo socraithe sula rithfidh tú an script, nó teipfidh ar an samhlú ag an gcéad iarratas. I dtimpeallacht táirgeachta, ná cuir do eochair i gcruth cruaidh sa chód riamh: críochnaíonn eochair atá scríofa i ngnáth-théacs i stair Git, agus is i bhfad costasaí é a bhaint tar éis an fhíric ná é a léamh ón timpeallacht ón chéad lá.

Comhaid a Uaslódáil

Úsáideann an uaslódáil purpose="fine-tune", a insíonn do OpenAI go bhfuil an comhad beartaithe le haghaidh traenála agus a spreagann na seiceálacha formáide comhfhreagracha. Uaslódáil an comhad bailíochtaithe láithreach: tá sé roghnach go teicniúil, ach gan é, ritheann an traenáil dall, ós rud é nach gcuirfidh aon chaillteanas bailíochtaithe in iúl ró-oiriúnú agus an jab á rith.

# Uaslódáil comhad traenála
training_file = client.files.create(
    file=open("training_data.jsonl", "rb"),
    purpose="fine-tune"
)

print(f"File ID: {training_file.id}")
print(f"Status: {training_file.status}")

# Roghnach: uaslódáil comhad bailíochtaithe
validation_file = client.files.create(
    file=open("validation_data.jsonl", "rb"),
    purpose="fine-tune"
)

print(f"Validation ID: {validation_file.id}")

Téann an comhad tríd céim próiseála ar thaobh OpenAI. Fan go mbeidh an stádas processed sula seolfaidh tú an jab: teipfidh ar jab a chruthaítear ar chomhad atá fós á phróiseáil, agus caillfidh tú cúpla nóiméad ag lorg cúise nach bhfuil ann i do JSONL.

An Jab Mionchoigeartaithe a Chruthú

job = client.fine_tuning.jobs.create(
    training_file=training_file.id,
    validation_file=validation_file.id,  # roghnach ach molta
    model="gpt-5.6-luna",  # nó "gpt-5.6-luna"
    suffix="my-assistant-v1"  # iarmhír chun do mhúnla a aithint
)

print(f"Job ID: {job.id}")
print(f"Status: {job.status}")
print(f"Base model: {job.model}")

Cuirtear an paraiméadar suffix le hainm do mhúnla mhionchoigeartaithe: le "my-assistant-v1", ainmneofar an múnla mar thoradh air ft:gpt-5.6-luna:your-org::my-assistant-v1:xxxxxxxx. Bíodh sé de nós agat an cás úsáide agus uimhir leagan a chur ann. An lá a bheidh trí mhúnla i do chuntas, is é sin an t-aon rud a ligfidh duit a fháil amach cé acu a dhéanann cad gan an consól a oscailt.

Dul chun cinn a Rianú

Téann jab trí roinnt stádas i ndiaidh a chéile, agus tugann retrieve an ceann reatha duit ag am ar bith.

# Faigh stádas an jaba
job = client.fine_tuning.jobs.retrieve(job.id)
print(f"Status: {job.status}")
# Stádas féideartha: validating_files, queued, running, succeeded, failed, cancelled

Fanann an stádas féin gonta. Ina ionad sin, insíonn na himeachtaí an scéal: bailíochtú comhaid, tosú, dul chun cinn céim ar chéim, deireadh.

# Féach ar imeachtaí an jaba
events = client.fine_tuning.jobs.list_events(
    fine_tuning_job_id=job.id,
    limit=20
)

for event in events.data:
    print(f"[{event.created_at}] {event.message}")

In ionad retrieve a ghlaoghand go láimhe gach cúig nóiméad, cuimsigh an fanacht i lúb a thugann smacht ar ais chomh luath agus a shroicheann an jab stádas críche. Tabhair faoi deara go ndéileáiltear leis na trí chás scortha ar leithligh: ní jab teipthe é jab a cealaíodh, agus ba mhaith leat idirdhealú a dhéanamh eatarthu i do logaí.

import time

def track_job(client: OpenAI, job_id: str, interval: int = 30):
    """Rianaíonn sé jab mionchoigeartaithe go dtí go gcríochnaíonn sé."""
    while True:
        job = client.fine_tuning.jobs.retrieve(job_id)
        print(f"Status: {job.status}")

        if job.status == "succeeded":
            print(f"Fine-tuned model: {job.fine_tuned_model}")
            return job

        if job.status == "failed":
            print(f"Failure: {job.error}")
            return job

        if job.status == "cancelled":
            print("Job cancelled.")
            return job

        time.sleep(interval)

# Úsáid
final_job = track_job(client, job.id)

An Múnla Mionchoigeartaithe a Úsáid

Nuair a chríochnaíonn an jab go rathúil, glaotar ar do mhúnla díreach mar a ghlaofaí ar ghnáthmhúnla. Ní athraíonn ach an luach a thugtar do model, rud a chiallaíonn go dtagann aistriú chuig do mhúnla saincheaptha anuas, in iarratas atá ann cheana, ar athróg cumraíochta a mhodhnú.

response = client.responses.create(
    model=final_job.fine_tuned_model,  # m.sh. "ft:gpt-5.6-luna:org::suffix:xxxxxxxx"
    input="Hello, I have a problem with my order."
)

print(response.output_text)

Do Chuid Jabanna a Bhainistiú

Tá dhá ghlaoch leordhóthanach chun gach rud a riar: liostaigh na rudaí atá ann, agus cuir isteach ar na rudaí atá ag rith. Tá an cealú úsáideach chomh luath agus a léiríonn monatóireacht go bhfuil an traenáil ag dul ar strae—níl aon phointe le híoc as tokenaí ó jab a bhfuil a fhios agat cheana go dtáirgfear múnla dona leis.

# Liostaigh do chuid jabanna mionchoigeartaithe go léir
jobs = client.fine_tuning.jobs.list(limit=10)
for j in jobs.data:
    print(f"{j.id} | {j.status} | {j.model} | {j.fine_tuned_model}")

# Cealaigh jab atá ag rith
client.fine_tuning.jobs.cancel(job.id)

Costais agus Fad Ama

Billeáiltear an traenáil de réir líon na tokenaí a phróiseáiltear. Braitheann an fad ama, ar an láimh eile, ar mhéid do chuid sonraí agus ar líon na n-éabhlóidí (epochs).

Méid an tacair shonraíFad na traenála
50 samplaCúpla nóiméad
500 sampla15 go 30 nóiméad
5,000 sampla1 go 2 uair an chloig

Cuidíonn na hordú méide seo go príomha leat do lúb oibre a mhéadú: ag cúpla nóiméad in aghaidh an rith, déanann tú athrá sa seisiún céanna; ag dhá uair an chloig, déanann tú pleanáil. Athraíonn praghsanna cruinne de réir an mhúnla a roghnaíodh; seiceáil leathanach praghsála OpenAI le haghaidh rátaí reatha.

Príomhphointí

  • Is é an sruth oibre ná: uaslódáil comhad, cruthaigh jab, fan, úsáid an múnla
  • Cuir suffix cur síosach leis chun do mhúnlaí a aithint go héasca
  • Úsáid comhad bailíochtaithe i gcónaí chun cáilíocht a mheas
  • Úsáidtear an múnla mionchoigeartaithe díreach mar an mbunmhúnla tríd an API
  • Coinnigh do chuid IDanna jab agus múnla—beidh ort iad a bheith agat le haghaidh leaganú