Arkitettura tas-sejħa tal-funzjonijiet fl-API tar-Risposti
F'din il-paġna
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-tipinput_text, u t-tiftix fuq il-web juża l-għoddaweb_search(web_search_previewissa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijietfichiers_generesutelechargermil-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_idjiżgura t-traċċabbiltà għal kull sejħa - L-
tool_choicejippermettilek tikkontrolla b’mod fin l-imġiba tal-mudell