Sekretet dhe variablat e mjedisit pa ngjitur çelësa në bisedë

Shumica e aplikacioneve reale kanë nevojë për të paktën një sekret: çelësin e një ofruesi pagesash, çelësin e një shërbimi email-i, ose një çelës për një API AI. Në Mythex nuk i ngjitni këto në një kërkesë. Kur agjenti ka nevojë për një sekret, shfaq në bisedë një kartë kërkesë sekreti, ju e shkruani vlerën brenda kartës dhe ajo ruhet si sekret i projektit, që aplikacioni juaj ta lexojë — pa që çelësi të përfundojë në bisedë.

Çfarë bën

Çdo projekt Mythex mund të ruajë variabla mjedisi: vlera me emër, si STRIPE_SECRET_KEY, që aplikacioni juaj i lexon kur ekzekutohet, në vend që të jenë të shkruara në kod. Sekretet janë variabla mjedisi, vlerat e të cilave duhet të mbeten private.

Të njëjtat vlera janë të disponueshme në dy vende:

• Sandbox-i, ku agjenti ndërton dhe ekzekuton aplikacionin tuaj ndërsa punoni.
• Publikimet tuaja, ku vizitorët përdorin aplikacionin.

Ka tri mënyra për t’i shtuar:

1. Kartën e kërkesës për sekret, që agjenti e shfaq në bisedë kur i duhet një çelës për të përfunduar diçka.
2. Project settings → Secrets, ku mund të shtoni ose ndryshoni vlera në çdo kohë.
3. /secrets në bisedë, për të shtuar ose përditësuar sekrete sipas kërkesës.

Pse ndihmon

Mënyra e dukshme për t’i dhënë një agjenti AI një çelës është ta ngjitni në mesazhin tuaj. Funksionon, por atëherë çelësi bëhet pjesë e historikut të bisedës, i shkruar me tekst të qartë pranë gjithçkaje tjetër që keni thënë.

Karta e sekretit e mban vlerën jashtë transkriptit. E futni në fushat e kartës, jo në kutinë e mesazhit, dhe ajo ruhet si sekret i projektit. Agjenti vazhdon me çelësin të disponueshëm në sandbox.

Mbajtja e çelësave në cilësimet e projektit, e jo në kod, ka edhe përfitime të tjera:

• Çelësat qëndrojnë jashtë kontrollit të versioneve. Kodi juaj i referohet një çelësi me emër; vlera qëndron në cilësimet e projektit.
• Agjenti dhe aplikacioni juaj që po ekzekutohet shohin të njëjtën konfigurim. Nuk ka kopje që mund të vjetërohet.
• Mund ta rrotulloni një çelës pa rishkruar kodin. Ndryshoni vlerën te cilësimet; kodi e lexon ende sipas emrit.

Nëse variablat e mjedisit janë të reja për ju, udhëzuesi ynë për çfarë janë variablat e mjedisit dhe sekretet e shpjegon idenë nga e para.

Si ta përdorni kartën e sekretit

1. Kërkoni veçorinë — për shembull, "dërgo një email mirëseardhjeje kur regjistrohet dikush".
2. Kur agjenti ka nevojë për një çelës, shfaqet në bisedë një kartë kërkese sekreti që liston vlerën e nevojshme.
3. Futni vlerën në fushat e kartës, jo në kutinë e mesazhit.
4. Konfirmoni. Vlera ruhet si sekret i projektit.
5. Agjenti vazhdon, me çelësin të disponueshëm në sandbox.

Si t’i shtoni vetë sekretet

1. Hapni project settings, pastaj Secrets.
2. Shtoni çelësa si STRIPE_SECRET_KEY, OPENAI_API_KEY, ose kredencialet e shërbimit tuaj.
3. Kërkoni që agjenti t’i lexojë në mënyrën standarde të kornizës suaj — për shembull nga process.env në një aplikacion Node.
4. Publikoni përsëri nëse një aplikacion i publikuar ka nevojë për vlerat e reja.

Mund të shkruani gjithashtu /secrets në bisedë për t’i shtuar ose përditësuar aty.

Ndryshimi i një sekreti në një aplikacion të publikuar

Një aplikacion i publikuar merr sekretet kur publikohet. Pasi shtoni ose ndryshoni një sekret, publikoni përsëri që publikimi live të marrë vlerën e re. Deri atëherë, vizitorët ende e përdorin aplikacionin me konfigurimin e vjetër.

Këshilla sigurie

• Mos i commit-oni kurrë sekretet në repository. Mbajini në project settings.
• Preferoni çelësa vetëm për server për operacionet e privilegjuara. Një çelës që mund të kryejë pagesa me kartë ose të dërgojë email duhet të jetë në kod që ekzekutohet në server, jo në diçka që shkarkon shfletuesi i vizitorit.
• Nëse një çelës ka qenë ndonjëherë në historikun e bisedës, rrotulloje. Krijoni një çelës të ri te ofruesi, revokoni të vjetrin dhe përditësoni vlerën në project settings. Konsideroni të ekspozuar çdo çelës që është ngjitur në një bisedë.

Kufizime

• Karta ndihmon vetëm nëse e përdorni. Nëse ngjitni një çelës në kutinë e mesazhit gjithsesi, ai është në transkript. Rrotulloje te ofruesi dhe përditëso vlerën e ruajtur.
• Aplikacionet e publikuara kanë nevojë për publikim të ri për të marrë sekrete të reja ose të ndryshuara.
• Ruajtja e sigurt e një çelësi nuk e bën çdo përdorim të tij të sigurt. Vendi ku përdoret çelësi ka rëndësi — mbajini çelësat e privilegjuar në anën e serverit të aplikacionit.

Për më shumë rreth mbrojtjes së një aplikacioni para se ta ndani, shihni listën e sigurisë për aplikacionet e ndërtuara me AI.

Dokumentacioni ka detajet: Variablat e mjedisit dhe sekretet dhe Sekretet në bisedë.