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

Arkitettura tas-sejħa tal-funzjonijiet fl-API tar-Risposti

Lezzjoni 1 / 20 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Arkitettura tas-sejħa tal-funzjonijiet fl-API tar-Risposti
  2. Il-prinċipju fundamentali
  3. Anatomija ta’ risposta
  4. Iċ-ċiklu sħiħ
  5. Differenzi ewlenin mill-Chat Completions
  6. Meta jsejjaħ il-mudell funzjoni?
  7. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru 2026 abbażi tad-dokumentazzjoni ta’ OpenAI: l-għodda Code Interpreter issa teħtieġ parametru container (miżjud mal-eżempji kollha), il-partijiet tat-test tal-input jużaw it-tip input_text, u t-tiftix fuq il-web juża l-għodda web_search (web_search_preview issa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijiet fichiers_generes u telecharger mil-Lezzjoni 10. Sorsi: Code Interpreter · Web search.

Arkitettura tas-sejħa tal-funzjonijiet fl-API tar-Risposti

Is-sejħa tal-funzjonijiet hija l-mekkaniżmu ewlieni li jippermetti lill-mudelli ta’ OpenAI jinteraġixxu mad-dinja ta’ barra. Fl-API tar-Risposti, dan il-mekkaniżmu ġie ddisinjat mill-ġdid biex ikun aktar robust, aktar prevedibbli, u integrat nativament ma’ għodod内置 bħat-Tiftix fuq il-Web u l-Interpretatur tal-Kodiċi.

Il-prinċipju fundamentali

Il-mudell qatt ma jagħmel xejn direttament. Huwa jemetti intenzjonijiet strutturati li l-kodiċi tiegħek jinterċetta u jwettaq. Hekk kif tgħidha, tista’ tidher bħala limitazzjoni teknika; fir-realtà, hija l-għażla tad-disinn li tagħmel kollox possibbli.

Ikkunsidra l-alternattiva. Jekk il-mudell kien iwettaq l-azzjonijiet innifsu, kellu tagħtih il-kredenzjali tad-database tiegħek, iċ-ċwievet tal-API, u l-permessi tal-kitba—u ma jkollok l-ebda punt fejn tivverifika xejn. Bid-diżakkoppjament, kull intenzjoni tgħaddi mill-kodiċi tiegħek: inti tivvalida l-argumenti, timponi r-regoli tan-negozju, u tirrifjuta jekk ikun meħtieġ. Il-mudell jipproponi, il-kodiċi tiegħek jiddeċiedi, u dik il-fruntiera hija dak li jippermettilek tpoġġi s-sejħa tal-funzjonijiet fil-produzzjoni mingħajr ma titlef il-kontroll.

from openai import OpenAI

client = OpenAI()

# Iddikjara għodda personalizzata
tools = [{
    "type": "function",
    "name": "rechercher_client",
    "description": "Search for a client in the CRM by name or email",
    "parameters": {
        "type": "object",
        "properties": {
            "terme": {
                "type": "string",
                "description": "Client name, email, or ID"
            },
            "champ": {
                "type": "string",
                "enum": ["nom", "email", "id"],
                "description": "Field to search in"
            }
        },
        "required": ["terme"]
    }
}]

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Find the client Jean Dupont",
    tools=tools
)

Anatomija ta’ risposta

Risposta ma fihiex jew test jew sejħiet tal-għodod: output hija lista eteroġenja li tista’ tħallat it-tnejn. L-abitudni li għandek tibni mill-ewwel linja tal-kodiċi tiegħek hija li titerja fuq din il-lista minflok taqra output[0]—mudell li jispjega r-raġunament tiegħu qabel ma jsejjaħ funzjoni jipproduċi eżattament dak il-każ, u kodiċi li jaqra l-ewwel element se jinkisser il-jum li jibda jżid kummentarju.

for item in response.output:
    if item.type == "function_call":
        print(f"Call ID  : {item.call_id}")
        print(f"Function : {item.name}")
        print(f"Args     : {item.arguments}")

L-call_id huwa essenzjali: jorbot is-sejħa mar-riżultat tagħha meta tibgħat ir-risposta lura lill-mudell. Fuq sejħa waħda, barely tinnotah; fuq tliet sejħiet paralleli, huwa l-unika ħaġa li tipprevjenik milli tattribwixxi t-temp ta’ Lyon għat-talba dwar Marseille. Dejjem irritorna r-riżultat bl-call_id li rċevejt, qatt mhux b’ID li tirrikostruwixxi int innifsek.

Iċ-ċiklu sħiħ

