Agentic Coding with Tool Calling
Tällä sivulla
Oppitunti päivitetty 2. marraskuuta 2026. Alkuperäiset esimerkit käyttivät Devstralia, joka poistettiin rajapinnasta 31. heinäkuuta 2026. Ne käyttävät nyt Mistral Small 4:ää (
mistral-small-2603), ja agenttisilmukka noudattaa Mistralin dokumentaation mallia (kaikki vastauksen työkalukutsut käsitellään ennen lopullista vastausta). Lähde: Function calling.
Mikä on agenttinen koodaus?
Agenttinen koodaus muuttaa sitä, mitä pyydät mallilta tekemään. Sen sijaan, että pyytäisit yhtä koodinpätkää, sitten toista, sitten kolmatta ja liittäisit ne itse yhteen, määrität kokonaisen tehtävän. Malli ratkaisee sen ketjuttamalla vaiheet itse: tutkiminen, suunnittelu, toteutus ja varmistus. Sinä päätät, mitä tehdään, mutta lopetat jokaisen liikkeen mikrohallinnan.
Devstral-mallit rakennettiin tätä työnkulkua varten; nykyiset yleiskäyttöiset mallit, joita johtaa Mistral Small 4, hoitavat sen työkalukutsujen avulla. Agentti ei vain vastaa kysymykseen, vaan se toimii koodivarastossa.
Agenttinen sykli
Vaihe 1 — Ymmärrä
Agentti aloittaa aina suunnistamalla. Se lukee kansio- ja tiedostorakenteen, tunnistaa pyydettyyn tehtävään liittyvät tiedostot, jäljittää riippuvuudet moduulien välillä nähdäkseen, mihin muutos voi vaikuttaa, ja huomaa olemassa olevat käytännöt – nimeämiskäytännöt, testien organisaation ja toistuvat mallit. Tämä vaihe vaikuttaa tuottamattomalta, koska siinä ei kirjoiteta koodia, mutta se ratkaisee, näyttääkö lopputulos omaltasi vai vieraan kirjoittamalta.
Vaihe 2 — Suunnittele
Ennen kuin agentti kirjoittaa riviäkään, se laatii suunnitelman. Se jakaa tehtävän järjestettyihin osatehtäviin, erottaa muokattavat tiedostot luotavista, ennakoi sivuvaikutukset ja regressioriskit sekä päättää teknisestä lähestymistavasta. Tässä vaiheessa puuttumisesi on halvinta: suunnitelman korjaaminen vie kolmekymmentä sekuntia; kymmenen jo kirjoitetun tiedoston korjaaminen vie paljon kauemmin.
Vaihe 3 — Toteuta
Toteutus purkaa suunnitelman vaiheittain. Agentti muokkaa olemassa olevia tiedostoja, luo uusia tarvittaessa, päivittää muutosten siirtämiä tuontilauseita ja riippuvuuksia sekä säätää määritystiedostoja matkan varrella. Näiden muutosten yhtenäisyys on juuri se, mitä täydennysmalli ei pysty takaamaan.
Vaihe 4 — Varmista
Viimeiseksi tulee näyttö siitä, että työ kestää. Agentti ajaa olemassa olevan testisarjan, kirjoittaa uusia testejä juuri lisäämälleen koodille, varmistaa käännöksen onnistumisen ja tarkistaa oman diffinsä virheiden tai harhailevien muutosten varalta. Agentti, joka ohittaa tämän vaiheen, tuottaa uskottavaa koodia, ei oikeaa koodia.
Esimerkki: bugin korjaaminen
Oletetaan, että sanot agentille: “Käyttäjät saavat 500-virheen lähettäessään lomakkeen, jossa sähköpostiosoite sisältää merkin ’+’.” Sykli etenee tällöin seuraavasti:
1. YMMÄRRÄ
-> Etsi lomakkeeseen liittyvät tiedostot (etsi "email" koodista)
-> Lue lähetyksen käsittelevä ohjain
-> Lue sähköpostin validointifunktio
-> Tunnista '+'-merkin hylkäävä säännöllinen lauseke
2. SUUNNITTELE
-> Muokkaa validoinnin säännöllistä lauseketta hyväksymään '+'
-> Lisää yksikkötesti '+'-merkin sisältäville sähköposteille
-> Varmista, ettei koodin muu osa suodata '+'-merkkiä pois
3. TOTEUTA
-> Muokkaa src/validators/email.py: korjaa säännöllisen lausekkeen malli
-> Luo tests/test_email_validation.py: lisää '+'-tapauksia
-> Muokkaa src/controllers/form.py: lisää lokimerkintä vianetsintää varten
4. VARMISTA
-> Suorita pytest -> kaikki testit läpäisty
-> Tarkista diff -> muutokset ovat johdonmukaisia ja minimaalisia
Huomaa suunnitelman kolmas rivi: agentti ei vain korjaa kohtaa, jossa bugi ilmenee, vaan tarkistaa, ettei mikään muu suodatin hylkää merkkiä muualla. Tämä perussyyn etsiminen pelkän oireen sijaan on se, mikä erottaa agenttisen korjauksen paikallisesta paikkauksesta.
Työkalujen käyttö käytännössä
Agentti toimii ympäristössään funktiokutsujen kautta. Määrität pyynnössä käytettävissä olevat työkalut, mukaan lukien niiden nimi, kuvaus ja parametrien skeema; malli valitsee, mitkä työkalut se kutsuu ja millä argumenteilla.
# Esimerkki agenttisesta keskustelusta
messages = [
{
"role": "user",
"content": "Lisää vahva salasanavalidointi auth-moduuliin."
}
]
tools = [
{
"type": "function",
"function": {
"name": "read_file",
"description": "Read the content of a project file",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string", "description": "File path"}
},
"required": ["path"]
}
}
},
{
"type": "function",
"function": {
"name": "write_file",
"description": "Write or modify a project file",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}
},
{
"type": "function",
"function": {
"name": "run_command",
"description": "Execute a shell command",
"parameters": {
"type": "object",
"properties": {
"command": {"type": "string"}
},
"required": ["command"]
}
}
}
]
response = client.chat.complete(
model="mistral-small-2603",
messages=messages,
tools=tools,
tool_choice="auto", # oletusarvo: malli päättää, kutsutaanko työkalua
)
Tässä pyynnössä tyypillinen sekvenssi alkaa komennolla read_file("src/auth/validators.py") olemassa olevan koodin ymmärtämiseksi, jatkuu komennolla read_file("tests/test_auth.py") nykyisten testien muodon näkemiseksi ja siirtyy sitten kirjoittamiseen: write_file("src/auth/validators.py", ...) lisätyn validointisäännön kanssa, write_file("tests/test_auth.py", ...) uusien tapausten kanssa ja lopuksi run_command("pytest tests/test_auth.py") varmistamiseksi. Järjestyksellä on väliä: avaamalla molemmat tiedostot ennen kuin se koskee yhtäkään merkkiä, agentti omaksuu käytäntösi ja toistaa ne sen sijaan, että se tuisi sisään muualta näkemiään käytäntöjä.
Monivaiheinen agenttisilmukka
Mikään tästä ei tapahdu yhdellä kutsulla. Agenttisen koodauksen ydin on monivaiheinen silmukka: malli ehdottaa toimintoa, koodisi suorittaa sen ja lähetät tuloksen takaisin, jotta se voi päättää seuraavasta vaiheesta. Pidät todellisen suorituksen hallinnassasi, mikä toimii myös turvallisuussuojanasi.
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): # suojaus: agentti ei saa koskaan silmukoida loputtomiin
tool_calls = response.choices[0].message.tool_calls
if not tool_calls:
break # ei enää työkalukutsuja: lopullinen vastaus on saapunut
for tool_call in tool_calls: # vastaus voi sisältää useita kutsuja
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)
Kolme yksityiskohtaa on tärkeää. Agentin viesti ja jokainen työkalun tulos injektoidaan uudelleen historiaan paritettuna tool_call_id:llä: jompikumpi puuttuu, ja agentti menettää langan pään, kutsuen samoja työkaluja silmukassa. Yksi vastaus voi sisältää useita työkalukutsuja, sillä rinnakkaiset kutsut ovat oletuksena sallittuja (parallel_tool_calls=False kieltää ne): käsittele ne kaikki. Lopuksi, rajoita kierrosten määrää ja anna ihmisen validoida shell-komennot ja tiedostojen kirjoitukset: agentti, joka suorittaa kaiken ehdottamansa, on riski, ei ajan säästäjä.
Keskeiset asiat
- Agenttinen koodaus noudattaa sykliä: ymmärrä, suunnittele, toteuta, varmista
- Agentti toimii koodivarastossa työkalukutsujen kautta (
tools,tool_choice) - Monivaiheinen silmukka antaa agentille mahdollisuuden iteroida täydelliseen ratkaisuun saakka
- Agentti muokkaa useita tiedostoja johdonmukaisesti yhden tehtävän aikana
- Varmistusvaihe (testit, käännös) on olennainen luotettavuuden kannalta