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

Códú Gníomhach le Glaoch Uirlisí

Ceacht 6 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cad é códú gníomhach?
  2. An timthriall gníomhach
  3. Sampla oibre: fabht a shocrú
  4. Úsáid uirlisí sa chleachtas
  5. Lúb ghníomhach il-chasadh
  6. Príomhphointí

An ceacht nuashonraithe an 2 Samhain, 2026. Bhain na samplaí bunaidh úsáid as Devstral, a baineadh den API ar an 31 Iúil, 2026. Úsáideann siad Mistral Small 4 (mistral-small-2603) anois, agus leanann an lúb ghníomhach samhail doiciméadúcháin Mistral (déantar próiseáil ar ghlaochanna uirlisí go léir i bhfreagra go dtí an freagra deiridh). Foinse: Function calling.

Cad é códú gníomhach?

Athraíonn códú gníomhach nádúr na hiarrata a dhéanann tú ar an tsamhail. In ionad iarratas a dhéanamh ar shnippet amháin, ansin ceann eile, ansin tríú ceann, agus iad a ghreamú le chéile tú féin, sannann tú tasc iomlán. Réitíonn an tsamhail é trí na céimeanna a shlabhrú léi féin: taiscéalaíocht, pleanáil, cur chun feidhme, agus fíorú. Fanann tusa mar an cinnteoir maidir leis an méid atá le déanamh, ach stopann tú micribhainistiú a dhéanamh ar gach gluaiseacht.

Tógadh samhlacha Devstral don sruth oibre seo; déileálann samhlacha ginearálta reatha, faoi cheannas Mistral Small 4, leis trí ghlaoch uirlisí. Ní fhreagraíonn gníomhaire ceist amháin; gníomhaíonn sé ar an stór.

An timthriall gníomhach

Céim 1 — Tuiscint a fháil

Tosaíonn an gníomhaire i gcónaí trí dhul i dtír. Léann sé struchtúr na bhfillteán agus na gcomhad, aithníonn sé comhaid atá ábhartha don tasc a iarradh, rianaíonn sé spleáchais idir modúil chun a fheiceáil cad a d’fhéadfadh tionchar a bheith ag athrú air, agus tugann sé faoi deara comhthéacsanna atá ann cheana—ainmniú, eagrú tástála, agus patrúin athfhillteacha. Dealraíonn an chéim seo mar bheith neamhtháirgiúil toisc nach scríobhann sí aon chód, ach cinneann sí an mbeidh an cód a thiocfaidh as cosúil le do chuidse nó le cód strainséara.

Céim 2 — Pleanáil

Sula scríobhann sé líne amháin, cumann an gníomhaire plean. Briseann sé an tasc ina fhochúraí ordaithe, déanann sé idirdhealú idir comhaid le modhnú agus cinn le cruthú, tuarann sé fo-iarsmaí agus rioscaí cúlaithe, agus socraíonn sé cur chuige teicniúil. Seo nuair is saoire do rannpháirtíocht: tógann sé tríocha soicind plean a cheartú; tógann sé i bhfad níos faide deich gcomhad a scríobh tú cheana a cheartú.

Céim 3 — Cur chun feidhme

Leathnaíonn an cur chun feidhme an plean céim ar chéim. Cuirfidh an gníomhaire comhaid atá ann cheana in eagar, cruthóidh sé cinn nua nuair a éilíonn an struchtúr é, nuashonróidh sé allmhairithe agus spleáchais a d’aistrigh de bharr a chuid athruithe, agus coigeartóidh sé comhaid cumraíochta ar an mbealach. Is é an chomhsheasmhacht trasna na n-athruithe seo go díreach an rud nach féidir le samhail chríochnaithe a ráthú.

Céim 4 — Fíorú

Tagann an chruthúnas go seasann an obair an fód sa deireadh. Rithfidh an gníomhaire an tsraith tástála atá ann, scríobhfaidh sé tástálacha nua don chód a chuir sé leis díreach, cinnteoidh sé go n-éiríonn leis an tógáil, agus déanfaidh sé athbhreithniú ar a dhifríocht féin ar earráidí nó ar mhodhnuithe eachtracha. Táirgeann gníomhaire a scipeálann an chéim seo cód atá inchreidte, ní cód atá ceart.

Sampla oibre: fabht a shocrú

Cuir i gcás go ndeir tú leis an ngníomhaire: “Faigheann úsáideoirí earráid 500 nuair a chuireann siad foirm isteach le ríomhphost ina bhfuil ’+’.” Glacfaidh an timthriall an fhoirm seo ansin:

1. TUISCINT A FHÁIL
   -> Cuardaigh comhaid a bhaineann leis an bhfoirm (cuardaigh "email" sa chód)
   -> Léigh an rialtóir a láimhseálann an cur isteach
   -> Léigh an fheidhm bailíochtaithe ríomhphoist
   -> Aithin an regex a dhiúltaíonn '+'

2. PLEANÁIL
   -> Modhnigh an regex bailíochtaithe chun '+' a ghlacadh
   -> Cuir tástáil aonaid le haghaidh ríomhphoist le '+'
   -> Fíoraigh nach scagann aon chuid eile den chód '+' amach

3. CUR CHUN FEIDHME
   -> Modhnigh src/validators/email.py: socraigh an patrún regex
   -> Cruthaigh tests/test_email_validation.py: cuir cásanna le '+' leis
   -> Modhnigh src/controllers/form.py: cuir logáil le haghaidh dífhabhtaithe

4. FÍORÚ
   -> Rith pytest -> éiríonn le gach tástáil
   -> Seiceáil difríocht -> tá na hathruithe comhsheasmhach agus íosta