Dan iċ-ċiklu ta’ erba’ passi huwa invarjanti: japplika għal funzjoni waħda jew għoxrin, għal sejħa sempliċi jew għal aġent li jgħaqqad għaxar għodod. Il-kumplessità kollha li se tiltaqa’ magħha aktar tard—paralleliżmu, żbalji, fallbacks—tikkonsisti fl-istrumentazzjoni ta’ dan iċ-ċiklu, qatt mhux fis-sostituzzjoni tiegħu.

import json

# 1. L-ewwel sejħa bl-għodod iddikjarati
response = client.responses.create(
    model="gpt-5.6-terra",
    input="What is the balance for client [email protected]?",
    tools=tools
)

# 2. Skopri u wettaq is-sejħiet tal-funzjonijiet
resultats = []
for item in response.output:
    if item.type == "function_call":
        if item.name == "rechercher_client":
            args = json.loads(item.arguments)
            resultat = votre_crm.rechercher(args["terme"])
            resultats.append({
                "type": "function_call_output",
                "call_id": item.call_id,
                "output": json.dumps(resultat)
            })

# 3. Ibghat ir-riżultati lura lill-mudell
response_finale = client.responses.create(
    model="gpt-5.6-terra",
    input=response.output + resultats,
    tools=tools
)

# 4. Il-mudell jifformula r-risposta naturali tiegħu
print(response_finale.output_text)

Differenzi ewlenin mill-Chat Completions

L-API tar-Risposti ġġib diversi titjib arkitettoniku.

Ġestjoni nativa tal-għodod内置

L-għodod内置 huma ddikjarati eżattament bħall-funzjonijiet tiegħek, iżda jiġu eżegwiti fuq in-naħa ta’ OpenAI. Ir-riżultat prattiku huwa pjaċevoli: ma tikteb l-ebda ċiklu għalihom. Il-mudell isejjaħ, jikseb ir-riżultat, u jkompli, kollox f’viġġ wieħed. Iċ-ċiklu deskritt hawn fuq jikkonċerna biss il-funzjonijiet tiegħek—dawk li qed jaħdmu fuq il-magna tiegħek.

# Ħallat għodod内置 u personalizzati
tools = [
    {"type": "web_search"},
    {"type": "code_interpreter", "container": {"type": "auto"}},
    {
        "type": "function",
        "name": "ma_fonction",
        "description": "My custom function",
        "parameters": {"type": "object", "properties": {}}
    }
]

Identifikaturi stabbli tas-sejħiet

Kull sejħa ta’ funzjoni tirċievi call_id uniku li jippermettilek traċċa preċiżament liema riżultat jikkorrispondi għal liema sejħa, anke b’sejħiet paralleli.

Fluss issimplifikat

L-ebda ħtieġa li timmanwalja r-rwoli assistant u tool fil-messaġġi. Il-qasam input jaċċetta direttament il-konkatenazzjoni tal-outputs preċedenti mar-riżultati tal-funzjonijiet.

Meta jsejjaħ il-mudell funzjoni?

Il-mudell jiddeċiedi li jsejjaħ funzjoni meta t-talba tal-utent teħtieġ informazzjoni li m’għandux, meta d-deskrizzjoni tal-funzjoni taqbel mal-ħtieġa identifikata, u meta l-parametri meħtieġa jistgħu jiġu inferiti mill-kuntest.

Għalhekk, tliet kundizzjonijiet iridu jiġu ssodisfati simultanjament, u dan huwa utli għad-debugging: meta funzjoni ma tiġix imsejħa għalkemm għandha tkun, il-kawża hija kważi dejjem it-tieni waħda—deskrizzjoni li ma tkoprix il-mod kif l-utent ifformula t-talba tiegħu. Il-parametru tool_choice jippermettilek tifforza l-imġiba meta d-deskrizzjoni ma tkunx biżżejjed:

# Ħalli lill-mudell jiddeċiedi
tool_choice = "auto"

# Forża sejħa għal funzjoni speċifika
tool_choice = {"type": "function", "name": "rechercher_client"}

# Ipprojbi s-sejħiet kollha tal-funzjonijiet
tool_choice = "none"

# Itlob mill-inqas sejħa waħda mingħajr ma tispeċifika liema
tool_choice = "required"

Punti Ewlenin

  • Is-sejħa tal-funzjonijiet hija protokoll ta’ intenzjoni, mhux protokoll ta’ eżekuzzjoni
  • Iċ-ċiklu sejħa-eżekuzzjoni-ritorn huwa l-mudell fundamentali
  • L-għodod内置 u dawk personalizzati jikkoegżistu fl-istess array tools
  • L-call_id jiżgura t-traċċabbiltà għal kull sejħa
  • L-tool_choice jippermettilek tikkontrolla b’mod fin l-imġiba tal-mudell