Programmēšana ar aģentiem, izmantojot rīku izsaukumus
Šajā lapā
Nodarbība atjaunināta 2026. gada 2. novembrī. Sākotnējie piemēri izmantoja Devstral, kas tika izņemts no API 2026. gada 31. jūlijā. Tagad tie izmanto Mistral Small 4 (
mistral-small-2603), un aģenta cikls seko Mistral dokumentācijas modelim (visi rīku izsaukumi atbildē tiek apstrādāti līdz galīgajai atbildei). Avots: Function calling.
Kas ir programmēšana ar aģentiem?
Programmēšana ar aģentiem maina to, ko tu lūdz modelim darīt. Tā vietā, lai pieprasītu vienu koda fragmentu, tad otru, tad trešo un pats tos savienotu, tu uzdod pilnu uzdevumu. Modelis to atrisina, pats secīgi veicot soļus: izpēti, plānošanu, implementāciju un verifikāciju. Tu paliec par lēmumu pieņēmēju attiecībā uz to, kas ir jādara, bet pārtrauc katru soli mikropārvaldīt.
Devstral modeļi tika veidoti šim darba plūsmas veidam; pašreizējie vispārējās nozīmes modeļi, kuru vidū ir Mistral Small 4, to nodrošina, izmantojot rīku izsaukumus. Aģents neatbild tikai uz jautājumu; tas darbojas ar repozitoriju.
Aģenta cikls
1. posms — Izpratne
Aģents vienmēr sāk ar orientēšanos. Tas nolasa mapju un failu struktūru, identificē failus, kas ir būtiski pieprasītajam uzdevumam, izseko atkarības starp moduļiem, lai redzētu, ko izmaiņas varētu ietekmēt, un fiksē esošās konvencijas — nosaukumu veidošanu, testu organizāciju un atkārtojošos rakstus. Šis posms šķiet neproduktīvs, jo netiek rakstīts neviens koda rindiņa, taču tieši tas nosaka, vai rezultējošais kods izskatīsies pēc tava vai pēc svešinieka rakstīta.
2. posms — Plānošana
Pirms tiek uzrakstīta pirmā koda rindiņa, aģents formulē plānu. Tas sadala uzdevumu sakārtotos apakšuzdevumos, nošķir failus, kas jāmodificē, no tiem, kas jāizveido, paredz blakussekas un regresijas riskus, kā arī izvēlas tehnisko pieeju. Šī ir brīdis, kad tava iejaukšanās ir vislētākā: plāna labošana aizņem trīsdesmit sekundes; desmit jau uzrakstītu failu labošana aizņem daudz ilgāk.
3. posms — Izpilde
Implementācija soli pa solim īsteno plānu. Aģents rediģē esošos failus, izveido jaunus, ja to prasa struktūra, atjaunina importus un atkarības, kas mainījušās tā izmaiņu dēļ, un ceļa laikā pielāgo konfigurācijas failus. Konsekvence šajās izmaiņās ir tieši tas, ko pabeigšanas (completion) modelis nevar garantēt.
4. posms — Verifikācija
Visbeidzot seko pierādījums, ka darbs ir izturīgs. Aģents palaiž esošo testu kopu, raksta jaunus testus tikko pievienotajam kodam, nodrošina, ka būve (build) izdodas, un pārskata savu diff, lai atrastu kļūdas vai liekas izmaiņas. Aģents, kas izlaiž šo posmu, rada ticamu, bet ne pareizu kodu.
Praktisks piemērs: kļūdas novēršana
Pieņemsim, ka tu saki aģentam: “Lietotāji saņem 500 kļūdu, kad viņi iesniedz formu ar e-pastu, kas satur ’+’.” Tad cikls iegūst šādu formu:
1. IZPRATNE
-> Meklēt failus, kas saistīti ar formu (meklēt "email" kodā)
-> Nolasīt kontrolieri, kas apstrādā iesniegšanu
-> Nolasīt e-pasta validācijas funkciju
-> Identificēt regulāro izteiksmi (regex), kas noraida '+'
2. PLĀNOŠANA
-> Modificēt validācijas regex, lai pieņemtu '+'
-> Pievienot vienības testu e-pastiem ar '+'
-> Pārliecināties, ka neviena cita koda daļa nefiltrē '+'
3. IZPILDE
-> Modificēt src/validators/email.py: labot regex rakstu
-> Izveidot tests/test_email_validation.py: pievienot gadījumus ar '+'
-> Modificēt src/controllers/form.py: pievienot žurnāla ierakstu atkļūdošanai
4. VERIFIKĀCIJA
-> Palaist pytest -> visi testi izdodas
-> Pārbaudīt diff -> izmaiņas ir konsekventas un minimālas
Ievēro plāna trešo rindiņu: aģents ne tikai labo vietu, kur kļūda izpaužas; tas pārbauda, vai nekur citur nav filtra, kas noraidītu šo rakstzīmi. Tieši šī meklēšana pēc pamatcēloņa, nevis tikai simptoma, atšķir aģenta veiktu labojumu no vienkārša plākstera.
Rīku izmantošana praksē
Aģents darbojas savā vidē, izmantojot funkciju izsaukumus. Tu pieprasījumā deklarē pieejamos rīkus, ieskaitot to nosaukumu, aprakstu un parametru shēmu; modelis izvēlas, kurus no tiem izsaukt un ar kādiem argumentiem.
# Piemērs sarunai ar aģentu
messages = [
{
"role": "user",
"content": "Pievieno spēcīgas paroles validāciju autentifikācijas modulim."
}
]
tools = [
{
"type": "function",
"function": {
"name": "read_file",
"description": "Nolasa projekta faila saturu",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string", "description": "Faila ceļš"}
},
"required": ["path"]
}
}
},
{
"type": "function",
"function": {
"name": "write_file",
"description": "Raksta vai modificē projekta failu",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}
},
{
"type": "function",
"function": {
"name": "run_command",
"description": "Izpilda čaulas komandu",
"parameters": {
"type": "object",
"properties": {
"command": {"type": "string"}
},
"required": ["command"]
}
}
}
]
response = client.chat.complete(
model="mistral-small-2603",
messages=messages,
tools=tools,
tool_choice="auto", # noklusējuma vērtība: modelis pats izlemj, vai izsaukt rīku
)
Šim pieprasījumam tipiska secība sākas ar read_file("src/auth/validators.py"), lai izprastu esošo kodu, turpinās ar read_file("tests/test_auth.py"), lai redzētu pašreizējo testu formātu, pēc tam pāriet uz rakstīšanu: write_file("src/auth/validators.py", ...) ar pievienoto validācijas noteikumu, write_file("tests/test_auth.py", ...) ar jaunajiem gadījumiem un visbeidzot run_command("pytest tests/test_auth.py"), lai veiktu verifikāciju. Secībai ir nozīme: atverot abus failus pirms pieskaršanās vienam simbolam, aģents pārņem tavas konvencijas un tās reproducē, nevis importē tās, ko redzējis citur.
Daudzkārtējs aģenta cikls
Nekas no tā nenotiek vienā izsaukumā. Programmēšanas ar aģentiem sirds ir daudzkārtējais cikls: modelis piedāvā darbību, tavs kods to izpilda, un tu nosūti rezultātu atpakaļ, lai tas varētu lemt par nākamo soli. Tu saglabā kontroli pār faktisko izpildi, kas kalpo arī kā drošības barjera.
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): # drošības barjera: aģentam nekad nevajadzētu ciklot bezgalīgi
tool_calls = response.choices[0].message.tool_calls
if not tool_calls:
break # vairs nav rīku izsaukumu: galīgā atbilde ir saņemta
for tool_call in tool_calls: # vienā atbildē var būt vairāki izsaukumi
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)
Ir svarīgi trīs detaļas. Aģenta ziņojums un katrs rīka rezultāts tiek atkārtoti ievadīts vēsturē, sapārots ar tool_call_id: izlaid kādu no tiem, un aģents zaudē pavedienu, atkārtoti atsaucot tos pašus rīkus ciklā. Vienā atbildē var būt vairāki rīku izsaukumi, jo paralēlie izsaukumi pēc noklusējuma ir atļauti (parallel_tool_calls=False tos aizliedz): apstrādā tos visus. Visbeidzot, ierobežo apgriezienu skaitu un liec cilvēkam validēt čaulas komandas un failu rakstīšanu: aģents, kas izpilda visu, ko piedāvā, ir risks, nevis laika taupītājs.
Galvenās atziņas
- Programmēšana ar aģentiem seko ciklam: izpratne, plānošana, izpilde, verifikācija
- Aģents darbojas ar repozitoriju, izmantojot rīku izsaukumus (
tools,tool_choice) - Daudzkārtējais cikls ļauj aģentam iterēt līdz pilnīgai atrisināšanai
- Aģents vienā uzdevumā konsekventi modificē vairākus failus
- Verifikācijas posms (testi, būve) ir būtisks uzticamībai