Paslaptys ir aplinkos kintamieji be raktų įklijavimo į pokalbį

Daugumai tikrų programėlių reikia bent vienos paslapties: mokėjimo paslaugos rakto, el. pašto paslaugos rakto ar rakto AI API. Mythex’e šių raktų neįklijuojate į užklausą. Kai agentui jo reikia, pokalbyje rodoma paslapties užklausos kortelė, jūs įrašote reikšmę į kortelę, ir ji išsaugoma kaip projekto paslaptis, kurią jūsų programėlė gali nuskaityti, – be to, kad raktas patektų į pokalbį.

Ką tai daro

Kiekvienas Mythex projektas gali saugoti aplinkos kintamuosius: pavadintas reikšmes, pavyzdžiui STRIPE_SECRET_KEY, kurias jūsų programėlė nuskaito paleidimo metu, o ne įrašytas į kodą. Paslaptys – tai aplinkos kintamieji, kurių reikšmės turi likti privačios.

Tos pačios reikšmės pasiekiamos dviejose vietose:

• Smėlio dėžėje, kur agentas kuria ir paleidžia jūsų programėlę, kol dirbate.
• Jūsų publikuotuose diegimuose, kuriais naudojasi lankytojai.

Jas galima pridėti trimis būdais:

1. Paslapties užklausos kortele, kurią agentas parodo pokalbyje, kai jam reikia rakto baigti kokį nors darbą.
2. Projekto nustatymai → Paslaptys, kur bet kada galite pridėti ar redaguoti reikšmes.
3. /secrets pokalbyje, kad pridėtumėte arba atnaujintumėte paslaptis pagal prašymą.

Kodėl tai padeda

Akivaizdus būdas agentui duoti raktą – įklijuoti jį į savo žinutę. Tai veikia, bet tada raktas tampa jūsų pokalbio istorijos dalimi ir guli grynu tekstu šalia visko, ką esate parašę.

Paslapties kortelė saugo reikšmę nuo pokalbio įrašų. Reikšmę įrašote į kortelės laukus, o ne į žinučių lauką, ir ji išsaugoma kaip projekto paslaptis. Agentas tęsia darbą, o raktas smėlio dėžėje jau pasiekiamas.

Raktų laikymas projekto nustatymuose, o ne kode, turi ir kitų privalumų:

• Raktai lieka už versijų valdymo ribų. Jūsų kodas nurodo raktą pagal vardą; reikšmė laikoma projekto nustatymuose.
• Agentas ir jūsų veikianti programėlė mato tą pačią konfigūraciją. Nėra kopijos, kuri pasensta.
• Raktą galite pakeisti nerašydami kodo iš naujo. Pakeiskite reikšmę nustatymuose; kodas vis tiek nuskaito ją pagal vardą.

Jei aplinkos kintamieji jums nauji, mūsų vadove kas yra aplinkos kintamieji ir paslaptys paaiškinama nuo pradžių.

Kaip naudoti paslapties kortelę

1. Paprašykite funkcijos – pavyzdžiui, „išsiųsk sveikinimo laišką, kai kas nors prisiregistruoja“.
2. Kai agentui prireiks rakto, pokalbyje atsiras paslapties užklausos kortelė su reikalinga reikšme.
3. Įrašykite reikšmę į kortelės laukus, o ne į žinučių lauką.
4. Patvirtinkite. Reikšmė išsaugoma kaip projekto paslaptis.
5. Agentas tęsia darbą, o raktas smėlio dėžėje jau pasiekiamas.

Kaip pridėti paslaptis pačiam

1. Atidarykite projekto nustatymus, tada Paslaptys.
2. Pridėkite raktus, pavyzdžiui STRIPE_SECRET_KEY, OPENAI_API_KEY arba savo paslaugos prisijungimo duomenis.
3. Paprašykite agento nuskaityti juos standartiniu jūsų sistemos būdu – pavyzdžiui, iš process.env Node programėlėje.
4. Publikuokite iš naujo, jei publikuota programėlė turi naudoti naujas reikšmes.

Pokalbyje taip pat galite įrašyti /secrets, kad pridėtumėte arba atnaujintumėte paslaptis.

Paslapties keitimas publikuotoje programėlėje

Publikuota programėlė paslaptis perima publikavimo metu. Kai pridedate ar pakeičiate paslaptį, publikuokite dar kartą, kad veikianti versija gautų naują reikšmę. Iki tol lankytojai naudojasi programėle su senais nustatymais.

Saugumo patarimai

• Niekada neįkelkite paslapčių į saugyklą. Laikykite jas projekto nustatymuose.
• Privilegijuotoms operacijoms naudokite tik serveriui skirtus raktus. Raktas, galintis nurašyti kortelės mokesčius ar siųsti el. laiškus, turi būti kode, veikiančiame serveryje, o ne ten, ką lankytojo naršyklė parsisiunčia.
• Jei raktas kada nors pateko į pokalbio istoriją, jį pakeiskite. Sukurkite naują raktą paslaugos teikėjo puslapyje, panaikinkite senąjį ir atnaujinkite reikšmę projekto nustatymuose. Bet koks į pokalbį įklijuotas raktas laikomas atskleistu.

Apribojimai

• Kortele pasinaudoti verta tik tada, kai ja naudojatės. Jei vis tiek įklijuosite raktą į žinučių lauką, jis atsidurs pokalbio įrašuose. Pakeiskite jį paslaugos teikėjo puslapyje ir atnaujinkite išsaugotą reikšmę.
• Publikuotoms programėlėms reikia publikuoti iš naujo, kad jos gautų naujas ar pakeistas paslaptis.
• Raktas saugiai laikomas dar nereiškia, kad kiekvienas jo naudojimas saugus. Svarbu, kur raktas naudojamas – privilegijuotus raktus laikykite savo programėlės serverio pusėje.

Daugiau apie saugų programėlės paruošimą prieš dalijimąsi rasite mūsų saugumo kontroliniame sąraše AI sukurtoms programėlėms.

Dokumentacijoje rasite išsamią informaciją: Aplinkos kintamieji ir paslaptys ir Paslaptys pokalbyje.