Vibe-koodaus · Oppitunti

Työkalujen antaminen agentille

Antakaa tekoälyn käyttää verkkoa, tiedostoja ja koodia.

Oppitunti 2/413 vaihetta

Työkalujen antaminen agentille on ilmainen Vibe-koodaus-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 Vibe-koodaus-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Vibe-koodaus-kurssilla on yhteensä 4 oppituntia.

Työkalut muuttavat chatbotin tekijäksi

Agentti on vain niin kyvykäs kuin ne työkalut, joita se voi käyttää. Ilman työkaluja tekoäly vain ennustaa tekstiä. Kun annatte sille työkaluja, se voi tehdä hakuja verkossa, lukea tiedostojanne, suorittaa koodia tai kutsua APIa.

Ajatelkaa työkaluja agentin käsinä. Aivot päättävät, kädet toimivat. Tässä oppitunnissa näytetään, mitä nämä kädet ovat ja miten annatte ne agentin käyttöön.

Mikä lasketaan työkaluksi

"Työkalu" on mikä tahansa toiminto, jonka agentti voi suorittaa todellisessa maailmassa. Yleisiä työkaluja ovat:

  • Verkkohaku / haku — tietojen etsiminen verkosta
  • Tiedoston luku/kirjoitus — projektin avaaminen ja muokkaaminen
  • Komennon suorittaminen — palvelimen käynnistäminen ja testien suorittaminen
  • APIn kutsuminen — sää-, maksu- tai datapalvelun käyttäminen

Claude Codessa nämä ovat valmiina; mukautetuissa agenteissa yhdistätte ne itse.

Miksi työkaluilla on merkitystä

Ilman työkaluja agentti voi vain arvata aiemmin oppimansa perusteella. Se saattaa sanoa, että "uusin versio on 3.2", vaikka todellisuudessa se on 5.0.

Verkkohakutyökalun avulla agentti voi tarkistaa asian. Tiedostotyökalun avulla se näkee oikean koodinne sen sijaan, että kuvittelisi sen. Työkalut korvaavat arvailun tiedolla — juuri siitä on kyse.

Miten työkalukutsu toimii

Kun agentti käyttää työkalua, se ei suorita työkalua itse — se pyytää sitä. Agentti sanoo "kutsu getWeather-funktiota Pariisille", järjestelmänne suorittaa funktion ja palauttaa vastauksen agentille.

Tässä sama tiedonsiirto on esitetty tavallisena JavaScriptinä, jotta näette, miltä työkalu näyttää:

// A simple "tool" the agent can ask to use
function getWeather(city) {
  const fake = { Paris: "18 C, sunny", Tokyo: "24 C, rain" };
  return fake[city] || "unknown";
}

// Agent decides to call it; your code runs it; result goes back
const toolResult = getWeather("Paris");
console.log("Tool returned:", toolResult);

Työkalun kuvaaminen tekoälylle

Jotta agentti voi käyttää työkalua, kuvaatte sen selkokielisesti: sen nimen, mitä se tekee ja mitä syötteitä se tarvitsee. Tekoäly lukee kuvauksen ja päättää, milloin työkalua kutsutaan.

Aloittelijan työkaluille tätä tarvitsee harvoin kirjoittaa itse — Claude Code ja v0 hoitavat sen — mutta rakenteen tunteminen auttaa ymmärtämään, mistä vaihtoehdoista agentti valitsee.

A tool description the AI sees (plain language):

name: getWeather
description: Get the current weather for a city.
input: city (string) — the city name, e.g. "Paris"

Given that, the agent knows: "To answer a weather question,
I should call getWeather with the city."

Useimmin käyttämänne sisäänrakennetut työkalut

Vibe coderina tukeudutte muutamaan agentin jo valmiiksi käytettävissä olevaan sisäänrakennettuun työkaluun:

  • Tiedoston lukeminen — jotta agentti ymmärtää projektinne
  • Tiedoston muokkaaminen — jotta se voi rakentaa ominaisuuksia
  • Komennon suorittaminen — jotta se voi testata ja käynnistää asioita
  • Verkkohaku — jotta sen tiedot pysyvät ajan tasalla

Useimmiten vain sallitte nämä, kun agentti pyytää sitä. Kun tiedätte, mitä kukin työkalu tekee, osaatte hyväksyä käytön harkiten.

Agentin pyytäminen käyttämään työkalua

Työkalua ei tarvitse nimetä — kuvatkaa lopputulos, ja agentti valitsee sopivan työkalun. Voitte kuitenkin ohjata sitä tarvittaessa.

