Çelësat API dhe variablat e mjedisit

Shumë aplikacione lidhen me shërbime të tjera: një ofrues pagese për të marrë pagesa me kartë, një shërbim email për të dërguar mesazhe, një hartë ose një shërbim AI. Këto shërbime të japin një çelës sekret. Variablat e mjedisit janë vendi i sigurt për të mbajtur çelësa të tillë në AI Studio. Çelësi ruhet i koduar në serverin e faqes sate, aplikacioni yt mund ta përdorë atë dhe nuk shfaqet kurrë në kodin tënd ose në bisedë.

Pse të përdorësh variablat e mjedisit

• E sigurt: vlerat ruhen si sekrete të koduara në serverin e faqes sate, jo në bazën tonë të të dhënave dhe jo në skedarët e projektit tënd.
• Privat: AI nuk i sheh kurrë vlerat. Di vetëm emrat.
• E lehtë për t'u ndryshuar: kur ndryshon një çelës, e përditëson atë në një vend. Ndryshimet arrijnë menjëherë në faqen tënde aktive. Nuk ke nevojë të publikosh përsëri.

E rëndësishme: Asnjëherë mos ngjit një çelës sekret në bisedë ose në një skedar kodi. Kushdo që mund të shohë kodin e faqes sate mund ta kopjojë atë. Përdor gjithmonë një variabël mjedisi.

Hap variablat e mjedisit

Mund ta hapësh dritaren Variablat e mjedisit në tre mënyra:

• Në panelin e majtë, hap Hapësira e punës dhe kliko Variablat e mjedisit (ikona e çelësit).
• Kliko ⋯ (Më shumë veprime) lart djathtas dhe zgjidh Variablat e mjedisit.
• Hap skedën Cilësimet, zgjidh Mjedisi dhe kliko Menaxho variablat.

Shto një variabël

1. Hap Variablat e mjedisit.
2. Kliko Shto variabël. Shfaqet një rresht i ri.
3. Në fushën e parë, shkruaj emrin, për shembull STRIPE_SECRET_KEY. Emrat përdorin vetëm shkronja të mëdha, numra dhe nënvizime. Karakteret e tjera hiqen ndërsa shkruan dhe shkronjat ndryshojnë në kapitale.
4. Në fushën e dytë, ngjit vlerën (çelësin tënd).
5. Shto më shumë variabla në të njëjtën mënyrë nëse ke nevojë për to.
6. Kliko Ruaj dhe sinkronizo.

Fundi i dritares tregon se sa variabla ka projekti.

Shembuj të zakonshëm

Mund të zgjedhësh çdo emër. Ajo që ka rëndësi është që të përdorësh të njëjtin emër kur flet me AI.

Thuaji AI të përdorë një variabël

Pasi të ruash, kërkoji AI-së në bisedë të përdorë variablin me emrin e tij, për shembull:

• "Ngarko kartat me STRIPE_SECRET_KEY."
• "Dërgo formularin e kontaktit në emailin tim duke përdorur EMAIL_API_KEY."

AI shkruan kodin që lexon çelësin në serverin e faqes sate kur aplikacioni funksionon. Kodi yt mbështetës e arrin atë si context.env.YOUR_KEY. Vetë vlera nuk shkon kurrë në skedarët e tu.

Këshillë: Shto variablin përpara se t'i kërkosh AI-së të ndërtojë veçorinë. Pastaj veçoria funksionon sapo të publikosh.

Lexo pikat e statusit

Çdo variabël në listë ka një pikë të vogël pranë saj:

• Pikë jeshile: variabli është aktiv në faqen tënde (Aktiv në sajtin tënd).
• Pikë e qelibartë: variabli nuk është ende në faqen tënde (Ende i pavendosur). Kliko Ruaj dhe sinkronizo për ta dërguar.

Ndrysho ose hiq një variabël

Vlerat maskohen me pika kur hap dritaren.

• Mbaj një vlerë: lëri pikat ashtu siç janë. Vlera e ruajtur nuk ndryshon.
• Ndrysho një vlerë: fshi pikat dhe ngjit vlerën e re.
• Hiq një variabël: kliko x në fund të rreshtit të saj.

Pastaj kliko Ruaj dhe sinkronizo. Nëse mbyll dritaren me Anulo, asgjë nuk ndryshon.

Zgjidhja e problemeve

"Variablat aktuale nuk mund të lexoheshin nga sajti yt." Lista nuk mund të ngarkohej nga serveri. Nëse klikon tani Ruaj dhe sinkronizo, lista në dritare zëvendëson të gjitha variablat në sajtin tënd. Mbyll dritaren dhe provo sërish më vonë nëse nuk je i sigurt se lista është e plotë.

Veçoria thotë se çelësi mungon. Kontrollo që emri në dritare të jetë saktësisht i njëjtë me emrin e përdorur nga AI, duke përfshirë shkronjat e mëdha. Kontrollo që pika të jetë e gjelbër.

Kam ngjitur gabimisht një çelës në bisedë. Krijo një çelës të ri në pultin e shërbimit tjetër, fshi të vjetrin atje dhe ruaje çelësin e ri si variabël mjedisi.