Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Fine-tuning għaċ-ċamata tal-funzjonijiet

Lezzjoni 9 / 16 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Għaliex tagħmel fine-tuning għaċ-ċamata tal-funzjonijiet
  2. Format tad-data għaċ-ċamata tal-funzjonijiet
  3. Każijiet ta’ użu komuni
  4. Skript għat-tħejjija tad-data
  5. Tnedija tal-impjieg ta’ fine-tuning
  6. L-aħjar prattiki
  7. Punti Ewlenin

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żempjuKwantità
Għal kull funzjoni25-30
L-ebda ċamata ta’ funzjoni10-15
Ċamati f’katina (multi-step)5-10

Punti Ewlenin

  • Il-format jinkludi tools barra minn messages
  • Iċ-ċamati tal-funzjonijiet jużaw tool_calls fil-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-arguments kollha huma JSON validu li jikkonforma mal-iskema