Huomatkaa, miten tämä kehote vihjaa käytettävistä työkaluista ilman mikrotason ohjausta:

Prompt that guides tool use (Claude Code):

"Search the web for the current version of React, then update
the version number in my package.json and README. Read both
files first so you don't break anything, and show me the diff
before saving."

MCP: yleiskäyttöinen työkaluliitäntä

Saatatte kuulla MCP:stä (Model Context Protocol). Se on standardoitu tapa liittää agenttiin lisätyökaluja — esimerkiksi yhteys tietokantaan, suunnittelutiedostoihin tai GitHubin kaltaiseen palveluun.

Aloittelijana teidän ei tarvitse rakentaa MCP-palvelimia. Riittää, että tiedätte sen olevan "USB-portti", jonka avulla agentit voivat käyttää uusia työkaluja sisäänrakennettujen työkalujen lisäksi.

APIn yhdistäminen työkaluksi

Yksi hyödyllisimmistä työkaluista on web API — palvelu, josta sovelluksenne hakee dataa, kuten säätietoja, valuuttakursseja tai karttoja. Agentti voi sekä kirjoittaa sitä kutsuvan koodin että käyttää APIa rakentamisen aikana.

Tässä on todellinen fetch-kutsu, jonka agentti voisi tuottaa APIn kutsumista ja tuloksen käyttämistä varten:

// Calling an API tool with fetch
async function getRate() {
  const res = await fetch("https://api.frankfurter.app/latest?to=EUR");
  const data = await res.json();
  console.log("1 USD =", data.rates.EUR, "EUR");
}
getRate();

Enemmän työkaluja ei aina ole parempi

Jokainen agentille annettu työkalu on sekä voima että riski. Tiedostojen poistotyökalu voi siivota — tai pyyhkiä työnne. Shell-työkalu voi asentaa paketteja — tai suorittaa jotakin haitallista.

Hyvä sääntö: antakaa käyttöön mahdollisimman vähän työkaluja, joita tehtävä edellyttää. Aloittakaa rajoitetusti ja lisätkää työkaluja vain, kun tehtävä selvästi tarvitsee niitä. Turvallisuusoppitunnilla käsitellään tätä perusteellisemmin.

Te varustatte, agentti toimii

Kun kokoatte asiat yhteen: päätätte, mitä työkaluja agentti voi käyttää, kuvaatte kunkin toiminnan ja hyväksytte niiden käytön. Agentti valitsee sitten oikean työkalun oikealla hetkellä tavoitteeseenne pääsemiseksi.

Työkaluja käyttämätön agentti on vain chatbot. Oikeilla työkaluilla varustettu agentti on rakentaja. Varustakaa se harkiten, niin siitä tulee aidosti hyödyllinen.

Pikatarkistus

Varmistetaan, mitä työkalu agentille oikeastaan tarkoittaa.

Kertaus: agentin kädet

Opitte, miten agentit käyttävät todellista maailmaa:

  • Työkalut ovat toimintoja: verkkohaku, tiedostojen luku/kirjoitus, komennon suorittaminen ja APIn kutsuminen.
  • Agentti pyytää työkalua; järjestelmänne suorittaa sen ja palauttaa tuloksen.
  • Jokainen työkalu kuvataan sen nimellä, tarkoituksella ja syötteillä.
  • MCP on standardoitu liitäntä uusien työkalujen lisäämiseen.
  • Antakaa käyttöön mahdollisimman vähän työkaluja — teho merkitsee myös riskiä.

Seuraavaksi yhdistätte työkaluja ja vaiheita monivaiheiseksi automaatioksi.

Aloita maksutta

Opi JavaScript 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
25
Oppitunnit
100

Usein kysytyt kysymykset

Onko oppitunti ”Työkalujen antaminen agentille” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Vibe-koodaus-oppimispolun 3 oppituntia, myös oppitunnin “Työkalujen antaminen agentille”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Vibe-koodaus-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Työkalujen antaminen agentille”?

Antakaa tekoälyn käyttää verkkoa, tiedostoja ja koodia. Harjoittelet Vibe-koodaus-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni Vibe-koodaus-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin Vibe-koodaus-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 2/4.

Kuinka kauan ”Työkalujen antaminen agentille”-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ä Vibe-koodaus-oppitunnilla?

Kyllä. Jokainen Vibe-koodaus-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

  1. Avustajasta agentiksi
  2. Työkalujen antaminen agentille
  3. Monivaiheisten tehtävien automatisointi
  4. Agenttien pitäminen turvassa
← Takaisin: Vibe-koodaus