Työkalujen kutsuminen koodista
Kutsukaa palvelimen työkalua ja lukekaa sen tulos.
Työkalujen kutsuminen koodista on ilmainen MCP Academy-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 MCP Academy-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. MCP Academy-kurssilla on yhteensä 4 oppituntia.
Luettelosta toimintaan
Selvittäminen kertoi, mitä on saatavilla. Nyt kutsut työkalua oikeasti eli suoritat sen, lähetät argumentit ja luet tuloksen omasta koodistasi.
Kutsu nimen perusteella
Käytä session.call_tool()-kutsua työkalun nimen ja argumenttisanakirjan kanssa. Nimien on vastattava selvittämääsi inputSchema-määritystä.
result = await session.call_tool(
"add",
{"a": 2, "b": 3},
)Argumenttien on läpäistävä validointi
arguments-sanakirjan on vastattava työkalun inputSchema-määritystä. Väärän rakenteen lähettäminen saa palvelimen hylkäämään kutsun.
await session.call_tool("greet", {"name": "Ada"})Lue sisältö
Tulos sisältää lohkoista koostuvan content-luettelon. Useimmat työkalut palauttavat tekstiä, joten luet tekstin ensimmäisestä lohkosta.
print(result.content[0].text)Tarkista virheet
Virheen kohdannut työkalu asettaa tuloksen isError-arvoksi true-arvon poikkeuksen nostamisen sijaan. Tarkista arvo, jotta asiakkaasi voi reagoida hallitusti.
if result.isError:
print("tool failed")Myös rakenteinen tuloste
Uudemmat työkalut voivat palauttaa myös structuredContent-kentän eli tyypitetyn olion tekstin rinnalla, kun palvelin määrittää tulosskeeman.
print(result.structuredContent)Välitä oikeat argumentit
Argumentit voivat tulla ohjelmastasi, käyttäjältä tai mallilta. Asiakas välittää ne sellaisenaan tavallisena dict-oliona nimetylle työkalulle.
args = {"city": "Paris"}
await session.call_tool("weather", args)Se on edelleen asynkronista
Kuten kaikkia verkkokutsuja, myös call_tool-kutsua odotetaan awaitilla. Suoritus keskeytyy, kunnes palvelin on saanut työnsä valmiiksi ja tulos palautuu.
Yksi kutsu, yksi tulos
Jokainen suoritus on pyyntö–vastauspari. Istunto yhdistää vastauksen pyyntöön tunnisteen perusteella, joten tulokset eivät sekoitu keskenään.
Käsittele hitaat työkalut
Jotkin työkalut tarvitsevat aikaa. Vankka asiakas asettaa timeout-ajan, jotta jumiutunut työkalu ei pysäytä koko ohjelmaa.
Sinä ohjaat kokonaisuutta
Kun kutsut työkaluja koodista, ohjelmasi päättää järjestyksen, yhdistää tulokset ja muuntaa raakatuotoksen käyttäjälle hyödylliseen muotoon.
Pikatarkistus
Miten suoritat selvitetyn työkalun asiakkaan koodista?
Kertaus: kutsun tekeminen
Suoritit työkalut alusta loppuun: kutsu niitä nimellä kelvollisilla argumenteilla, lue sisältölohkot ja tarkista isError ennen kuin luotat tulokseen.
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
- 30
- Oppitunnit
- 120
Usein kysytyt kysymykset
Onko oppitunti ”Työkalujen kutsuminen koodista” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa MCP Academy-oppimispolun 3 oppituntia, myös oppitunnin “Työkalujen kutsuminen koodista”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. MCP Academy-kurssilla on yhteensä 4 oppituntia.
Mitä opin oppitunnilla ”Työkalujen kutsuminen koodista”?
Kutsukaa palvelimen työkalua ja lukekaa sen tulos. Harjoittelet MCP Academy-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.
Tarvitsenko kokemusta aloittaakseni MCP Academy-opiskelun?
Aiempi kokemus ei ole tarpeen. CoddyKitin MCP Academy-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 3/4.
Kuinka kauan ”Työkalujen kutsuminen koodista”-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ä MCP Academy-oppitunnilla?
Kyllä. Jokainen MCP Academy-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
- Asiakasistunnon avaaminen
- Työkalujen ja resurssien etsiminen
- Työkalujen kutsuminen koodista
- Työkalukutsujen reitittäminen LLM:n kautta