Milloin agenttia kannattaa käyttää
Agentit, yksinkertaiset kehotteet ja kiinteät putket.
Milloin agenttia kannattaa käyttää on ilmainen Claude Architect-oppitunti CoddyKitissä. Tämä on oppitunti 3/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu Claude Architect-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Claude Architect-kurssilla on yhteensä 4 oppituntia.
Kolme tapaa ratkaista tehtävä
Ennen kuin rakennatte mitään Claudella, teette yhden keskeisen päätöksen: kuinka paljon itsenäisyyttä tehtävä tarvitsee? Vaihtoehtoja on kolme:
- Yksinkertainen kehote — yksi pyyntö, yksi vastaus.
- Kiinteä putki — tunnettu vaiheiden sarja, jonka kytkette itse.
- Agentti — malli päättää, mitä työkaluja kutsutaan ja milloin, ja toistaa silmukkaa työn valmistumiseen asti.
Oikean vaihtoehdon valinta on arkkitehtuuripäätös. Liian raskas ratkaisu lisää kustannuksia ja vikapisteitä; liian kevyt ratkaisu ei pysty viemään tehtävää loppuun. Tässä oppitunnissa opitte valitsemaan oikein.
Yksinkertainen kehote
Yksinkertainen kehote on yksi API-kutsu: lähetätte system-viestin ja messages-viestit ja saatte yhden vastauksen. Ei työkaluja eikä silmukkaa.
Käyttäkää sitä, kun tehtävä on itsenäinen: tekstin uudelleenkirjoittamiseen, kappaleen tiivistämiseen, lauseen luokitteluun tai kysymykseen vastaamiseen annetun kontekstin perusteella. Jos kaikki mallin tarvitsema on jo kehotteessa, ette tarvitse mitään muuta.
Muistakaa: malli ei säilytä tilaa. Jokainen kutsu on itsenäinen — teidän on lähetettävä koko messages-historia uudelleen, jos haluatte jatkuvuutta.
import anthropic
client = anthropic.Anthropic()
resp = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=512,
system="You rewrite text to be clear and concise.",
messages=[
{"role": "user", "content": "Rewrite: 'The meeting, which was long, ended.'"}
],
)
print(resp.content[0].text)Kiinteä putki
Kiinteä putki ketjuttaa useita vaiheita tunnetussa järjestyksessä. Te — arkkitehdit — päätätte järjestyksen koodissa. Vaihe 1 syöttää tietonsa vaiheelle 2, joka puolestaan syöttää ne vaiheelle 3.
Tätä kutsutaan myös nimellä prompt chaining. Käyttäkää sitä, kun vaiheet ovat tunnettuja ja peräkkäisiä: poimikaa kentät, validoikaa ne ja muotoilkaa sitten raportti. Malli ei valitse etenemisreittiä — te valitsitte sen etukäteen.
Putket ovat ennakoitavia ja helppoja jäljittää, koska ohjausvirta on kiinteä. Haittapuolena on jäykkyys: ne eivät mukaudu, kun tehtävä tarvitsee eri vaiheita sen mukaan, mitä käsittelyn aikana löytyy.
# Fixed pipeline: each step's output feeds the next
extracted = extract_fields(document) # step 1
validated = validate(extracted) # step 2
report = format_report(validated) # step 3
# The sequence is hard-coded. The model never picks the path.Agentti
Agentti antaa ohjausvirran mallin hallintaan. Annatte Claudelle tavoitteen ja joukon tools-työkaluja, minkä jälkeen malli päättää, mitä työkalua kutsutaan, tarkastelee tulosta ja päättää, mitä tehdään seuraavaksi — silmukka jatkuu, kunnes tavoite on saavutettu.
Määrittävä ominaisuus: päätökset ovat malliohjattuja, eivät kovakoodattuja. Ette tiedä etukäteen, kuinka monta vaihetta tarvitaan tai mitä työkaluja käytetään.
Käyttäkää agenttia, kun reitti on avoin: vian tutkimiseen, aiheen tutkimiseen useista lähteistä tai asiakasongelman ratkaisemiseen, jossa voidaan tarvittaessa tehdä haku, hyvitys tai eskalointi löydösten perusteella.
resp = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
system="You are a support agent. Resolve the customer's issue.",
tools=[get_customer, lookup_order, process_refund, escalate_to_human],
messages=conversation,
)
# The model chooses which tool(s) to call based on the situation.Agenttisilmukka
Agentti suorittaa vastausrakenteen stop_reason-arvon ohjaamaa silmukkaa:
- Lähettäkää pyyntö.
- Tarkastelkaa
stop_reason-arvoa. - Jos arvo on
tool_use, suorittakaa pyydetyt työkalut, lisätkää tulokset viestihistoriaan ja lähettäkää pyyntö uudelleen. - Toistakaa, kunnes
stop_reasononend_turn.
Lopettakaa pysäytyssyyn perusteella — se on API:n oma signaali siitä, että vuoro on valmis. Tämä on jokaisen agentin ydin.
while True:
resp = client.messages.create(model=MODEL, max_tokens=1024,
system=SYSTEM, tools=TOOLS,
messages=messages)
messages.append({"role": "assistant", "content": resp.content})
if resp.stop_reason == "end_turn":
break # task complete
if resp.stop_reason == "tool_use":
results = run_tools(resp.content)
messages.append({"role": "user", "content": results})Älkää etsikö tekstistä sanaa "done"
Yleinen ja vaarallinen virhe on lopettaa silmukka etsimällä mallin vastauksesta sanoja kuten "done" tai "finished". Malli saattaa sanoa "done" kesken ajatuksen tai olla sanomatta sitä lainkaan. Tämä on klassinen huono käytäntö.
Lopettakaa aina stop_reason-arvon perusteella — end_turn tarkoittaa, että käsittely on valmis. Pysäytyssyy on rakenteinen ja luotettava signaali; vapaa teksti ei ole.
Iteraatiorajat (silmukan kierrosten enimmäismäärä) ovat turvaverkko, joka estää hallitsemattomat silmukat — eivät koskaan ensisijainen pysäytysmekanismi. Todellinen pysäytys perustuu aina pysäytyssyyhyn.
# ANTI-PATTERN: do not do this
if "done" in resp.content[0].text.lower():
break
# CORRECT: rely on the structured stop reason
if resp.stop_reason == "end_turn":
breakPäätössääntö: tunnetaanko etenemisreitti?
Tässä on ainoa kysymys, joka ratkaisee agentin ja putken välillä:
Tiedättekö vaiheet etukäteen?
- Kyllä, kiinteät ja peräkkäiset → käyttäkää kiinteää putkea (prompt chaining). Se on edullisempi, nopeampi ja helpompi jäljittää.
- Ei, avoin tutkinta → käyttäkää agenttia mukautuvan hajottamisen kanssa.
Jos tehtävä ei tarvitse lainkaan ulkoisia tietoja tai toimintoja ja mahtuu yhteen kutsuun, ette tarvitse edes putkea — yksinkertainen kehote riittää. Valitkaa aina yksinkertaisin tehtävän ratkaiseva malli.
Päätökset ja takuut
Agentit ovat tehokkaita, koska malli tekee päätökset — mutta mallin päätökset ovat todennäköisyyksiin perustuvia (noin 90-prosenttisen luotettavia), eivät varmoja. Siksi pätee toinenkin sääntö:
Antakaa mallin päättää; varatkaa kovakoodattu logiikka takuita varten.
Kun väärällä toiminnolla on taloudellisia, oikeudellisia tai turvallisuuteen liittyviä seurauksia — esimerkiksi kyseessä on suuri hyvitys — älkää luottako kehotteeseen. Valvokaa sääntöä deterministisesti koukulla tai ohjelmallisella esiehdolla. Kehotteet ohjaavat; koukut takaavat.
Agentti voi siis olla oikea rakenne, vaikka kriittiset säännöt valvotaan edelleen sen ympärillä koodilla. Nämä kaksi asiaa eivät ole ristiriidassa.
# Prompt guidance is ~90% reliable — fine for routine routing.
# A hook is 100% deterministic — use it for critical rules:
# block process_refund when amount > 500
# block process_refund until get_customer returns a verified ID
# Outgoing-call hooks reject policy-violating actions before they run.Milloin putki on agenttia parempi
Älkää valitko agenttia vain siksi, että se vaikuttaa nykyaikaiselta. Kiinteä putki on parempi, kun:
- Vaiheiden järjestys on tunnettu ja vakaa.
- Haluatte ennakoitavat kustannukset ja viiveen (ei avointa silmukkaa).
- Tarvitsette ohjausvirran, jota on helppo testata ja jäljittää.
Esimerkki: rakenteisen datan poiminta, jossa poimitaan aina ensin tiedot, sitten validoidaan ne ja lopuksi muotoillaan tulos. Reitti ei muutu, joten sen kovakoodaus on oikea ja luotettava ratkaisu. Agentin itsenäisyyden lisääminen toisi tähän vain tarpeetonta epädeterministisyyttä ja kustannuksia.
Milloin agentti on oikea valinta
Valitkaa agentti, kun työ on aidosti avointa ja reitti riippuu siitä, mitä matkan varrella löydetään:
- Vian tutkiminen — etsitte grepillä aloituskohdat, luette tiedostoja ja seuraatte käyttötapoja; reittiä ei voi käsikirjoittaa etukäteen.
- Tutkimus useista lähteistä — koordinaattori hajottaa kysymyksen osiin ja delegoi ne aliagenteille.
- Asiakastuki — yksi asia tarvitsee haun, toinen hyvityksen ja kolmas eskaloinnin.
Kaikissa näissä seuraava vaihe riippuu edellisestä tuloksesta. Juuri tämän riippuvuuden agenttisilmukka käsittelee, mutta kiinteä putki ei pysty siihen.
system=("You are a debugging agent. Investigate the failing test "
"and find the root cause.")
tools=[glob_tool, grep_tool, read_tool, bash_tool]
# The model adapts: Grep entry points -> Read files -> Grep usages
# -> Read consumers. The route is decided at runtime, not by you.Käytännön tarkistuslista
Käykää jokainen uusi tehtävä läpi tämän pikatarkistuslistan avulla:
- Yksi itsenäinen kutsu? → yksinkertainen kehote.
- Tunnettu, kiinteä vaiheiden sarja? → kiinteä putki.
- Avoin tehtävä, jonka reitti riippuu tuloksista? → agentti.
- Kriittinen sääntö (raha / laki / turvallisuus)? → valvokaa sitä koukulla valitsemastanne mallista riippumatta.
Valitkaa oletusarvoisesti yksinkertaisin toimiva malli. Lisätkää itsenäisyyttä vain, kun tehtävä todella tarvitsee sitä — ja lisätkää deterministinen valvonta aina, kun virhe tulisi kalliiksi. Tämä tasapaino erottaa arkkitehdin kokeilijasta.
Pikatarkistus
Testatkaa päätöksentekoanne realistisessa tilanteessa.
Kertaus: mallin valinta
Tärkeimmät opit:
- Yksinkertainen kehote — itsenäinen, yksi kutsu, ei tilaa (lähetätte koko historian itse uudelleen).
- Kiinteä putki — tunnetut, peräkkäiset vaiheet; ennakoitava, edullinen ja helppo jäljittää.
- Agentti — avoin etenemispolku, jonka malli päättää ajon aikana agenttisilmukan avulla.
- Silmukka päättyy, kun
stop_reason == end_turn, ei koskaan tekstiä jäsentämällä; iteraatiorajat ovat vain turvaverkko. - Mallin päätökset ovat todennäköisyyspohjaisia. Kriittiset raha-, laki- ja turvallisuussäännöt on varmistettava hookeilla tai ohjelmallisilla esiehdoilla determinististen takeiden saavuttamiseksi.
- Käyttäkää oletusarvoisesti yksinkertaisinta tehtävään sopivaa mallia.
Kun hallitsette tämän valinnan, muu agenttiarkkitehtuuri rakentuu sen päälle sujuvasti.
Opi Python tekoälytuutorin avulla — ilmaiseksi
Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.
- Kurssit
- 26
- Oppitunnit
- 104
Usein kysytyt kysymykset
Onko oppitunti ”Milloin agenttia kannattaa käyttää” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Claude Architect-oppimispolun 3 oppituntia, myös oppitunnin “Milloin agenttia kannattaa käyttää”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Claude Architect-kurssilla on yhteensä 4 oppituntia.
Mitä opin oppitunnilla ”Milloin agenttia kannattaa käyttää”?
Agentit, yksinkertaiset kehotteet ja kiinteät putket. Harjoittelet Claude Architect-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.
Tarvitsenko kokemusta aloittaakseni Claude Architect-opiskelun?
Aiempi kokemus ei ole tarpeen. CoddyKitin Claude Architect-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 3/4.
Kuinka kauan ”Milloin agenttia kannattaa käyttää”-oppitunnin suorittaminen kestää?
Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.
Voinko kirjoittaa ja suorittaa koodia tällä Claude Architect-oppitunnilla?
Kyllä. Jokainen Claude Architect-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.
Kaikki tämän kurssin oppitunnit
- Mikä tekee järjestelmästä agenttisen
- Mallin ohjaamat ja kovakoodatut päätökset
- Milloin agenttia kannattaa käyttää
- Agenttisen silmukan yleiskatsaus