Luokittelevat esimerkit
Näytä esimerkit ilmoitettavista ja ohitettavista asioista.
Luokittelevat esimerkit on ilmainen Claude Architect-oppitunti CoddyKitissä. Tämä on oppitunti 2/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.
Miksi kategoriset esimerkit ovat tärkeitä
Kun annatte Claudelle tehtävän, jonka raja on epämääräinen, epämääräiset ohjeet, kuten ”be more precise”, toimivat harvoin. Malli ei voi lukea ajatuksianne siitä, missä raja kulkee.
Luotettava ratkaisu ovat kategoriset esimerkit: pieni joukko 2–4 few-shot-esimerkkiä, jotka näyttävät konkreettisesti, mitä pitää raportoida ja mitä ohittaa. Malli yleistää näistä esimerkeistä uusiin, aiemmin näkemättömiin syötteisiin — se ei vain toista niitä.
Tässä oppitunnissa näytetään, miten nämä esimerkit rakennetaan klassista arkkitehdin tehtävää varten: sen ratkaisemiseksi, mikä kannattaa ilmoittaa ja mikä on kohinaa.
Täsmälliset kriteerit voittavat epämääräiset adjektiivit
Ennen kuin edes turvaudutte esimerkkeihin, määritelkää täsmällinen kriteeri. Täsmälliset säännöt voittavat johdonmukaisesti epämääräiset adjektiivit.
- Epämääräinen: ”Tarkista koodi huolellisesti.”
- Täsmällinen: ”Ilmoita kommentista vain, kun se on ristiriidassa kuvaamansa koodin kanssa.”
Täsmällinen versio vetää selkeän rajan. Kategoriset esimerkit tekevät rajasta sitten yksiselitteisen kiinnittämällä sen konkreettisiin tapauksiin rajan molemmin puolin.
system = (
"You review code comments. "
"Flag a comment ONLY when it contradicts the code it describes. "
"Ignore style, tone, and outdated-but-harmless notes."
)Kategorisen esimerkkijoukon rakenne
Hyvässä joukossa on esimerkkejä rajan molemmilta puolilta, ja jokaisella on yhden rivin perustelu. Kaksi RAPORTOI-tapausta ja kaksi OHITA-tapausta riittää useimpiin epäselvyyksiin — 2–4 kohdennettua esimerkkiä on sopiva määrä.
Jokainen esimerkki koostuu kolmesta osasta:
- syöte (arvioitava asia)
- tuomio (raportoi / ohita)
- lyhyt perustelu, joka liittyy kriteeriinne
Perustelu auttaa mallia yleistämään oikein sen sijaan, että se tunnistaisi vain pintatason kaavoja.
Esimerkki: raportoi vai ohita
Tässä on kategorinen esimerkkilohko kommenttien tarkistustehtävää varten. Huomaatte symmetrian: ristiriidat raportoidaan, harmittomat poikkeamat ohitetaan.
EXAMPLES = """
<example verdict="REPORT">
code: return price * 1.2
comment: # applies 10% tax
reason: comment says 10% but code applies 20% (contradiction)
</example>
<example verdict="IGNORE">
code: timeout = 30 # seconds
comment: # seconds
reason: accurate; matches the code
</example>
<example verdict="IGNORE">
code: # TODO: refactor later
comment: # TODO: refactor later
reason: stylistic note, not a contradiction
</example>
<example verdict="REPORT">
code: if user.is_admin: deny()
comment: # allow admins
reason: comment says allow but code denies (contradiction)
</example>
"""Yleistämistä, ei ulkoa muistamista
Kategoristen esimerkkien voima perustuu siihen, että malli yleistää. Se ei tarvitse esimerkkiä jokaisesta mahdollisesta syötteestä.
Edellä olevien neljän tapauksen perusteella Claude oppii säännön ”ilmoita semanttisista ristiriidoista, ohita harmittomat poikkeamat” ja soveltaa sitä täysin uuteen kommenttiin, jota se ei ole koskaan nähnyt, kuten dokumenttimerkkijonoon, jossa väitetään funktion palauttavan listan, vaikka se palauttaa sanakirjan.
Siksi few-shot-esimerkit sopivat erinomaisesti johdonmukaisuuden, poikkeustapausten ja tulostusmuodon parantamiseen sekä hallusinaatioiden vähentämiseen.
Kiinnitä rajan reunat
Arvokkaimmat esimerkit ovat aivan rajan tuntumassa, jossa päätös on aidosti vaikea. Lähes osuva OHITA-tapaus lähes osuvan RAPORTOI-tapauksen vierellä opettaa paljon enemmän kuin kaksi ilmeistä tapausta.
Tutkimusagentin päättäessä, mitkä tilastot nostetaan esiin, voitte verrata vanhentunutta lukua ajantasaiseen lukuun — ja huomioida, että päivämäärät ratkaisevat usein näennäiset ristiriidat sen sijaan, että toinen luvuista olisi yksinkertaisesti väärä.
EXAMPLES = """
<example verdict="REPORT">
fact: "Revenue was $4.1B in FY2024" (source dated 2025-02)
reason: current, sourced, on-topic -> surface it
</example>
<example verdict="IGNORE">
fact: "Revenue was $3.2B" (source dated 2019, no fiscal year)
reason: stale and undated for our scope -> drop, do not treat as a conflict
</example>
"""Esimerkit ohjaavat myös rakenteista tulostetta
Kategoriset esimerkit sopivat luontevasti yhteen rakenteisen tulosteen kanssa. Kun tuomion on oltava koneellisesti luettava, pakottakaa työkalukutsu, jotta tulos on joka kerta kelvollista JSONia.
Käyttäkää tool_choice-asetuksen tyyppinä ”any”, jotta malli kutsuu varmasti jotakin työkalua (mikä takaa rakenteisen tulosteen), tai pakottakaa yksi tietty työkalu nimen perusteella. JSON Schema poistaa sitten syntaksivirheet ja valvoo pakollisia kenttiä.
tools = [{
"name": "record_finding",
"description": "Record a review verdict for one item.",
"input_schema": {
"type": "object",
"properties": {
"verdict": {"enum": ["report", "ignore"]},
"reason": {"type": "string"}
},
"required": ["verdict", "reason"]
}
}]
resp = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=512,
tools=tools,
tool_choice={"type": "any"},
system=system,
messages=[{"role": "user", "content": EXAMPLES + new_item}],
)Vaadi vain kenttiä, jotka ovat aina olemassa
Hienovarainen ansa: merkitkää löytöjen skeemassa kenttä pakolliseksi vain, jos se on aina mukana. Jos vaaditte kenttää, joka saattaa puuttua — esimerkiksi line_number-kenttää löydöissä, jotka eivät liity tiettyyn riviin — malli keksii arvon täyttääkseen skeeman vaatimukset.
Käyttäkää kasvaville kategorioille enumia sekä ”other”-arvoa ja vapaatekstistä lisätietokenttää. Näin tuloste pysyy rakenteisena ja samalla laajennettavana.
"category": {"enum": ["contradiction", "security", "other"]},
"category_detail": {"type": "string"} # filled when category == other
# line_number is NOT required: many findings are file-levelMilloin esimerkit ovat väärä työkalu
Kategoriset esimerkit terävöittävät harkintarajaa. Ne eivät keksi puuttuvia tietoja.
Jos malli palauttaa tyhjän tai väärän tuloksen, koska tarvittava tieto yksinkertaisesti puuttuu lähteestä, useammat esimerkit eivät auta — eikä myöskään uudelleenyritys palautteen kanssa. Uudelleenyritys korjaa muoto-, rakenne- ja laskuvirheitä, ei puuttuvia tietoja.
Erottakaa toisistaan aito tyhjä tulos (”osumia ei löytynyt”) ja käyttöoikeus- tai lukemisvirhe (lähdettä ei voitu lukea). Käsitelkää niitä palautuslogiikassa eri tavoin.
Kategoriset esimerkit CLAUDE.md-tiedostossa ja tarkistuksissa
Siirtäkää raportointi-/ohituskäytäntönne sinne, missä työ tehdään. CI-tarkistustehtävässä sijoittakaa esimerkit projektitason CLAUDE.md-tiedostoon (jaettuna VCS:n kautta), jotta jokainen suoritus ja tiimin jäsen käyttää samaa rajaa.
Suorittakaa tarkistus CI:ssä eristetyssä istunnossa (vähemmän puolueellinen kuin generointikonteksti) ja käyttäkää ei-vuorovaikutteiseen tulosteeseen asetusta -p. Täsmälliset kriteerit ja kategoriset esimerkit ovat juuri se tapa, jolla väärät positiiviset tulokset minimoidaan.
## Review policy (categorical)
REPORT: a comment that contradicts the code it describes.
IGNORE: style nits, tone, outdated-but-harmless TODOs.
Example REPORT -> `# 10% tax` over `price * 1.2`
Example IGNORE -> `timeout = 30 # seconds` (accurate)Kootaan kokonaisuus
Siistin raportoi/ohita-päätöksen täydellinen ohje:
- Kirjoittakaa rajan määrittävä yksi täsmällinen kriteeri.
- Lisätkää 2–4 kategorista esimerkkiä jaettuna molemmille puolille, jokaiselle perustelu.
- Sijoittakaa esimerkit vaikeisiin rajatapauksiin, ei ilmeisiin tapauksiin.
- Pakottakaa strukturoitu tuloste työkalulla ja vaatikaa vain aina esiintyvät kentät.
- Muistakaa: esimerkit ohjaavat päättelyä, eivät puuttuvia tietoja.
Kun toimitte näin, Claude yleistää tarkoituksenne luotettavasti myös syötteisiin, joita se ei ole aiemmin nähnyt.
Pikatarkistus
Arviointiagentti merkitsee liian monet harmittomat kommentit ongelmiksi. Haluatte sen raportoivan vain aidot ristiriidat. Mikä muutos tiukentaa rajausta luotettavimmin?
Kertaus
Keskeiset opit:
- Täsmälliset kriteerit ja kategoriset esimerkit toimivat epämääräisiä adjektiiveja paremmin häilyvien rajojen määrittämisessä.
- Käyttäkää 2–4 esimerkkiä jaettuna raportoitaviin ja ohitettaviin tapauksiin ja perustelkaa jokainen; malli yleistää, ei vain toista.
- Sijoittakaa esimerkit vaikeisiin rajatapauksiin; muistakaa, että päivämäärät usein ratkaisevat näennäiset ristiriidat.
- Yhdistäkää tähän strukturoitu tuloste (
tool_choice"any" + JSON Schema); vaatikaa vain aina esiintyvät kentät ja käyttäkää enum-arvoa sekä "other"-arvoa laajennettavuuden vuoksi. - Esimerkit terävöittävät harkintaa, eivät korjaa puuttuvia tietoja — puuttuvat faktat vaativat toisenlaisen korjauksen, ja uudelleenyritys korjaa vain muotoilu- tai laskuvirheitä.
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 ”Luokittelevat esimerkit” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Claude Architect-oppimispolun 3 oppituntia, myös oppitunnin “Luokittelevat esimerkit”. 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 ”Luokittelevat esimerkit”?
Näytä esimerkit ilmoitettavista ja ohitettavista asioista. 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 2/4.
Kuinka kauan ”Luokittelevat esimerkit”-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
- Eksplisiittiset kriteerit epämääräisten ohjeiden sijaan
- Luokittelevat esimerkit
- Vakavuuskriteerit esimerkkien avulla
- Väärien positiivisten vähentäminen