Fine-tuning għaċ-ċamata tal-funzjonijiet
F'din il-paġna
Aġġornament 2 ta’ Novembru, 2026 — Disponibbiltà tal-fine-tuning. Is-servizz awtonomu ta’ fine-tuning ta’ OpenAI qed jiġi rtirat: mill-7 ta’ Mejju, 2026, l-organizzazzjonijiet li qatt ma użawh ma jistgħux joħolqu aktar impjiegi; mill-2 ta’ Lulju, trid tkun użajt mudell imħarreġ b’fine-tuning fl-aħħar 60 jum; u mill-6 ta’ Jannar, 2027, l-ebda klijent ma jkun jista’ jnieda impjiegi ġodda. Il-mudelli diġà mħarrġa jibqgħu użabbli sakemm il-mudell bażi tagħhom jiġi rtirat. Dan il-kors jibqa’ utli biex tifhem u tisfrutta mudell eżistenti; għal proġetti ġodda, agħti prijorità lill-inġinerija tal-prompt, RAG, u l-evalwazzjonijiet.
Għaliex tagħmel fine-tuning għaċ-ċamata tal-funzjonijiet
Iċ-ċamata tal-funzjonijiet (function calling) tippermetti lill-mudell jiddeċiedi meta u kif jinvoka funzjonijiet esterni. F’dan il-kuntest, il-fine-tuning mhuwiex dwar li taffina l-istil tal-kitba: huwa jsaħħaħ mekkaniżmu ta’ teħid ta’ deċiżjonijiet. Mudell imħarreġ fuq iċ-ċamati tiegħek stess jitgħallem l-ewwel nett jagħżel il-funzjoni t-tajba minn għadd ta’ għażliet disponibbli. Jekk l-app tiegħek jesponi kemm it-tfittxija ta’ slots kif ukoll il-ħolqien ta’ appuntamenti, il-frażi “Nixtieq nara x’inhu disponibbli nhar il-Ħamis” qatt m’għandha ttriggerja booking.
Imbagħad, jitgħallem jiestratta l-parametri t-tajba mit-talba tal-utent—jiġifieri, jikkonverti frażijiet naturali f’valuri li jikkonformaw mal-iskema: “għada fis-2 ta’ wara nofsinhar” issir data u ħin normalizzati. L-istess mekkaniżmu jgħallem riflessi inqas evidenti iżda daqstant kritiċi. Li tkun taf META TSEJJAĦX funzjoni jevita l-pitfall ta’ mudell li jtriggerja għodda fuq sempliċi “bonġu”. U l-katina ta’ ċamati multipli tal-funzjonijiet loġikament—li telenka d-disponibbiltà, imbagħad tibbookja s-slot magħżul—titlob li l-mudell ikun ra sekwenzi sħaħ matul it-taħriġ, mhux ċamati iżolati.
Format tad-data għaċ-ċamata tal-funzjonijiet
L-eżempji tat-taħriġ jinkludu d-definizzjonijiet tal-funzjonijiet (għodod) u ċ-ċamati korrispondenti. Il-messaġġ tal-assistenti ma jġorrx aktar test iżda array tool_calls; ir-riżultat irritornat mis-sistema tiegħek jidher f’messaġġ bir-rwol tool, marbut maċ-ċamata permezz ta’ tool_call_id; l-assistent imbagħad jerġa’ jitkellem biex jifformula r-risposta maħsuba għall-utent. Huwa dan iċ-ċiklu kollu, mhux biss iċ-ċamata, li l-mudell irid jitgħallem jirriproduċi.
{
"messages": [
{
"role": "system",
"content": "You are an assistant that helps manage appointments."
},
{
"role": "user",
"content": "Book me a slot tomorrow at 2 PM with Dr. Martin."
},
{
"role": "assistant",
"tool_calls": [
{
"id": "call_001",
"type": "function",
"function": {
"name": "create_appointment",
"arguments": "{\"date\": \"2026-04-03\", \"time\": \"14:00\", \"practitioner\": \"Dr. Martin\"}"
}
}
]
},
{
"role": "tool",
"tool_call_id": "call_001",
"content": "{\"status\": \"confirmed\", \"id\": \"appt_42\"}"
},
{
"role": "assistant",
"content": "Your appointment with Dr. Martin is confirmed for tomorrow at 2 PM. Reference: APPT-42."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "create_appointment",
"description": "Creates a new medical appointment",
"parameters": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date in YYYY-MM-DD format"
},
"time": {
"type": "string",
"description": "Time in HH:MM format"
},
"practitioner": {
"type": "string",
"description": "Name of the practitioner"
}
},
"required": ["date", "time", "practitioner"]
}
}
},
{
"type": "function",
"function": {
"name": "list_slots",
"description": "Lists available slots for a practitioner",
"parameters": {
"type": "object",
"properties": {
"practitioner": {"type": "string"},
"date": {"type": "string"}
},
"required": ["practitioner"]
}
}
}
]
}
Każijiet ta’ użu komuni
Għażla tal-funzjoni t-tajba
Ħarreġ il-mudell biex jiddistingwi liema funzjoni għandu jsejjaħ abbażi tal-kuntest. Fl-eżempju hawn taħt, it-talba tikkonċerna l-verifika tad-disponibbiltà, mhux li tagħmel riżerva: l-eżempju jsaħħaħ li mistoqsija miftuħa ssejjaħ list_slots, u xejn aktar.
{
"messages": [
{"role": "user", "content": "What slots are free on Thursday with Dr. Martin?"},
{
"role": "assistant",
"tool_calls": [
{
"id": "call_002",
"type": "function",
"function": {
"name": "list_slots",
"arguments": "{\"practitioner\": \"Dr. Martin\", \"date\": \"2026-04-04\"}"
}
}
]
}
],
"tools": ["... same tools as above ..."]
}
LI MA TSEJJAĦX funzjoni
Irriżerva parti mid-dataset tiegħek għal skambji fejn il-mudell m’għandux juża l-ebda funzjoni. Mudell imħarreġ esklużivament fuq iċ-ċamati jidra jipproduċi waħda f’kull pass, anke għal tislima jew mistoqsija ġenerali—imġiba li tfastidja lill-utenti u tiswilek flus fil-backend. Il-kontra-eżempju hawn taħt jieħu ftit linji biss u jelimina klassi sħiħa ta’ żbalji.
{
"messages": [
{"role": "user", "content": "Hello, how are you?"},
{
"role": "assistant",
"content": "Hello! I'm doing well, thanks. How can I help you with your appointments today?"
}
],
"tools": ["... same tools ..."]
}
Estrazzjoni ta’ parametri kumplessi
It-talbiet reali rari huma strutturati. “It-Tnejn li ġej fil-għodu” u “il-kardjologu” iridu jsiru data assoluta, perjodu ta’ ħin, u speċjalità. Dan huwa preċiżament fejn il-mudell bażi jitfixkel l-aktar spiss, allura huwa fejn il-fine-tuning jagħti l-akbar qligħ viżibbli: immultiplika dan it-tip ta’ eżempju minflok każijiet li diġà huma nodfa.
{
"messages": [
{"role": "user", "content": "Cancel my appointment next Monday morning with the cardiologist"},
{
"role": "assistant",
"tool_calls": [
{
"id": "call_003",
"type": "function",
"function": {
"name": "cancel_appointment",
"arguments": "{\"date\": \"2026-04-06\", \"period\": \"morning\", \"specialty\": \"cardiology\"}"
}
}
]
}
],
"tools": ["..."]
}
Skript għat-tħejjija tad-data
Il-bini tal-fajl jibqa’ mekkaniku: funzjoni ta’ assemblaġġ, definizzjoni tal-għodda kondiviża mill-eżempji kollha, lista ta’ każijiet, imbagħad kitba linja b’linja fil-format JSONL. Innota l-użu ta’ json.dumps għall-qasam arguments, li jrid ikun stringa, mhux oġġett.
import json
def create_function_calling_example(
messages: list[dict],
tools: list[dict]
) -> dict:
"""Creates a training example for function calling."""
return {
"messages": messages,
"tools": tools
}
# Tool definitions
tools = [
{
"type": "function",
"function": {
"name": "search_product",
"description": "Searches for a product in the catalog",
"parameters": {
"type": "object",
"properties": {
"query": {"type": "string", "description": "Search terms"},
"category": {"type": "string", "enum": ["electronics", "clothing", "home"]},
"max_price": {"type": "number", "description": "Maximum price in euros"}
},
"required": ["query"]
}
}
}
]
# Training examples
examples = [
create_function_calling_example(
messages=[
{"role": "user", "content": "I'm looking for headphones under 100 euros"},
{
"role": "assistant",
"tool_calls": [{
"id": "call_1",
"type": "function",
"function": {
"name": "search_product",
"arguments": json.dumps({
"query": "headphones",
"category": "electronics",
"max_price": 100
})
}
}]
}
],
tools=tools
)
]
# Save
with open("function_calling_train.jsonl", "w", encoding="utf-8") as f:
for ex in examples:
f.write(json.dumps(ex, ensure_ascii=False) + "\n")
Tnedija tal-impjieg ta’ fine-tuning
L-impjieg jinħoloq eżattament bħall-fine-tuning konversazzjonali: il-format arrikkit huwa rikonoxxut mill-kontenut tal-fajl, mingħajr parametri addizzjonali.
from openai import OpenAI
client = OpenAI()
file = client.files.create(
file=open("function_calling_train.jsonl", "rb"),
purpose="fine-tune"
)
job = client.fine_tuning.jobs.create(
training_file=file.id,
model="gpt-5.6-luna",
suffix="function-calling-v1"
)
L-aħjar prattiki
Ir-riżultat jiddependi l-ewwel fuq id-diversità tad-dataset tiegħek. Kull funzjoni trid tidher diversi drabi, il-frażijiet tal-utent iridu jvarjaw għall-istess intenzjoni, u tibbenefika milli tinkludi każijiet ambigwi akkumpanjati mir-riżoluzzjoni li tqis korretta, mingħajr ma tinsa konversazzjonijiet normali li ma jsejħu l-ebda funzjoni.
Imbagħad hemm ir-realiżmu tal-parametri. L-arguments iridu jaqblu eżattament mal-iskema definita f’tools, b’valuri plawżibbli minflok placeholders bħal “xxx”—mudell imħarreġ fuq valuri foloz se jipproduċihom. Ittestja sistematikament li kull qasam arguments huwa JSON validu: parentesi jew kwotazzjoni nieqsa biżżejjed biex tagħmel l-eżempju inutilizzabbli.
Fl-aħħar nett, hemm il-kwistjoni tal-proporzjonijiet. Għal dataset ta’ 100 eżempju li jkopru 3 funzjonijiet, id-distribuzzjoni hawn taħt tagħti bilanċ tajjeb bejn il-kopertura funzjonali u r-rażina.
| Tip ta’ eżempju | Kwantità |
|---|---|
| Għal kull funzjoni | 25-30 |
| L-ebda ċamata ta’ funzjoni | 10-15 |
| Ċamati f’katina (multi-step) | 5-10 |
Punti Ewlenin
- Il-format jinkludi
toolsbarra minnmessages - Iċ-ċamati tal-funzjonijiet jużaw
tool_callsfil-messaġġ tal-assistent - Inkludi eżempji fejn il-mudell M’GĦANDUX isejjaħ funzjoni
- Varja l-frażijiet għall-istess intenzjoni
- Ivvverifika li l-
argumentskollha huma JSON validu li jikkonforma mal-iskema