Ailtireacht glaonna feidhme san API Freagraí
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú OpenAI: éilíonn an uirlis Code Interpreter anois paraiméadar
container(curtha leis i ngach sampla), úsáideann codanna téacs ionchuir an cineálinput_text, agus úsáideann cuardach gréasáin an uirlisweb_search(níl saweb_search_previewach uirlis sheanda gan scagairí fearainn a thuilleadh). Faightear comhaid ghinte trí na feidhmeannafichiers_generesagustelechargeró Cheacht 10. Foinse: Code Interpreter · Cuardach gréasáin.
Ailtireacht glaonna feidhme san API Freagraí
Is é an glaoch feidhme an príomhshásra a ligeann do mhúnlaí OpenAI idirghníomhú leis an domhan lasmuigh. San API Freagraí, athdhearadh an sásra seo chun é a dhéanamh níos láidre, níos intuartha, agus comhtháite go dúchasach le huirlisí ionsuite mar Chuardach Gréasáin agus Code Interpreter.
An bunphrionsabal
Ní dhéanann an múnla aon rud go díreach. Eisíonn sé rúin struchtúrtha a ghabhann do chód agus a chuireann i gcrích iad. D’fhéadfadh sé seo a bheith cosúil le teorainn theicniúil ar an gcéad amharc; i ndáiríre, is é an rogha dearaidh é a fhágann gur féidir gach rud eile a dhéanamh.
Smaoinigh ar an rogha eile. Dá ndéanfadh an múnla gníomhartha leis féin, bheadh ort do chuid dintéir bunachair sonraí, do chuid eochracha API, agus do chuid ceadanna scríofa a thabhairt dó—agus ní bheadh aon phointe agat chun aon rud a fhíorú. Le dí-chúpláil, téann gach rún trí do chód: bailíochtaíonn tú argóintí, forfheidhmíonn tú rialacha gnó, agus diúltaíonn tú más gá. Molann an múnla, déanann do chód an cinneadh deiridh, agus is é an teorainn sin a ligeann duit glaoch feidhme a chur i bhfeidhm sa táirgeadh gan smacht a chailleadh.
from openai import OpenAI
client = OpenAI()
# Dear uirlis chustaim
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
)
Anatamaíocht freagartha
Níl téacs ná glaonna uirlise amháin i bhfreagra: is liosta ilchineálach é output inar féidir an dá rud a mheascadh. Is é an nós atá le forbairt ó do chéad líne cóide ná atriall a dhéanamh ar an liosta seo seachas output[0] a léamh—má mhíníonn múnla a réasúnaíocht sula nglaonn sé feidhm, is é sin díreach an cás a tharlaíonn, agus brisfidh cód a léann an chéad eilimint an lá a chuireann sé trácht leis.
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}")
Tá an call_id riachtanach: nascann sé an glaoch lena thoradh nuair a sheolann tú an freagra ar ais chuig an múnla. Ar ghlaoch amháin, ní thugtar faoi deara é; ar thrí ghlaoch comhthreomhara, is é an t-aon rud é a choscann ort aimsir Lyon a chur i leith an iarratais faoi Marseille. Seol an toradh i gcónaí leis an call_id a fuair tú, riamh le haitheantas a athchruthaíonn tú ar do thaobh féin.
An lúb iomlán
Tá an timthriall ceithre chéim seo doshraithe: tá sé fíor d’aon fheidhm amháin nó fiche, do ghlaoch simplí nó do ghníomhaire a shlabhraíonn deich n-uirlis. Is éard atá sa chastaacht uile a thiocfaidh ort ina dhiaidh sin—comhthreomhaireacht, earráidí, cúltacaí—ná an lúb seo a uirlisiú, gan í a athsholáthar riamh.
import json
# 1. An chéad ghlaoch le huirlisí deartha
response = client.responses.create(
model="gpt-5.6-terra",
input="What is the balance for client [email protected]?",
tools=tools
)
# 2. Braith agus cuir glaonna feidhme i gcrích
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. Seol torthaí ar ais chuig an múnla
response_finale = client.responses.create(
model="gpt-5.6-terra",
input=response.output + resultats,
tools=tools
)
# 4. Cumraíonn an múnla a fhreagra nádúrtha
print(response_finale.output_text)
Príomhdhifríochtaí ó Chat Completions
Tugann an API Freagraí roinnt feabhsuithe ailtireachta leis.
Láimhseáil dhúchasach ar uirlisí ionsuite
Dearann tú uirlisí ionsuite díreach mar a dhéanann tú do chuid feidhmeanna, ach déantar iad a fhorghníomhú ar thaobh OpenAI. Is deas an toradh praiticiúil atá air sin: ní gá duit aon lúb a scríobh dóibh. Glaoann an múnla, faigheann sé an toradh, agus leanann sé air, go léir in aon turas amháin. Ní bhaineann an lúb a tuairiscíodh thuas ach le do chuid feidhmeanna féin—cinn a ritheann ar do mheaisín.
# Measc uirlisí ionsuite agus custaim
tools = [
{"type": "web_search"},
{"type": "code_interpreter", "container": {"type": "auto"}},
{
"type": "function",
"name": "ma_fonction",
"description": "My custom function",
"parameters": {"type": "object", "properties": {}}
}
]
Aitheantóirí glaonna cobhsaí
Faigheann gach glaoch feidhme call_id uathúil a ligeann duit a rianú go beacht cé acu toradh a fhreagraíonn do cé acu glaoch, fiú le glaonna comhthreomhara.
Sreabhsimplíocht
Ní gá róil assistant agus tool a bhainistiú de láimh i dteachtaireachtaí. Glacann an réimse input go díreach le chomhcheangal aschuir roimhe seo le torthaí feidhme.
Cathain a ghlaonn an múnla feidhm?
Cinneann an múnla glaoch a dhéanamh ar fheidhm nuair a éilíonn iarratas an úsáideora faisnéis nach bhfuil aige, nuair a oireann cur síos na feidhme don riachtanas a aithníodh, agus nuair is féidir na paraiméadair riachtanacha a thátal ón gcomhthéacs.
Caithfidh trí choinníoll a bheith comhlíonta dá bhrí sin ag an am céanna, agus tá sé sin úsáideach le haghaidh dífhabhtaithe: nuair nach nglaofar ar fheidhm cé gur chóir, is é an dara ceann beagnach i gcónaí an chúis—cur síos nach gcumhdaíonn an bealach ar chuir an t-úsáideoir a iarratas in iúl. Ligeann an paraiméadar tool_choice duit iompar a fhorchur nuair nach leor an cur síos:
# Lig don mhúnla cinneadh a dhéanamh
tool_choice = "auto"
# Cuir glaoch ar fheidhm shonrach i bhfeidhm go héigneach
tool_choice = {"type": "function", "name": "rechercher_client"}
# Toirmisc gach glaoch feidhme
tool_choice = "none"
# Éiligh glaoch amháin ar a laghad gan a shonrú cé acu ceann
tool_choice = "required"
Príomhphointí
- Is prótacal rúin é an glaoch feidhme, ní prótacal forghníomhaithe
- Is é an lúb glaoch-feidhmiú-fillteadh an patrún bunúsach
- Comhchónaíonn uirlisí ionsuite agus custaim sa tacar
toolscéanna - Cinntíonn
call_idinrianaitheacht do gach glaoch - Ligeann
tool_choiceduit iompar an mhúnla a rialú go beacht