Tajomstvá a premenné prostredia bez vkladania kľúčov do chatu

Väčšina reálnych aplikácií potrebuje aspoň jedno tajomstvo: kľúč poskytovateľa platieb, kľúč e-mailovej služby, kľúč k AI API. Na Mythex ich nevkladáte do promptu. Keď ich agent potrebuje, zobrazí v chate kartu secrets request, vy hodnotu napíšete do karty a uloží sa ako tajomstvo projektu, ktoré vaša aplikácia môže čítať — bez toho, aby kľúč skončil v konverzácii.

Čo to robí

Každý projekt Mythex môže ukladať premenné prostredia: pomenované hodnoty, napríklad STRIPE_SECRET_KEY, ktoré vaša aplikácia číta pri spustení namiesto toho, aby boli zapísané v kóde. Tajomstvá sú premenné prostredia, ktorých hodnoty musia zostať súkromné.

Tie isté hodnoty sú dostupné na dvoch miestach:

• Sandbox, kde agent zostavuje a spúšťa vašu aplikáciu, kým pracujete.
• Vaše publikované nasadenia, ktoré používajú návštevníci.

Pridať ich môžete tromi spôsobmi:

1. Kartou žiadosti o tajomstvo, ktorú agent zobrazí v chate, keď potrebuje kľúč na dokončenie úlohy.
2. Nastavenia projektu → Secrets, kde môžete hodnoty kedykoľvek pridať alebo upraviť.
3. /secrets v chate, na pridanie alebo aktualizáciu tajomstiev na požiadanie.

Prečo to pomáha

Očividný spôsob, ako dať AI agentovi kľúč, je vložiť ho do správy. Funguje to, ale kľúč sa potom stane súčasťou histórie chatu a leží v čistom texte medzi všetkým ostatným, čo ste napísali.

Karta tajomstva drží hodnotu mimo prepisu. Zadáte ju do polí karty, nie do poľa správy, a uloží sa ako tajomstvo projektu. Agent pokračuje s kľúčom dostupným v sandboxe.

Držanie kľúčov v nastaveniach projektu namiesto v kóde má aj ďalšie výhody:

• Kľúče zostávajú mimo správy zdrojového kódu. Váš kód odkazuje na kľúč menom; hodnota je v nastaveniach projektu.
• Agent a vaša bežiaca aplikácia vidia rovnakú konfiguráciu. Žiadna kópia, ktorá by zastarala.
• Kľúč môžete vymeniť bez prepisovania kódu. Zmeňte hodnotu v nastaveniach; kód ju stále číta podľa mena.

Ak sú pre vás premenné prostredia nové, náš sprievodca čo sú premenné prostredia a tajomstvá vysvetľuje tento pojem od začiatku.

Ako používať kartu tajomstva

1. Požiadajte o funkciu — napríklad „pošli uvítací e-mail, keď sa niekto zaregistruje“.
2. Keď agent potrebuje kľúč, v chate sa objaví karta žiadosti o tajomstvo so zoznamom hodnoty, ktorú potrebuje.
3. Zadajte hodnotu do polí karty, nie do poľa správy.
4. Potvrďte. Hodnota sa uloží ako tajomstvo projektu.
5. Agent pokračuje s kľúčom dostupným v sandboxe.

Ako pridať tajomstvá sami

1. Otvorte nastavenia projektu a potom Secrets.
2. Pridajte kľúče ako STRIPE_SECRET_KEY, OPENAI_API_KEY alebo prihlasovacie údaje vlastnej služby.
3. Požiadajte agenta, aby ich čítal štandardným spôsobom pre váš framework — napríklad z process.env v Node aplikácii.
4. Publikujte znova, ak publikovaná aplikácia potrebuje nové hodnoty.

Do chatu môžete tiež napísať /secrets a pridať alebo aktualizovať tajomstvá tam.

Zmena tajomstva v publikovanej aplikácii

Publikovaná aplikácia prevezme tajomstvá pri publikovaní. Po pridaní alebo zmene jedného z nich publikujte znova, aby živé nasadenie dostalo novú hodnotu. Dovtedy návštevníci používajú aplikáciu so starou konfiguráciou.

Bezpečnostné tipy

• Nikdy necommitujte tajomstvá do repozitára. Držte ich v nastaveniach projektu.
• Pre privilegované operácie používajte kľúče určené len pre server. Kľúč, ktorý dokáže účtovať karty alebo posielať e-maily, patrí do kódu bežiaceho na serveri, nie do niečoho, čo si prehliadač návštevníka stiahne.
• Ak sa kľúč niekedy objaví v histórii chatu, vymeňte ho. Vytvorte nový kľúč u poskytovateľa, starý zrušte a aktualizujte hodnotu v nastaveniach projektu. Každý kľúč, ktorý bol vložený do chatu, považujte za vystavený.

Limity

• Karta pomáha, iba ak ju použijete. Ak kľúč napriek tomu vložíte do poľa správy, je v prepise. Vymeňte ho u poskytovateľa a aktualizujte uloženú hodnotu.
• Publikované aplikácie potrebujú nové publikovanie, aby prevzali nové alebo zmenené tajomstvá.
• Bezpečné uloženie kľúča neznamená, že každé jeho použitie je bezpečné. Záleží aj na tom, kde sa kľúč používa — privilegované kľúče držte na strane servera vašej aplikácie.

Pre viac o zabezpečení aplikácie pred zdieľaním pozrite náš bezpečnostný kontrolný zoznam pre aplikácie vytvorené AI.

Dokumentácia má podrobnosti: Premenné prostredia a tajomstvá a Tajomstvá v chate.