Tabhair faoi deara an tríú líne den phlean: ní shocraíonn an gníomhaire an áit a mbíonn an fhabht le feiceáil amháin; seiceálann sé nach ndiúltaíonn aon scagaire eile an carachtar in áit eile. Is é an cuardach seo ar an mbunús, seachas ar an siomptóm amháin, an rud a dhéanann idirdhealú idir socruithe gníomhacha agus paiste poncúil.

Úsáid uirlisí sa chleachtas

Gníomhaíonn an gníomhaire ar a thimpeallacht trí ghlaonna feidhme. Dearbhaíonn tú na huirlisí atá ar fáil san iarratas, lena n-ainm, a gcur síos, agus a scéama paraiméadair; roghnaíonn an tsamhail cé acu cinn a ghlaofar agus le cad iad na hargóintí.

# Sampla de chomhrá gníomhach
messages = [
    {
        "role": "user",
        "content": "Cuir bailíochtú pasfhocail láidir leis an modúl auth."
    }
]

tools = [
    {
        "type": "function",
        "function": {
            "name": "read_file",
            "description": "Léigh inneachar comhaid tionscadail",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {"type": "string", "description": "Conair an chomhaid"}
                },
                "required": ["path"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "write_file",
            "description": "Scríobh nó modhnigh comhad tionscadail",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {"type": "string"},
                    "content": {"type": "string"}
                },
                "required": ["path", "content"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "run_command",
            "description": "Feidhmigh ordú blaoisce",
            "parameters": {
                "type": "object",
                "properties": {
                    "command": {"type": "string"}
                },
                "required": ["command"]
            }
        }
    }
]

response = client.chat.complete(
    model="mistral-small-2603",
    messages=messages,
    tools=tools,
    tool_choice="auto",   # luach réamhshocraithe: cinneann an tsamhail an bhfuil glaoch ar uirlis le déanamh
)

Don iarratas seo, tosaíonn an seicheamh tipiciúil le read_file("src/auth/validators.py") chun an cód atá ann a thuiscint, leanann sé ar aghaidh le read_file("tests/test_auth.py") chun formáid na dtástálacha reatha a fheiceáil, ansin bogann sé chuig scríobh: write_file("src/auth/validators.py", ...) leis an riail bhailíochtaithe bhreise, write_file("tests/test_auth.py", ...) leis na cásanna nua, agus ar deireadh run_command("pytest tests/test_auth.py") chun fíorú a dhéanamh. Tá tábhacht leis an ord: trí oscailt an dá chomhad sula mbaintear tadhall as carachtar amháin, piocann an gníomhaire do chomhthéacsanna agus atáirgeann sé iad, in ionad cinn a d’fhaca sé in áit eile a allmhairiú.

Lúb ghníomhach il-chasadh

Ní tharlaíonn aon cheann de seo i nglaoch amháin. Is é croílár an chódaithe ghníomhaigh ná an lúb il-chasadh: molann an tsamhail gníomh, déanann do chód é a fheidhmiú, agus seolann tú an toradh ar ais ionas gur féidir léi cinneadh a dhéanamh faoin gcéad chéim eile. Coinníonn tú smacht ar an bhfeidhmiú iarbhír, a fheidhmíonn freisin mar do ráthóg sábháilteachta.

import json

TOOLS = {"read_file": read_file, "write_file": write_file, "run_command": run_command}

response = client.chat.complete(model="mistral-small-2603", messages=messages, tools=tools)
messages.append(response.choices[0].message)

for _ in range(30):   # ráthóg: níor chóir do ghníomhaire lúbadh go deo
    tool_calls = response.choices[0].message.tool_calls
    if not tool_calls:
        break         # níl aon ghlaonna uirlisí ann a thuilleadh: tá an freagra deiridh tagtha
    for tool_call in tool_calls:   # is féidir le freagra amháin glaonna iolracha a bheith ann
        name = tool_call.function.name
        arguments = json.loads(tool_call.function.arguments)
        result = TOOLS[name](**arguments)
        messages.append({
            "role": "tool",
            "name": name,
            "content": str(result),
            "tool_call_id": tool_call.id,
        })
    response = client.chat.complete(model="mistral-small-2603", messages=messages, tools=tools)
    messages.append(response.choices[0].message)

print(response.choices[0].message.content)

Tá tábhacht le trí mhionsonra. Cuirtear teachtaireacht an ghníomhaire agus toradh gach uirlise ar ais isteach sa stair, péireáilte leis an tool_call_id: fág ceachtar acu ar lár, agus caillfidh an gníomhaire an snáithe, ag glaoch ar na huirlisí céanna i lúb. Is féidir le freagra amháin glaochanna uirlisí iolracha a bheith ann, ós rud é go gceadaítear glaonna comhthreomhara de réir réamhshocraithe (parallel_tool_calls=False a chuireann cosc orthu): déan próiseáil orthu go léir. Ar deireadh, cuir teorainn le líon na gcasadh agus bíodh duine daonna ag bailíochtú orduithe blaoisce agus scríbhinní comhad: is riosca, ní sábhálaí ama, é gníomhaire a fheidhmíonn gach rud a mholann sé.

Príomhphointí

  • Leanann códú gníomhach timthriall: tuiscint a fháil, pleanáil, cur chun feidhme, fíorú
  • Gníomhaíonn an gníomhaire ar an stór trí ghlaoch uirlisí (tools, tool_choice)
  • Ligeann an lúb il-chasadh don ghníomhaire iteráil go dtí réiteach iomlán
  • Modhnaíonn an gníomhaire comhaid iolracha go comhsheasmhach i dtasc amháin
  • Tá an chéim fíoraithe (tástálacha, tógáil) riachtanach don iontaofacht