Hvað er SDK? Hugbúnaðarþróunarsett útskýrð einfaldlega

SDK (software development kit) er tilbúið verkfærasett sem fyrirtæki lætur forriturum í té svo þeir geti notað þjónustu sína eða vettvang án þess að smíða allt frá grunni. Það inniheldur yfirleitt forritasafn fyrir ákveðið forritunarmál, skjöl og dæmi, og stundum aukatól eins og prófunarverkfæri. Þegar forritið þitt „notar Stripe SDK“ þýðir það að kóðinn þinn kallar á tilbúnar aðgerðir Stripe í stað þess að skrifa hverja beiðni til API-sins þeirra með höndunum.

Af hverju SDK skipta máli þegar þú byggir með gervigreind

Þegar þú biður gervigreindarsmið um að bæta við greiðslum, gervigreindarspjalli, kortum eða tölvupósti setur hann yfirleitt upp SDK frá þeim þjónustuveitanda og skrifar nokkrar línur sem kalla á það. Ef þú skilur hvað SDK er hjálpar það þér að:

• Skilja hvað er bætt við verkefnið þitt. SDK er háð (dependency), utanaðkomandi kóði sem forritið þitt byggir nú á.
• Sjá hvaða uppsetningu það þarfnast. Næstum öll SDK þurfa API-lykil, og mörg eru til í útgáfum fyrir þjón og vafra með mismunandi reglum um hvaða lyklar eru öruggir í notkun.
• Biðja um rétta hlutinn. „Notaðu opinbera Stripe SDK-ið á þjóninum“ er skýrari fyrirmæli en „bættu við Stripe“.
• Lesa villuboð. Margar villur í forritum sem gervigreind hefur smíðað stafa af því að SDK er rangt stillt, úrelt eða notað á röngum stað.

Dæmisaga úr daglegu lífi

Ímyndaðu þér að þú ætlir að setja upp hillur.

• API eru reglur byggingarinnar: hvaða veggir þola skrúfur, hversu mikla þyngd þeir bera og hvar lagnirnar liggja. Þú gætir unnið eftir þeim reglum einum saman, mælt og borað allt sjálfur.
• SDK er hillusett frá sama fyrirtæki og smíðaði veggina: forsniðnir hlutar, réttu skrúfurnar, festing sem passar nákvæmlega í þeirra veggi, og leiðbeiningabæklingur.

Þú ákveður enn hvar hillan fer og hvað fer á hana. Settið sparar þér þó að saga timbrið og giska á skrúfustærðir, og það er minni líkur á að þú endir með gat á vatnslögn.

SDK vs API vs safn vs rammi

Þessi hugtök skarast, sem ruglar marga:

SDK inniheldur yfirleitt safn, og það safn kallar yfirleitt á API. Fyrir vefþjónustur eru „SDK“ og „viðskiptavinasafn“ (client library) oft notuð jafnt.

Sum SDK tengjast alls ekki vefþjónustum. Apple og Google gefa út SDK til að smíða iOS- og Android-öpp, sem innihalda þýðendur, hermi og kerfiskóða. Hugmyndin er sú sama: allt sem þarf til að smíða fyrir þeirra vettvang, í einu setti.

Hvað SDK gerir fyrir þig

Hér er sama verkefnið, að búa til viðskiptavin hjá greiðsluveitanda, gert á tvo vegu.

Án SDK þarf kóðinn þinn sjálfur að smíða HTTP-beiðnina: setja slóðina, bæta leyndarlyklinum í rétt haus, forsníða gögnin eins og API-ið býst við, senda, athuga stöðukóðann, þátta svarið og endurtaka beiðnina ef netið hikstar.

Með SDK er þetta nær einni línu:

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

Að baki þeirri línu sér SDK-ið um:

• Auðkenningu: festir lykilinn þinn rétt við hverja beiðni
• Gagnasnið: breytir gögnunum þínum í það sem API-ið býst við og svarinu aftur í hluti
• Villur: breytir stöðukóðum í skýrar villutegundir sem kóðinn þinn getur gripið
• Endurtilraunir: reynir aftur á öruggan hátt þegar beiðni mistekst af tímabundnum ástæðum (margar opinberar SDK gera þetta)
• Týpur: í TypeScript segir ritillinn þér hvaða reitir eru til, svo villur sjást áður en kóðinn er keyrður

