Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Ailtireacht glaonna feidhme san API Freagraí

Ceacht 1 as 20 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Ailtireacht glaonna feidhme san API Freagraí
  2. An bunphrionsabal
  3. Anatamaíocht freagartha
  4. An lúb iomlán
  5. Príomhdhifríochtaí ó Chat Completions
  6. Cathain a ghlaonn an múnla feidhm?
  7. Príomhphointí

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ál input_text, agus úsáideann cuardach gréasáin an uirlis web_search (níl sa web_search_preview ach uirlis sheanda gan scagairí fearainn a thuilleadh). Faightear comhaid ghinte trí na feidhmeanna fichiers_generes agus telecharger ó 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 tools céanna
  • Cinntíonn call_id inrianaitheacht do gach glaoch
  • Ligeann tool_choice duit iompar an mhúnla a rialú go beacht