Šta je SDK? Softverski razvojni kompleti objašnjeni jednostavno

SDK (softverski razvojni komplet) je gotov alat koji kompanija daje programerima da bi koristili njen servis ili platformu bez pravljenja svega iz nule. Obično uključuje biblioteku koda za određeni programski jezik, dokumentaciju i primere, a ponekad i dodatne alate, poput alata za testiranje. Kada tvoja aplikacija „koristi Stripe SDK“, to znači da tvoj kod poziva Stripe-ove gotove funkcije umesto da svaki zahtev ka Stripe-ovom API-ju piše ručno.

Zašto su SDK-ovi važni kada praviš aplikaciju uz AI

Kada AI alatu zatražiš da doda plaćanja, AI chat, mape ili imejl, on će obično instalirati SDK tog provajdera i napisati nekoliko linija koje ga pozivaju. Znanje o tome šta je SDK pomaže ti da:

• Razumeš šta se dodaje u projekat. SDK je zavisnost, spoljašnji kod od kojeg tvoja aplikacija sada zavisi.
• Prepoznaš podešavanje koje mu treba. Skoro svaki SDK traži API ključ, a mnogi imaju zasebne „serverske“ i „browser“ verzije sa različitim pravilima o tome koji ključevi su bezbedni za upotrebu.
• Tražiš pravu stvar. „Koristi zvanični Stripe SDK na serveru“ je jasnija instrukcija od „dodaj Stripe“.
• Čitaš greške. Mnoge greške u aplikacijama pravljenim uz AI dolaze otuda što je SDK pogrešno podešen, zastareo ili korišćen na pogrešnom mestu.

Svakodnevna analogija

Zamisli da želiš da okačiš police.

• API su pravila zgrade: koji zidovi mogu da prime šrafove, koje opterećenje izdržavaju i gde su cevi. Mogao bi da radiš samo po tim pravilima, sam merio i bušio sve.
• SDK je komplet police u kutiji od iste kompanije koja je napravila zidove: unapred isečeni delovi, pravi šrafovi, nosač koji tačno odgovara njihovim zidovima i uputstvo.

I dalje odlučuješ gde ide polica i šta na nju ide. Komplet ti samo štedi rezanje drveta i nagađanje veličine šrafova, a manja je šansa da završiš s rupom u vodovodnoj cevi.

SDK naspram API-ja, biblioteke i frameworka

Ovi pojmovi se preklapaju, pa mnogima to stvara zabunu:

SDK obično sadrži biblioteku, a ta biblioteka obično poziva API. Kod web servisa, „SDK“ i „klijentska biblioteka“ često se koriste kao sinonimi.

Neki SDK-ovi uopšte nisu vezani za web servise. Apple i Google objavljuju SDK-ove za pravljenje iOS i Android aplikacija, koji uključuju kompajlere, simulatore i kod platforme. Ideja je ista: sve što ti treba za pravljenje za njihovu platformu, u jednom kompletu.

Šta SDK radi umesto tebe

Evo istog zadatka, kreiranja klijenta kod provajdera plaćanja, urađenog na dva načina.

Bez SDK-a tvoj kod mora sam da napravi HTTP zahtev: postavi URL, doda tajni ključ u pravo zaglavlje, formatira podatke kako API očekuje, pošalje ih, proveri statusni kod, obradi odgovor i ponovi zahtev ako mreža otkaže.

Sa SDK-om to je bliže jednoj liniji:

const customer = await stripe.customers.create({ email: "lena@example.com" });

Iza te linije SDK obavlja:

• Autentifikaciju: ispravno dodaje tvoj ključ uz svaki zahtev
• Formatiranje podataka: pretvara tvoje podatke u ono što API očekuje, a odgovor nazad u objekte
• Greške: pretvara statusne kodove u jasne tipove grešaka koje tvoj kod može da uhvati
• Ponovne pokušaje: bezbedno pokušava ponovo kada zahtev ne uspe iz privremenih razloga (mnogi zvanični SDK-ovi to rade)
• Tipove: u TypeScript-u govori tvom editoru koja polja postoje, pa se greške vide pre pokretanja koda

Praktičan primer: dodavanje AI odgovora u aplikaciju za podršku

Zatražiš od AI alata: „Kada korisnik pošalje zahtev za podršku, napravi predloženi odgovor pomoću AI modela.“

1. AI instalira zvanični SDK provajdera modela kao paket u projekat (u JavaScript projektima, iz npm registra).
2. Dodaješ API ključ provajdera kao tajnu projekta. SDK ga čita iz promenljive okruženja na serveru.
3. AI piše serversku rutu koja poziva SDK sa tekstom zahteva i kratkom instrukcijom, i čuva predloženi odgovor u bazi.
4. Pregledač nikada ne vidi ključ; on poziva samo tvoju sopstvenu serversku rutu.

Ako provajder kasnije promeni svoj API, obično izda novu verziju SDK-a. Ažuriranje paketa, uz proveru beleški o izdanju za promene koje lome kompatibilnost, često je sve što treba.

Ključni pojmovi

Česte zablude

• „SDK i API su ista stvar.“ API je interfejs servisa; SDK je sloj olakšice iznad njega. Većinu web API-ja možeš da pozivaš i bez SDK-a, samo je više posla.
• „Ako je SDK instaliran, integracija je gotova.“ I dalje ti trebaju nalog kod provajdera, pravi ključevi i kod koji rukuje onim što se dešava kada stvari ne uspeju.
• „Svaki paket s pravim imenom je zvanični.“ Napadači ponekad objavljuju pakete sa sličnim imenima. Proveri tačno ime paketa u dokumentaciji provajdera.
• „Browser SDK može da koristi moj tajni ključ.“ Nikada. Sve u browser kodu vide posetioci. Tajni ključevi pripadaju samo serverskom kodu. Pogledaj kako čuvati API ključeve.
• „SDK-ovi nikada ne moraju da se ažuriraju.“ Stare verzije prestaju da dobijaju popravke i na kraju prestanu da rade kada provajderi ukinu stare verzije API-ja.

Šta pitati svog AI alata

• „Koristi zvanični SDK provajdera, a ne wrapper treće strane. Reci mi tačno ime paketa i verziju koju si instalirao.“
• „Koristi SDK samo na serveru i čitaj ključ iz promenljive okruženja.“
• „Koji delovi ovog SDK-a rade u pregledaču i koje ključeve koriste?“
• „Šta se dešava ako poziv SDK-a ne uspe ili istekne? Prikaži korisniku jasnu poruku i zabeleži grešku.“
• „Navedi svaki SDK i paket od kojeg ova aplikacija zavisi i čemu svaki služi.“
• „Proveri da li su neki od naših SDK-ova zastareli ili imaju poznate bezbednosne probleme.“

SDK-ovi u Mythex-u

Mythex agent može da instalira pakete u tvoj projektni sandbox koristeći uobičajeni menadžer paketa za tvoj stack, uključujući SDK-ove provajdera. Navedi paket i funkciju za koju ga želiš. Pogledaj korišćenje npm paketa. Mythex ne isporučuje katalog gotovih integracija za tvoju aplikaciju: sačuvaš ključ provajdera kao tajnu projekta i zamoliš agenta da servis poziva sa serverske strane, kako je opisano u Integriši bilo koji API.

Za sloj ispod SDK-ova pročitaj šta je API. Za dve česte funkcije zasnovane na SDK-u pogledaj kako dodati plaćanja u aplikaciju i kako koristiti LLM API-je.

Pitanja