Vinnudæmi: gervigreindarsvör í þjónustuforriti

Þú biður gervigreindarsmið: „Þegar viðskiptavinur sendir inn þjónustubeiðni, búðu til tillögu að svari með gervigreindarlíkani.“

1. Gervigreindin setur upp opinbert SDK líkanveitunnar sem pakka í verkefnið (í JavaScript-verkefnum úr npm-skránni).
2. Þú bætir API-lyklinum við sem leyndarmál verkefnisins. SDK-ið les hann úr umhverfisbreytu á þjóninum.
3. Gervigreindin skrifar þjónsleið sem kallar á SDK-ið með texta beiðninnar og stuttri leiðbeiningu, og vistar tillöguna í gagnagrunninn.
4. Vafrinn sér aldrei lykilinn; hann kallar bara á þína eigin þjónsleið.

Ef veitandinn breytir API-inu síðar gefur hann yfirleitt út nýja útgáfu af SDK-inu. Að uppfæra pakkann, og lesa útgáfuskýrslurnar til að athuga hvort brotnar breytingar séu í henni, er oft allt sem þarf.

Lykilhugtök

Algengar misskilningar

• „SDK og API er sama fyrirbærið.“ API er viðmót þjónustunnar; SDK er þægindalag ofan á því. Þú getur kallað á flest vefþjónusta API án SDK, það er bara meiri vinna.
• „Ef SDK er uppsett er samþættingin búin.“ Þú þarft enn reikning hjá þjónustuveitandanum, réttu lyklana og kóða sem meðhöndlar það sem gerist þegar hlutirnir klikka.
• „Hvaða pakki sem er með réttu nafni er sá opinberi.“ Árásaraðilar birta stundum eftirlíkingar. Athugaðu skjölin hjá þjónustuveitandanum fyrir nákvæmt heiti pakkans.
• „SDK í vafra getur notað leyndarlykilinn minn.“ Aldrei. Allt í kóða vafrans er sýnilegt gestum. Leyndarlyklar eiga heima í kóða á þjóninum eingöngu. Sjá hvernig þú heldur API-lyklum öruggum.
• „SDK þarf aldrei að uppfæra.“ Gamlar útgáfur hætta að fá lagfæringar og hætta að virka þegar veitendur leggja niður eldri API-útgáfur.

Hvað á að spyrja gervigreindarsmiðinn þinn

• „Notaðu opinbera SDK veitandans, ekki þriðja aðila umbúðir. Segðu mér nákvæmt heiti pakkans og útgáfuna sem þú settir upp.“
• „Notaðu SDK-ið aðeins á þjóninum og lestu lykilinn úr umhverfisbreytu.“
• „Hvaða hlutar þessa SDK keyra í vafranum, og hvaða lykla nota þeir?“
• „Hvað gerist ef kall á SDK mistekst eða rennur út á tíma? Sýndu notandanum skýr skilaboð og skráðu villuna.“
• „Listaðu öll SDK og pakka sem þetta forrit reiðir sig á og til hvers hvert þeirra er.“
• „Athugaðu hvort einhver SDK okkar séu úrelt eða hafi þekkt öryggisvandamál.“

SDK í Mythex

Mythex-fulltrúinn getur sett upp pakka í verkefnisumhverfinu þínu með venjulega pakkastjóranum fyrir stafla þinn, þar á meðal SDK veitenda. Nefndu pakkann og eiginleikann sem þú vilt nota hann í. Sjá Notkun npm-pakka. Mythex geymir ekki safn tilbúinna samþættinga fyrir appið þitt: þú vistar lykil veitandans sem leyndarmál verkefnisins og biður fulltrúann um að kalla á þjónustuna þeim megin sem þjónn er, eins og lýst er í Samþætta hvaða API sem er.

Fyrir lagið undir SDK-um, lestu hvað er API. Fyrir tvo algenga eiginleika sem byggja á SDK, sjá hvernig þú bætir greiðslum við appið og hvernig þú notar LLM API.

Spurningar