REST API:n muuntaminen työkaluiksi
Muuntakaa ulkoiset päätepisteet kutsuttaviksi työkaluiksi.
REST API:n muuntaminen työkaluiksi on ilmainen MCP Academy-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 MCP Academy-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. MCP Academy-kurssilla on yhteensä 4 oppituntia.
Muunna päätepisteet työkaluiksi
Jokaisesta REST API:sta voi tehdä MCP-työkaluja. Jokaisesta päätepisteestä tulee kutsuttava funktio, jota malli voi käyttää datan hakemiseen tai lähettämiseen. 🌐
Kutsu HTTP:tä työkalusta
Työkalun sisällä teet tavallisen HTTP-pyynnön ja palautat vastauksen tekstinä, jota malli voi lukea ja jonka perusteella se voi päätellä.
Suosi asynkronista asiakasta
Käytä asynkronista asiakasta, kuten httpx:ää, jotta hidas API-kutsu ei estä muita pyyntöjä odottaessaan verkkoa.
import httpx
async with httpx.AsyncClient() as client:
r = await client.get(url)Yhdistä parametrit argumenteiksi
Tarjoa päätepisteen kyselyparametrit työkalun argumentteina. Malli välittää kaupungin tai tunnisteen, jonka sijoitat pyyntöön turvallisesti.
@mcp.tool()
async def get_weather(city: str) -> str:
...Pidä salaisuudet palvelimella
Säilytä API-avain palvelimen ympäristössä, älä työkalun argumenttina. Mallin ei pitäisi koskaan nähdä tai lähettää tunnistetietoja.
key = os.environ["WEATHER_API_KEY"]Tarkista tilakoodi
Tarkista HTTP-status ennen kuin luotat runkoon. 404- tai 500-virhe tarkoittaa, että sinun on ilmoitettava selkeästä virheestä, ei palautettava merkityksetöntä dataa.
r.raise_for_status()Jäsennä ja karsi JSON
Useimmat API:t palauttavat JSON-muotoa. Jäsennä se ja palauta vain tehtävän tarvitsemat kentät, jotta malli ei huku ylimääräiseen tietoon.
data = r.json()
return data["temp_c"]Anna jokaiselle työkalulle yksi tehtävä
Yhdistä yksi päätepiste yhteen selkeästi nimettyyn, rajattuun työkaluun. Rakeiset työkalut on mallin helpompi valita oikein.
Kirjoita hyödylliset kuvaukset
Kuvaa, mitä päätepiste tekee ja milloin sitä käytetään. Täsmällinen description kertoo mallille, milloin tätä työkalua kannattaa kutsua.
Käsittele verkkovirheet
Ympäröi kutsu käsittelyllä, jotta aikakatkaisu tai yhteyden katkeaminen palauttaa luettavan error-viestin koko palvelimen kaatumisen sijaan.
Aseta järkevät aikakatkaisut
Välitä aina timeout-arvo, jotta jumittunut taustapalvelu ei voi jäädyttää työkalua odottamaan ikuisesti vastausta, jota ei koskaan tule.
r = await client.get(url, timeout=10.0)Pikatarkistus
Missä API-avain pitäisi säilyttää?
Kertaus: REST työkaluina
Olette kääरीनyt päätepisteet async-työkaluiksi: argumentit sisään, palvelimen avaimet, tilan tarkistukset ja siistitty JSON ulos. Seuraavaksi otetaan yhteydet pooliin. 🎯
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 ”REST API:n muuntaminen työkaluiksi” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa MCP Academy-oppimispolun 3 oppituntia, myös oppitunnin “REST API:n muuntaminen työkaluiksi”. 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 ”REST API:n muuntaminen työkaluiksi”?
Muuntakaa ulkoiset päätepisteet kutsuttaviksi työkaluiksi. 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 2/4.
Kuinka kauan ”REST API:n muuntaminen työkaluiksi”-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
- SQL-kyselyiden turvallinen tarjoaminen
- REST API:n muuntaminen työkaluiksi
- Yhteyksien poolaus Lifespanissa
- Ylävirran välimuisti ja nopeusrajoitukset